# task-212.1 완료 보고서

**작업**: InforKeyword Phase 1 — 기술 리서치 + 설계
**팀**: 개발2팀 (오딘 팀장)
**일시**: 2026-03-04
**상태**: 완료

---

## 작업 내용

InforKeyword 프로젝트(네이버 정보성 키워드 7단계 자동 판별 웹앱)의 기술 리서치와 아키텍처 설계를 수행했습니다.

### 리서치 항목 (7개)

1. **네이버 자동완성 API** — `mac.search.naver.com/mobile/ac` 비공식 API 검증 완료. 무료, 인증 불필요.
2. **네이버 검색광고 API** — `api.searchad.naver.com/keywordstool` 공식 API. HMAC-SHA256 인증. 무료 (계정 발급 필요).
3. **네이버 연관검색어** — HTML 크롤링으로 추출 가능. 자동완성 API로 대체 가능.
4. **블로그탭/카페탭 크롤링** — 모두 SSR. axios+cheerio로 파싱 가능. 광고 판별(`_fe_view_power_content`), 대표뱃지(`i.api_ico_total`) 선택자 확인.
5. **이미지 OCR** — Google Cloud Vision API 추천 (기존 GCP 프로젝트 활용, 월 1,000장 무료).
6. **LLM 연동** — Gemini 2.5 Flash 추천 (기존 API 키 활용). 키워드 생성 + 홍보성 판별.
7. **기술스택** — Next.js 15 + Python Worker + Firestore + Vercel + Cloud Run.

### 비용 분석
- 1회 분석(5키워드): ~₩63
- 월간 추정(일 5회): ~₩54,600

---

## 생성/수정 파일 목록

| 파일 | 설명 |
|------|------|
| `/home/jay/workspace/memory/research/inforkeyword-tech-research.md` | 기술 리서치 보고서 (전체) |
| `/home/jay/workspace/memory/specs/infor-keyword/architecture-v1.md` | 아키텍처 설계서 v1 |
| `/home/jay/workspace/memory/specs/infor-keyword/phase-plan.md` | Phase 2~4 상세 계획 |
| `/home/jay/workspace/memory/reports/task-212.1.md` | 본 보고서 |

---

## 테스트 결과

| 테스트 항목 | 결과 |
|------------|------|
| 네이버 자동완성 API 호출 | 성공 (HTTP 200, JSON 응답) |
| 네이버 검색광고 API 엔드포인트 | 성공 (인증 없이 400 → 구조 확인) |
| 블로그탭 HTML 크롤링 | 성공 (SSR, 597KB) |
| 카페탭 HTML 크롤링 | 성공 (구형 렌더러 대표뱃지 확인) |
| 블로그 본문 크롤링 (PostView.naver) | 성공 (274KB, 본문 추출 확인) |
| 연관검색어 추출 | 부분 성공 (URL-encoded JSON, 불안정) |

---

## 버그/이슈

- 연관검색어 HTML 파싱이 불안정 → 자동완성 API 대체 사용 권장
- 카페 본문 크롤링은 로그인 필요 → Puppeteer 필요 (Phase 2에서 대응)
- 네이버 검색광고 API 계정 미발급 → Phase 2 시작 전 발급 필요

---

## 선행 조건 (Phase 2 시작 전 필요)

1. 네이버 검색광고 계정 생성 + API Key/Secret/Customer ID 발급
2. GCP insuwiki-j2h에서 Cloud Vision API 활성화
3. 기술스택 + 아키텍처 최종 승인

---

## 비고

- 코딩 없이 리서치 + 설계만 수행 (Phase 1 지시 준수)
- 실현 가능성 검증을 위한 curl 테스트만 실행
- InsuWiki 기존 자산(Firebase, GCP, Gemini API키) 최대 활용 설계
- 전체 개발 기간 예상: Phase 2~4 합계 17~22일