---
task_id: task-2267
type: plan
scope: task
created: 2026-04-28
updated: 2026-04-28
status: completed
---

# 계획서: task-2267

**task**: task-2267
**목표**: 정보성 키워드 분석의 외부 워커(localhost:8100) 의존을 제거하��, 아누 서버(main.py) 내부에서 claude CLI + 네이버 SearchAd API로 직접 처리하도록 전환
**승인**: 아누 2026-04-28
**근거**: 외부 워커 미존재로 Connection refused 에러 발생

---

## 목표

1. `_run_keyword_analysis()` 함수를 외부 워커 호출 → 내부 claude CLI + 네이버 API 직접 처리로 전면 교체 ✅
2. `_get_naver_search_volume()` 헬퍼 함��� 추출 (기존 naver_proxy 로직 재��용) ✅
3. INFOKEYWORD_WORKER_URL, INFOKEYWORD_API_KEY 환경변수 참조 제거 ✅
4. 기존 프론트엔드(InfoKeyword.tsx) 호환 유지 (API 응답 형식 동일) ✅
5. 테스트 업데이트 ✅

## 범위

### 포함
- server/main.py: _run_keyword_analysis 전면 교체, _get_naver_search_volume 헬�� 추가, 외부 워커 참조 제거
- server/tests/test_infokeyword.py: 테스트 업데이트

### 제외
- 프론트엔드 수정 (API ��답 형식 유지로 불필요)
- 키워드 순위 TOP 20 배치 갱신 (별도 작업)

## 위임 계획

- MT-1 (백엔드 코드 수정): **불칸(백엔드)** — main.py 수정 ✅
- MT-2 (테스트 업데이트): **아르���스(테스터)** — 테스트 코드 갱신 ✅

## 검증 기준

- pytest: `pytest server/tests/test_infokeyword.py -v` → 7/7 PASSED ✅
- grep: `INFOKEYWORD_WORKER_URL` 참조 0건 ✅
- grep: `_get_naver_search_volume` 함수 존재 확인 ��
- grep: `subprocess.run` (claude CLI 호출) 확인 ✅
- 서버 시작: import 에러 없음 + /api/status 200 ✅
- npm run build: 성공 (12.06s) ✅