---
task_id: task-2101
type: plan
scope: task
created: 2026-04-22
updated: 2026-04-22
status: completed
---

# 계획서: task-2101

**task**: task-2101
**목표**: InsuRo 네이버 키워드 검색량 조회 오류 수정 (DataLab → SearchAd API 전환)
**승인**: 마르둑 2026-04-22 "Codex 사전 검증 기반 설계 확정"
**근거**: Codex gate check + 대시보드 동작 코드 참조

---

## 목표

키워드 입력 후 검색 시 네이버 SearchAd /keywordstool API에서 relKeyword, monthlyPcQcCnt, monthlyMobileQcCnt, compIdx 등 검색량 데이터를 정상 반환한다.

## 범위

### 포함
- 백엔드: main.py에 search_type="keyword" 분기 추가 (SearchAd API 호출)
- 프론트엔드: KeywordAnalysis.tsx에서 search_type을 "keyword"로 변경, 블로그 fallback 제거

### 제외 (다음 페이즈 이후)
- DataLab 트렌드 엔드포인트 제거 (기존 기능 유지)
- 보험 도메인 키워드 필터링 (대시보드에는 있지만 InsuRo에는 미적용)

## 위임 계획

- 백엔드 구현: **엔키(Sonnet)** — SearchAd API 호출 로직
- 프론트엔드 수정: **이쉬타르(Sonnet)** — 검색 타입 변경 + 에러 처리

## 검증 기준

- "실비보험" 검색: `curl POST /api/insuro/naver/search` → keywordList 754건 반환
- npm run build: 성공
- TypeScript: noEmit 오류 없음