한국 콘텐츠 블로거를 위한 화제성 탐지 + SEO 키워드 분석 + AI 기획안 자동 생성 파이프라인
AI-powered content planning & SEO keyword analyzer for Korean bloggers — from trend detection to publish-ready content plans.
"어떤 키워드로 어디에 써야 조회수가 터질까?" — AutoAuthor는 이 질문에 가장 정밀한 데이터로 답합니다.
단순한 '추측'이 아닙니다. 네이버 검색광고 API의 실제 월간 검색량과 YouTube Data API의 상위 영상 평균 조회수를 기반으로, 플랫폼별 **포화율(Saturation Rate)**을 계산합니다. 특히 상위 후보는 작품명 전체 수요가 아니라 하위 키워드 자체의 네이버 검색광고 수요를 일부 직접 재측정해, 군체처럼 넓은 주제 수요가 모든 롱테일 키워드를 과대평가하는 착시를 줄입니다.
| 기능 | 설명 |
|---|---|
| 멀티 플랫폼 분석 | 네이버(블로그/검색), 유튜브(영상수/조회수), 카카오(다음 검색) 교차 평가 |
| 고정밀 스코어링 | 작품명 전체 수요와 키워드별 직접 수요를 분리해 포화율 알고리즘 적용 |
| 롱테일 자동 탐지 | Naver/Google Suggest API 연동을 통한 실시간 인기 자동완성 키워드 수집 |
| 신뢰도 기반 판정 | API 키 없음/쿼터 초과/측정 실패/수요 0을 황금 키워드와 분리하여 오탐 방지 |
| 플랫폼별 추천등급 | 같은 키워드라도 플랫폼별 경쟁 우위가 다름을 ★★★ 등급으로 표시 |
| AI 기획안 자동 생성 | Gemini 2.5 Flash가 수집된 황금 키워드 기반 맞춤형 콘텐츠 기획안 작성 |
| 통합 파이프라인 | 발굴(Detection) → 평가(Scoring) → 기획(Planning)의 완전 자동화 |
비용과 효율을 극대화한 3단계 지연 평가(Lazy Evaluation) 아키텍처를 채택했습니다.
[데이터 발굴 레이어]
TMDB / WatchaPedia ─────┐
Google News RSS ─────┼──→ [발굴된 시드 키워드 (최대 30개)] ──┐
Naver / Google Suggest ─┘ │
↓
[1차 필터링 (비용 최소화)] ← [주제 수요 및 블로그 공급 측정]
Naver Ad API (검색량) ──┐
Google Trends API (가중치)─┼──→ [통합 수요 산출]
Naver Blog (문서수) ──┼──→ [네이버/티스토리 포화도 랭킹] ──┐
Kakao API (검색결과) ──┘ │
│ (Top 12)
[2차 직접 수요 검증] ← [하위 키워드별 Naver Ad 수요 재측정] │
정확 일치 검색량이 확인된 키워드만 황금 후보로 승격 │
│ (Top 5)
[3차 지연 평가 (고비용)] ← [알짜 키워드 특화 분석] │
YouTube API (에버그린 조회수) ───←──────────────────────────────┘
YouTube API (트렌디 30일 영상수) ──→ [유튜브 포화율 산출 및 ★★★ 판별]
│
↓
[Synergy Content Engine] ← [Gemini 2.5 Pro / Flash]
개별 플랫폼 기획안 생성 (네이버/티스토리/유튜브 등)
다중 작품 연계 시너지(허브) 기획안 자동 생성 (OSMU 체류시간 극대화)
💡 진행 중인 성과 측정 (2026.03 기준) AutoAuthor 파이프라인 도입 이후, 블로그 기획 프로세스를 효율화하고 실제 트래픽 성장을 측정하고 있습니다.
| 지표 (Metrics) | 도입 전 (Before) | 도입 후 (After) | 성장률/개선도 |
|---|---|---|---|
| 기획 소요 시간 | 1건당 약 60분 | 1건당 약 5분 이내 | 91% 단축 🚀 |
| 타겟 유입량 | [Ex. 월간 1천 뷰] | [Ex. 월간 5천 뷰] | [데이터 입력 대기] |
| 상위 노출 포스트 | [Ex. 5 건] | [Ex. 15 건] | [데이터 입력 대기] |
실제 데이터로 업데이트할 예정입니다.
AutoAuthor/
├── README.md
├── LICENSE # MIT License
├── requirements.txt
├── autoauthor/ # 코어 패키지 모듈
│ ├── pipeline.py # 메인 실행 파이프라인 엔진 (V8)
│ ├── sources/ # 데이터 수집 채널 (각 리포트 추적)
│ ├── ai/ # Gemini 2.5 AI 통합 레이어
│ └── planner/ # 기획안 생성 및 템플릿 관리 모듈
├── .env.example # API 키 환경 변수 예시
└── results/ # 각종 CSV 및 기획안(.md) 출력물 저장소
git clone https://github.com/kimble125/AutoAuthor.git
cd AutoAuthor
pip install -r requirements.txt프로젝트 루트에 .env 파일을 생성하고 아래 API 키를 입력합니다.
(API 할당량 초과 방지를 위해 여러 개의 유튜브 키를 활용할 수 있습니다.)
NAVER_CLIENT_ID="발급받은 ID"
NAVER_CLIENT_SECRET="발급받은 Secret"
NAVER_AD_CUSTOMER_ID="검색광고 Customer ID"
NAVER_AD_LICENSE="검색광고 API License"
NAVER_AD_SECRET="검색광고 Secret Key"
KAKAO_API_KEY="Kakao REST API 키"
YOUTUBE_API_KEY="Google Cloud 키"
GEMINI_API_KEY="Google AI Studio 키"
TMDB_API_KEY="TMDB API 키"
TMDB_READ_ACCESS_TOKEN="TMDB Read Access Token"AutoAuthor 파이프라인은 모듈화된 명령어로 가장 쉽고 강력하게 작동합니다.
# 수동 타겟 분석 (기획안 자동 `.md` 파일 저장)
python3 -m autoauthor --titles "마션, 인터스텔라, 그래비티"
# 타겟 플랫폼 지정 및 연계 시너지 기획
python3 -m autoauthor --titles "마션, 인터스텔라" --platforms "tistory,youtube,synergy"
# 전자동 트렌드 탐지 및 기획 (Autopilot)
python3 -m autoauthor --mode autopilot --top 5
# 로컬 웹 서비스 실행
python3 dashboard/server.py --port 8766실행이 완료되면 results/ 폴더에 아래의 에셋들이 자동 구성됩니다.
키워드분석_통합_수동분석_YYYYMMDD.csv(데이터 리포트)키워드분석_통합_수동분석_YYYYMMDD.json(프론트엔드 대시보드용 데이터)latest_portfolio.json(대시보드가 기본으로 읽는 최신 결과)기획안_마션_tistory_YYYYMMDD.md(개별 플랫폼 기획안)기획안__통합__3개_작품_연계_추천_가이드_synergy.md(내부링크 연계 허브 기획안)
최신 CSV는 엑셀에서 바로 읽기 쉽도록 핵심 판단을 앞쪽에 둡니다.
| 컬럼 | 의미 |
|---|---|
추천요약 |
공략 우선, 보류, 제외를 한 줄로 요약 |
기회점수(0-100) |
포화율을 0~100점으로 환산한 우선순위 점수. 직접수요 미검증, 초저수요, 낮은 관련도는 점수 상한을 적용 |
신뢰도(0-100) |
수요, 공급, 유튜브, 트렌드 데이터가 얼마나 검증됐는지의 점수 |
키워드검색수요(월간_직접) |
하위 키워드 자체를 네이버 검색광고 API로 직접 조회한 월간 검색량 |
분석기준수요(월간) |
실제 포화율 계산에 사용한 수요. 직접수요가 확인되면 직접수요를 우선 사용 |
네이버_포화율(%), 다음_포화율(%) |
공급량 / 분석기준수요. 낮을수록 좋고 소수점 2자리로 표시 |
| 변수명 | 필수 여부 | 설명 | 기본값 |
|---|---|---|---|
--mode |
선택 | 실행 모드. autopilot(자동 트렌드 기반) 또는 copilot |
autopilot |
--category |
선택 | 분석 카테고리 (예: movie, drama) |
movie |
--top |
선택 | autopilot 모드 시 상위 몇 개의 트렌드를 검색할지 지정 | 3 |
--platforms |
선택 | 기획안을 생성할 타겟 플랫폼 (콤마로 다중 선택 가능) 지원: tistory, naver, youtube, instagram, facebook, shortform, thread, synergy |
tistory |
--titles |
선택 | 트렌드 탐지를 스킵하고 원하는 작품명 수동 지정 예: "프로젝트 헤일메리, 마션" |
— |
AutoAuthor는 1인 마케터의 최대 효율(OSMU)과 한정된 리소스 관리를 지향하며 아래 3원칙으로 설계되었습니다.
-
지능형 비용 제어 (Intelligent Lazy Evaluation)
- 유튜브 API의
10,000쿼터 한도 문제를 회피하기 위해 무차별 탐색을 폐기. 무료인 네이버 블로그 문서량으로 시장을 1단계 필터링하고, 상위 후보만 네이버 검색광고 직접수요와 유튜브 지표로 정밀 평가하는 지연 평가(Lazy Evaluation) 아키텍처로 API 소모 비용을 줄입니다.
- 유튜브 API의
-
단기 바이럴과 장기 수익의 투 트랙 (Trendy vs Evergreen)
- 오늘 당장 터지는 키워드(최근 30일 데이터 + Google Trends 지수)와 영원히 읽히는 롱테일 키워드(유튜브 통합 조회수 + 블로그 누적 문서)를 이중으로 분석하여, 가장 공격적이고 단단한 수익 파이프라인 밸런스를 구축합니다.
-
연계 로직 (Synergy Content Engine)
- 점 단위의 정보가 아니라 '선' 단위의 흐름을 짭니다. 여러 작품을 동시에 분석하면 이를 하나로 관통하는 메가 테마를 도출하고, 각각의 개별 문서끼리 내부 링크(Internal Linking) 할 수 있도록 기획부터 SEO 허브 구조를 설계하여 체류 시간을 극대화합니다.
AutoAuthor는 수요는 높고 공급은 낮은 키워드를 찾습니다. 다만 이제는 넓은 주제의 전체 수요만 믿지 않고, 상위 후보에 대해 하위 키워드 자체의 직접 월간 검색량을 확인합니다.
예를 들어 군체 후기 디시의 네이버 총문서량이 4개라면 공급은 매우 낮습니다. 예전 방식에서는 군체 전체 수요를 분모로 삼아 바로 황금 후보처럼 보일 수 있었습니다. 현재 방식에서는 군체 후기 디시 자체의 네이버 검색광고 수요가 정확히 확인되어야 황금키워드=Y로 승격합니다. 직접수요가 없거나 정확히 매칭되지 않으면 보류: 키워드 직접수요 없음 또는 보류: 직접수요 미검증으로 표시됩니다.
| 컬럼 | 의미 |
|---|---|
구글트렌드_최근관심도(0-100) |
Google Trends에서 최근 1개월 중 해당 주제의 자체 최고 관심도를 100으로 놓고, 최근 3일 평균을 0~100으로 환산한 값입니다. 시장점유율이나 검색량 비율이 아닙니다. |
주제검색수요(월간) |
작품명/주제명을 네이버 검색광고 API로 조회한 월간 PC+모바일 검색량입니다. |
주제기반_통합수요(월간) |
주제검색수요에 Google Trends 최근관심도 보너스를 반영한 주제 단위 수요 추정치입니다. 하위 키워드의 정확한 검색량은 아닙니다. |
키워드검색수요(월간_직접) |
하위 키워드 자체를 네이버 검색광고 API로 직접 조회한 월간 검색량입니다. 황금 키워드 판정에서 가장 중요합니다. |
분석기준수요(월간) |
포화율 계산에 실제로 사용한 수요입니다. 키워드 직접수요가 정확히 확인되면 그 값을 사용하고, 미조회 후보는 주제 수요 대체로 표시됩니다. |
네이버_포화율(%) |
네이버 블로그 문서량 / 분석기준수요 * 100입니다. 만점 개념이 아니라 낮을수록 좋습니다. |
다음_포화율(%) |
다음/카카오 블로그 문서량 / 분석기준수요 * 100입니다. 낮을수록 좋습니다. |
유튜브_최근공급지수(영상/천검색) |
최근 30일 유튜브 영상 수를 검색수요 1,000회 단위로 나눈 값입니다. 퍼센트가 아닙니다. |
추천요약 |
공략 우선, 보류, 제외를 사람이 바로 읽을 수 있게 압축한 판정입니다. |
추천도는 상위 몇 개를 강제로 ★★★로 주는 상대평가가 아니라, 아래 임계값을 통과해야 붙는 절대평가입니다. 그래서 데이터 분포에 따라 ★★★와 ★만 많고 ★★가 적게 나올 수 있습니다. 특히 직접수요가 확인되지 않은 키워드는 문서량이 낮아도 황금 키워드로 확정하지 않습니다. 또한 월간 직접수요가 100회 미만인 초저수요 키워드는 공급이 낮아도 보류로 둡니다.
| 등급 | 네이버 포화율 | 다음 포화율 | 유튜브 최근공급지수 | 의미 |
|---|---|---|---|---|
| ★★★ | 0.50% 이하 | 0.20% 이하 | 0.50 이하 | 직접수요 100회 이상이며 공급이 매우 낮은 공략 우선 후보 |
| ★★ | 2.00% 이하 | 1.00% 이하 | 1.50 이하 | 경쟁은 있으나 품질로 승산 있는 후보 |
| ★ | 기준 초과 | 기준 초과 | 기준 초과 | 이미 공급이 많은 시장 |
| - | 측정 불가 | 측정 불가 | 측정 불가 | 키 없음, 쿼터 초과, API 실패, 수요 0 등 |
추천도별 개수는 README에 고정 기준으로 존재하지 않습니다. 별 개수는 결과마다 달라지는 출력값이며, 품질 판단은 별 개수만 보지 말고 황금키워드, 추천요약, 신뢰도(0-100), 키워드검색수요(월간_직접)을 함께 봐야 합니다.
requested_topics는 사용자가 요청한 주제 4개를 실제 API로 처음 분석한 원본 결과입니다. requested_topics_refined는 같은 측정값을 바탕으로 주제 관련도 필터를 오프라인으로 한 번 더 적용한 보정 결과입니다. 그래서 공급량, 수요 같은 원천 수치는 거의 같고, 주로 황금키워드, 판정근거, 정렬 결과가 달라집니다. 최신 코드에서는 이 보정 로직이 파이프라인 안으로 들어왔고, 추가로 키워드별 직접수요 검증까지 수행합니다.
AutoAuthor의 유튜브 지표 수집(에버그린/트렌디 투 트랙 전략)은 구글 클라우드의 YouTube Data API를 사용합니다.
- 일일 무료 제공량: 10,000 할당량(Quota Units)
- 1키워드 당 소모량: 200 할당량 (누적 검색 100 + 최근 30일 검색 100)
- 우회 전략 (Lazy Evaluation): 비용 폭탄을 막기 위해 네이버 블로그 검색으로 먼저 포화도를 판별하고 가장 추천할만 한(블루오션인) 상위 5개의 키워드에 대해서만 제한적으로 유튜브 검색을 실행합니다. (하루 최대 10개 영화 세트 분석 가능)
- 만약 결과에 유튜브 추천도나 조회수가 하이픈(-) 또는 0으로 나온다면?:
이는 에러가 아니라 일일 10,000 쿼터 한도를 모두 소진했기 때문입니다. 당황하지 마시고, 제한이 리셋되는 다음 날 오전(태평양 표준시 자정 기준)에 다시 시도하거나 구글 클라우드 콘솔에서 API Key를 추가 발급받아 환경 변수(
.env)를 교체하시면 됩니다. 나머지 하위 순위 키워드들에 대해서는 조회 자체를 생략하므로(조회 생략)기호로 표기됩니다.
예시: 네이버에서 ★★인 키워드가 유튜브에선 ★★★일 수 있습니다. 이 경우 해당 콘텐츠는 영상으로 제작하는 것이 유리합니다.
AutoAuthor는 발굴된 **황금 키워드(★★★)**를 기반으로 플랫폼 맞춤형 기획안을 자동 생성합니다:
- 네이버 블로그: SEO 최적화 제목, H2-H3 구조, 메타 디스크립션 포함.
- 유튜브: 고클릭 유도 썸네일 컨셉, 시청 지속시간을 고려한 대본 스크립트.
- 티스토리: 애드센스 수익 극대화를 위한 정보성 글 구조 및 관련 키워드 배치.
기획안 #1 (우선순위: ★★★ 최우선 공략)
──────────────────────────────
제목: [SEO 최적화 제목 — 황금 키워드 앞 20자 이내 배치]
H2-1: 들어가며 — 독자의 관심을 끄는 질문이나 상황 제시
H2-2: 본문 1 — 핵심 분석
H2-3: 본문 2 — 심층 해석
H2-4: 본문 3 — 부가 정보
H2-5: 마치며 — 총평 및 추천
간략 소개: [150자 내외 메타 디스크립션]
타깃 키워드: [키워드1, 키워드2, ...]
| 콘텐츠명 | 하위 키워드 | 추천요약 | 직접수요 | 분석기준수요 | 네이버 문서량 | 네이버 포화율 | 황금 |
|---|---|---|---|---|---|---|---|
| 군체 | 군체 평점 | 공략 우선 | 267,900 | 484,899 | 608 | 0.13% | Y |
| 군체 | 군체 결말 해석 디시 | 보류: 직접수요 기준 미달 | 10 | 18 | 1 | 5.56% | N |
| 오십프로 | 오십프로 재방송 | 공략 우선 | 17,350 | 27,586 | 89 | 0.32% | Y |
분석 결과를 팀과 공유하고, 초심자도 제목 입력만으로 분석을 시작할 수 있는 로컬 대시보드:
로컬 실행:
python3 dashboard/server.py --port 8766브라우저에서 http://127.0.0.1:8766을 열면 아래 흐름을 바로 사용할 수 있습니다.
흥행 드라마 발굴: 트렌드 소스에서 최근 후보를 찾고 클릭하면 분석으로 연결제목으로 분석: 드라마 제목을 입력하면 기존 파이프라인으로 황금 키워드 산출상위 판정 키워드: 공략 우선, 후보, 보류, 제외를 필터링하고 CSV로 저장
UI 프리뷰 (아래 대괄호 영역을 실제 이미지 경로로 수정해 주세요)
황금 키워드를 발굴하여 한눈에 보여주는 핵심 매트릭스 UI
Gemini 2.5 Pro가 즉시 발행 가능한 맞춤형 기획안 3종을 제안하는 화면
주요 기능:
- 최근 흥행 드라마 후보 탐색
- 드라마 제목 직접 입력 분석
- CSV 파일 업로드 → 키워드 테이블 실시간 갱신
results/latest_portfolio.json자동 로딩- 판정/주제/키워드 필터 및 CSV 저장
- 화제성 × 포화도 전략 매트릭스 시각화
- 트렌드 미니 차트 (7일간 검색량 패턴)
- AI 기획안 3종 예시 카드
- 파이프라인 설계 문서 내장
| 용도 | 모델 | 비고 |
|---|---|---|
| 개인 사용 (기본) | Gemini 2.5 Pro | Google AI Studio 무료 API, 한국어 최고 품질 |
| 빠른 초안 | Gemini 2.5 Flash | 속도 우선 시 |
| 서비스 출시 (오픈소스) | EXAONE 3.5 (LG AI) | 한국어 특화, Apache 2.0, 완전 무료 |
| 대안 | Qwen2.5-72B | 한국어 우수, vLLM 셀프 호스팅 |
| 대안 | Groq + llama-3.3-70b | 무료 할당량 내 사용 가능 |
| 로컬 실행 | Ollama | 인터넷 불필요, 개인정보 보호 |
- Language: Python 3.9+
- AI: Google Gemini 2.5 Flash / Pro API
- Data Sources:
- Naver: Search Ad API (수요), Search Blog OpenAPI (공급)
- YouTube: Data API v3 (수요/공급)
- Other: Naver/Google Suggest API, TMDB, WatchaPedia, Google News RSS
- Web Dashboard: React 19 + Tailwind CSS 4 + Recharts + shadcn/ui
- Deployment: GitHub Actions / Manus (manus.space)
이 툴킷은 다음 블로그의 SEO 전략 수립에 실제로 활용되고 있습니다:
- MVforrest 블로그: forrest125.tistory.com — 영화·드라마 심층 리뷰 (41편+)
- V1: 구글 자동완성 기반 키워드 수집
- V2: 네이버 경쟁도 측정 + 기회 점수 산출
- V3: Gemini AI 연동 + CLI 인터페이스 + 프로필 시스템
- V4: AutoAuthor 화제성 × 포화도 등급 시스템
- V5: AI 기획안 자동 생성 (content_planner.py)
- V6: 네이버 검색광고 API 통합 (고정밀 검색량 측정)
- V7: 유튜브 Data API v3 통합 (멀티 플랫폼 스코어링)
- V8: 네이버 자동완성(Suggest) 소스 추가 (롱테일 키워드 수집 강화)
- V9: 카카오/티스토리 통합 및 자동 포스팅 연동
- V10: SQLite 적재 + 대시보드 고도화
MIT License — 자유롭게 사용, 수정, 배포 가능합니다.