---
task_id: task-2124
type: plan
scope: task
created: 2026-04-23
updated: 2026-04-23
status: completed
---

# 계획서: task-2124

**task**: task-2124
**목표**: 네이버 SearchAd API keyword 검색에서 공백 포함 키워드 에러 해결
**승인**: 아누 2026-04-23 "근본 원인 규명 완료, 수정 지시"
**근거**: task-2124.md 근본 원인 분석

---

## 목표

네이버 SearchAd API `/keywordstool`의 `hintKeywords` 파라미터가 공백을 허용하지 않는 문제를 해결하여, 단일/복합/쉼표구분 키워드 모두 정상 동작하도록 한다.

## 범위

### 포함
- `server/main.py` L814-848 keyword 분기: 공백/쉼표로 분할 → 개별 API 호출 → 결과 병합
- `re` import 추가
- 빈 문자열 입력 검증 강화
- 키워드 수 상한(10개) 추가

### 제외 (다음 페이즈 이후)
- datalab, blog search_type은 변경 없음
- 프론트엔드 변경 없음 (API 응답 구조 `{"keywordList": [...]}` 동일)

## 위임 계획

- 백엔드 코드 수정: **불칸(백엔드)** — main.py keyword 분기 수정
- 스모크테스트: **팀장(헤르메스)** — curl 기반 5개 시나리오

## 검증 기준

- 단일 키워드: `curl "실비보험"` → 200 OK, 754건 ✅
- 공백 키워드: `curl "실비보험 가격"` → 200 OK, 831건 ✅
- 쉼표 키워드: `curl "실비보험,암보험,치아보험"` → 200 OK, 2293건 ✅
- 빈 문자열: `curl "  "` → 400 에러 ✅