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

# 체크리스트: task-2101

**task**: task-2101

---

## Phase 1 — 백엔드 (엔키)

- [x] A. main.py에 SearchAd API import 추가 (base64, hmac, urllib.parse)
- [x] B. naver_proxy에 search_type: "keyword" 분기 추가
- [x] C. HMAC-SHA256 서명 생성 및 /keywordstool 호출 구현
- [x] D. NAVER_SEARCHAD_* 환경변수 검증 및 503 에러 처리

## Phase 2 — 프론트엔드 (이쉬타르)

- [x] A. handleSearch에서 search_type을 "keyword"로 변경
- [x] B. 블로그 fallback 로직 제거
- [x] C. 에러 메시지 개선 (서버 detail 표시)
- [x] D. 빈 키워드 validation 추가

## 검증

- [x] SearchAd API "실비보험" 검색 → 754개 키워드 반환 확인
- [x] npm run build 성공
- [x] TypeScript 빌드 오류 없음
- [x] QC 검증 완료
- [x] 최종 보고