per-headline 감성 분석 호출 방식 선택

상태

승인

후보군

방안	설명
claude -p 단일 배치 호출	전체 헤드라인을 URL+제목 JSON 배열로 구성해 1회 호출. 응답도 JSON 배열로 수신
헤드라인별 개별 claude -p 호출	헤드라인 1건마다 claude -p를 1회씩 호출
키워드 사전 기반 분류	사전에 정의된 키워드로 감성을 분류하는 규칙 기반 방식

결정

claude -p 단일 배치 호출로 전체 헤드라인의 감성·번역·요약을 한 번에 처리한다. 기존 analyze_headlines를 analyze_headlines_v2로 교체하고 SentimentResult 대신 HeadlineAnalysis를 반환한다.

결정 이유

• 헤드라인이 최대 20건이므로 건별 호출 시 최대 120초(20건 × 6초) 지연이 발생한다
• 기존 claude -p 패턴을 재사용할 수 있어 구현 비용이 낮다
• API 호출 횟수가 1회로 고정되어 비용 예측이 가능하다

검토 대안

방안	기각 이유
헤드라인별 개별 claude -p 호출	20배 느림, 비용 과다
키워드 사전 기반 분류	번역 불가, 정확도 낮음

트레이드 오프

• 득: API 호출 1회로 latency 최소화, 비용 절감
• 실: 프롬프트 길이가 길어져 토큰 비용 증가 가능성, JSON 파싱 실패 시 전체 배치 재시도 필요