content-genie-mcp 2.0.0 → 2.5.0

package/README.md

@@ -1,31 +1,43 @@
-# 🧞 Content Genie MCP
+# Content Genie MCP v2.0
 
-> 한국 콘텐츠 크리에이터를 위한 AI 어시스턴트 MCP 서버
+> 한국 콘텐츠 크리에이터를 위한 올인원 AI 콘텐츠 어시스턴트
 
 [![npm version](https://badge.fury.io/js/content-genie-mcp.svg)](https://www.npmjs.com/package/content-genie-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Content Genie MCP는 블로거, 유튜버, 인스타그래머, 마케터를 위한 올인원 콘텐츠 생성 도우미입니다. 한국 시장에 특화된 트렌드 분석, 콘텐츠 아이디어 생성, SEO 최적화 기능을 제공합니다.
+Content Genie MCP는 블로거, 유튜버, 인스타그래머, 마케터를 위한 **12가지 강력한 도구**를 제공하는 MCP 서버입니다. 한국 시장에 특화된 트렌드 분석, 콘텐츠 아이디어 생성, SEO 최적화, 바이럴 예측 기능을 제공합니다.
 
-## ✨ 주요 기능
+## v2.0 New Features
 
-### 🔥 7가지 핵심 도구
+- 12개 도구로 확장 (기존 7개 → 12개)
+- 실시간 네이버/다음/구글/유튜브 트렌드 스크래핑
+- 40+ 한국 기념일/이벤트 DB 내장
+- 고급 바이럴 점수 예측 알고리즘
+- A/B 테스트 변형 자동 생성
+- 플랫폼별 해시태그 전략
 
-| 도구 | 설명 |
-|------|------|
-| `get_korean_trends` | 네이버, 구글, 유튜브 실시간 트렌드 분석 |
-| `generate_content_ideas` | 주제 기반 콘텐츠 아이디어 자동 생성 |
-| `optimize_title_hashtags` | CTR 최적화 제목 및 해시태그 생성 |
-| `analyze_seo_keywords` | SEO 키워드 분석 및 롱테일 키워드 추천 |
-| `create_content_calendar` | 한국 공휴일 반영 콘텐츠 캘린더 생성 |
-| `analyze_competitor_content` | 경쟁사 콘텐츠 전략 분석 |
-| `predict_viral_score` | 바이럴 가능성 예측 및 개선 제안 |
+## 12가지 핵심 도구
 
-## 🚀 설치 및 사용법
+| # | 도구 | 설명 |
+|---|------|------|
+| 1 | `get_korean_trends` | 네이버/다음/구글/유튜브/줌 실시간 트렌드 |
+| 2 | `generate_content_ideas` | AI 콘텐츠 아이디어 + 시즌/트렌드 연계 |
+| 3 | `optimize_title_hashtags` | CTR 최적화 제목 + 플랫폼별 해시태그 |
+| 4 | `analyze_seo_keywords` | 네이버/구글 SEO 분석 + 롱테일 키워드 |
+| 5 | `create_content_calendar` | 한국 기념일 반영 콘텐츠 캘린더 |
+| 6 | `analyze_competitor_content` | 경쟁사 콘텐츠 심층 분석 |
+| 7 | `predict_viral_score` | AI 바이럴 가능성 예측 (S~D 등급) |
+| 8 | `analyze_news_trends` | 실시간 한국 뉴스 트렌드 분석 |
+| 9 | `generate_hashtag_strategy` | 플랫폼별 해시태그 전략 생성 |
+| 10 | `benchmark_content_performance` | 업계별 성과 벤치마크 |
+| 11 | `generate_ab_test_variants` | A/B 테스트 변형 자동 생성 |
+| 12 | `get_seasonal_content_guide` | 시즌/이벤트 콘텐츠 가이드 |
 
-### Claude Desktop에서 사용
+## 설치 및 사용법
 
-`claude_desktop_config.json`에 추가:
+### Claude Desktop
+
+`claude_desktop_config.json`:
 
 ```json
 {
@@ -38,148 +50,260 @@ Content Genie MCP는 블로거, 유튜버, 인스타그래머, 마케터를 위
 }
 ```
 
-### Claude Code에서 사용
+### Claude Code
 
 ```bash
 claude mcp add content-genie-mcp -- npx -y content-genie-mcp
 ```
 
-### PlayMCP에서 사용
+### PlayMCP
 
 [PlayMCP](https://playmcp.kakao.com)에서 "Content Genie"를 검색하여 도구함에 추가하세요.
 
-## 📖 도구 상세 설명
+## 도구 상세
 
-### 1. get_korean_trends - 한국 트렌드 분석
+### 1. get_korean_trends
 
 ```
 실시간 한국 트렌드 키워드를 분석합니다.
 
-매개변수:
-- platform: "naver" | "google" | "youtube" | "all" (기본값: all)
-- category: "general" | "news" | "shopping" | "entertainment" | "all"
-- limit: 1-50 (기본값: 20)
+Parameters:
+- platform: "naver" | "google" | "youtube" | "daum" | "zum" | "all"
+- category: "general" | "news" | "shopping" | "entertainment" | "tech" | "finance" | "sports" | "all"
+- limit: 1-50
+
+Returns:
+- 플랫폼별 트렌드 키워드
+- 카테고리 분석
+- 콘텐츠 기회 발굴
+- 다가오는 이벤트
 ```
 
-### 2. generate_content_ideas - 콘텐츠 아이디어 생성
+### 2. generate_content_ideas
 
 ```
-주제와 플랫폼에 맞는 콘텐츠 아이디어를 생성합니다.
-
-매개변수:
-- topic: 콘텐츠 주제 (필수)
-- content_type: "blog" | "youtube" | "instagram" | "tiktok" | "newsletter" | "all"
-- tone: "professional" | "casual" | "humorous" | "educational" | "inspirational"
-- target_audience: 타겟 오디언스 설명
-- count: 1-20 (기본값: 10)
+주제 기반 콘텐츠 아이디어 생성
+
+Parameters:
+- topic: 콘텐츠 주제
+- content_type: "blog" | "youtube" | "instagram" | "tiktok" | "newsletter" | "threads" | "twitter" | "all"
+- tone: "professional" | "casual" | "humorous" | "educational" | "inspirational" | "provocative" | "storytelling"
+- target_audience: 타겟 오디언스
+- count: 1-30
+- include_trends: 트렌드 연계 아이디어 포함
+
+Returns:
+- 메인 아이디어 (형식별)
+- 시즌/이벤트 연계 아이디어
+- 트렌드 기반 아이디어
+- 플랫폼별 팁
 ```
 
-### 3. optimize_title_hashtags - 제목/해시태그 최적화
+### 3. optimize_title_hashtags
 
 ```
-CTR 향상을 위한 제목 최적화 및 해시태그 생성
+CTR 최적화 제목 및 해시태그 생성
 
-매개변수:
-- original_title: 원본 제목 (필수)
+Parameters:
+- original_title: 원본 제목
 - platform: 타겟 플랫폼
-- keywords: 포함할 키워드 배열
-- style: "clickbait" | "informative" | "emotional" | "question" | "how-to" | "listicle"
-- max_length: 최대 글자 수 (기본값: 60)
+- keywords: 키워드 목록
+- style: "clickbait" | "informative" | "emotional" | "question" | "how-to" | "listicle" | "controversy" | "story"
+- language: "ko" | "en" | "mixed"
+
+Returns:
+- 최적화된 제목 변형 (CTR 예측 포함)
+- 플랫폼별 해시태그 전략
+- SEO 권장사항
 ```
 
-### 4. analyze_seo_keywords - SEO 키워드 분석
+### 4. analyze_seo_keywords
 
 ```
-키워드의 SEO 잠재력 분석 및 추천
-
-매개변수:
-- keyword: 분석할 키워드 (필수)
-- language: "ko" | "en" | "both"
-- include_questions: 질문형 키워드 포함 (기본값: true)
-- include_longtail: 롱테일 키워드 포함 (기본값: true)
+SEO 키워드 심층 분석
+
+Parameters:
+- keyword: 메인 키워드
+- search_engine: "naver" | "google" | "both"
+- include_questions: 질문형 키워드 포함
+- include_longtail: 롱테일 키워드 포함
+- competitor_analysis: 경쟁 분석 포함
+
+Returns:
+- 검색량/경쟁도 분석
+- 관련 키워드
+- 질문형 키워드
+- 롱테일 키워드
+- 네이버/구글 최적화 전략
 ```
 
-### 5. create_content_calendar - 콘텐츠 캘린더 생성
+### 5. create_content_calendar
 
 ```
-한국 기념일 반영 콘텐츠 캘린더 자동 생성
+콘텐츠 캘린더 자동 생성
+
+Parameters:
+- topics: 주제 목록
+- duration_weeks: 1-24주
+- posts_per_week: 1-21개
+- platforms: 플랫폼 목록
+- include_events: 기념일/이벤트 반영
+- content_mix: "balanced" | "promotional" | "educational" | "entertaining"
+
+Returns:
+- 주간/일간 캘린더
+- 플랫폼별 포맷 제안
+- 최적 게시 시간
+- 한국 기념일 연계
+```
+
+### 6. analyze_competitor_content
 
-매개변수:
-- topics: 주제 배열 (필수)
-- duration_weeks: 1-12주 (기본값: 4)
-- posts_per_week: 1-14개 (기본값: 3)
-- platforms: 플랫폼 배열
-- include_holidays: 공휴일/기념일 포함 (기본값: true)
+```
+경쟁사 콘텐츠 분석
+
+Parameters:
+- urls: URL 목록 (최대 10개)
+- analysis_depth: "basic" | "detailed" | "comprehensive"
+- extract_strategy: 전략 추출
+
+Returns:
+- 제목/메타 분석
+- 구조 분석 (H1, H2, H3)
+- 키워드 분석
+- 전략 인사이트
 ```
 
-### 6. analyze_competitor_content - 경쟁사 분석
+### 7. predict_viral_score
 
 ```
-경쟁사 콘텐츠 전략 분석
+바이럴 가능성 예측
 
-매개변수:
-- urls: 분석할 URL 배열 (최대 5개)
-- analysis_type: "title" | "structure" | "keywords" | "all"
+Parameters:
+- title: 콘텐츠 제목
+- description: 설명
+- platform: 플랫폼
+- hashtags: 해시태그
+- content_type: "image" | "video" | "text" | "carousel" | "reel"
+
+Returns:
+- 바이럴 점수 (0-100)
+- 등급 (S/A/B/C/D)
+- 감정/구조 분석
+- 개선 제안
+- 성과 예측
 ```
 
-### 7. predict_viral_score - 바이럴 예측
+### 8. analyze_news_trends
 
 ```
-콘텐츠 바이럴 가능성 점수 예측
+한국 뉴스 트렌드 분석
+
+Parameters:
+- category: "general" | "politics" | "economy" | "society" | "culture" | "sports" | "tech" | "entertainment"
+- time_range: "1h" | "24h" | "7d" | "30d"
+- extract_keywords: 키워드 추출
+
+Returns:
+- 주요 뉴스
+- 키워드 빈도
+- 감성 분석
+- 콘텐츠 기회
+```
 
-매개변수:
-- title: 콘텐츠 제목 (필수)
-- description: 설명
-- platform: 타겟 플랫폼
-- hashtags: 해시태그 배열
+### 9. generate_hashtag_strategy
+
+```
+플랫폼별 해시태그 전략
+
+Parameters:
+- topic: 주제
+- platform: "instagram" | "tiktok" | "youtube" | "twitter" | "threads"
+- count: 5-50
+- include_korean: 한국어 해시태그
+- include_english: 영어 해시태그
+
+Returns:
+- 우선순위별 해시태그
+- 복사용 해시태그 문자열
+- 플랫폼별 권장사항
 ```
 
-## 💡 사용 예시
+### 10. benchmark_content_performance
 
-### 트렌드 기반 콘텐츠 기획
+```
+업계 벤치마크 데이터
 
+Parameters:
+- category: 콘텐츠 카테고리 (뷰티, 테크, 푸드 등)
+- platform: 플랫폼
+- metric: "engagement" | "reach" | "conversion" | "all"
+
+Returns:
+- 평균 성과 지표
+- 성과 등급 기준
+- 개선 팁
 ```
-1. get_korean_trends로 최신 트렌드 파악
-2. generate_content_ideas로 아이디어 생성
-3. optimize_title_hashtags로 제목 최적화
-4. predict_viral_score로 바이럴 가능성 확인
-5. create_content_calendar로 일정 수립
+
+### 11. generate_ab_test_variants
+
 ```
+A/B 테스트 변형 생성
 
-### SEO 최적화 콘텐츠 작성
+Parameters:
+- original_content: 원본 콘텐츠
+- content_element: "title" | "description" | "cta" | "hashtags" | "thumbnail_concept"
+- variants_count: 2-10
 
+Returns:
+- 변형 목록
+- 예측 성과
+- 테스트 권장사항
 ```
-1. analyze_seo_keywords로 키워드 분석
-2. analyze_competitor_content로 경쟁사 벤치마킹
-3. generate_content_ideas로 차별화된 아이디어 도출
-4. optimize_title_hashtags로 검색 최적화
+
+### 12. get_seasonal_content_guide
+
 ```
+시즌/이벤트 콘텐츠 가이드
+
+Parameters:
+- days_ahead: 1-90일
+- category: "all" | "holiday" | "commercial" | "traditional" | "shopping" | "event"
 
-## 🎯 타겟 사용자
+Returns:
+- 다가오는 이벤트
+- 준비 타임라인
+- 콘텐츠 아이디어
+- 해시태그 제안
+```
+
+## 한국 기념일 DB (40+)
+
+- **공휴일**: 새해, 설날, 삼일절, 어린이날, 부처님오신날, 현충일, 광복절, 추석, 개천절, 한글날, 크리스마스
+- **상업 이벤트**: 발렌타인데이, 화이트데이, 어버이날, 로즈데이, 빼빼로데이 등
+- **시즌 이벤트**: 할로윈, 블랙프라이데이, 정월대보름, 수능 등
+- **쇼핑 시즌**: 신년 세일, 여름 세일, 가을 신상, 연말 세일
+
+## 타겟 사용자
 
 - **블로거**: 네이버 블로그, 티스토리 운영자
 - **유튜버**: 콘텐츠 기획 및 제목 최적화
 - **인스타그래머**: 해시태그 전략 및 포스팅 일정
+- **틱토커**: 트렌드 분석 및 바이럴 예측
 - **마케터**: 콘텐츠 마케팅 전략 수립
 - **스타트업**: 브랜드 콘텐츠 기획
 
-## 🔧 기술 스택
+## 기술 스택
 
 - TypeScript
 - MCP SDK (@modelcontextprotocol/sdk)
 - Axios & Cheerio (웹 스크래핑)
 - Zod (스키마 검증)
 
-## 📄 라이선스
+## License
 
 MIT License
 
-## 👨‍💻 개발자
+## Author
 
 **Yoonkyoung Gong** - [GitHub](https://github.com/MUSE-CODE-SPACE)
-
----
-
-🏆 **PlayMCP Player 10 공모전 출품작**
-
-이 프로젝트는 카카오 PlayMCP 개발 공모전을 위해 제작되었습니다.

package/TEST_RESULTS.md

@@ -0,0 +1,171 @@
+# Content Genie MCP v2.0.0 테스트 결과
+
+## 테스트 일시
+2025-12-26 19:57 KST
+
+## 테스트 환경
+- Node.js 18+
+- MCP SDK v1.25.1
+- macOS Darwin 24.5.0
+
+---
+
+## 1. 서버 초기화 테스트 ✅
+
+```json
+{
+  "serverInfo": {
+    "name": "content-genie-mcp",
+    "version": "2.0.0"
+  },
+  "capabilities": {
+    "tools": { "listChanged": true }
+  }
+}
+```
+
+**결과**: 서버 정상 시작, 12개 도구 등록 완료
+
+---
+
+## 2. get_korean_trends 테스트 ✅
+
+**입력**:
+- platform: "naver"
+- category: "general"
+- limit: 10
+
+**결과**:
+- 다가오는 이벤트 감지: 연말(D-5), 새해(D-6)
+- 인사이트 제공: 기술 카테고리 인기, AI 콘텐츠 수요 증가
+- 최적 게시 시간 추천: 평일 오전 9-11시, 저녁 7-9시
+
+---
+
+## 3. predict_viral_score 테스트 ✅
+
+**입력**:
+- title: "2024년 최고의 맛집 TOP 10! 이거 안 보면 후회합니다"
+- platform: "youtube"
+- hashtags: ["맛집", "서울맛집", "핫플", "먹방", "맛집추천"]
+- content_type: "video"
+
+**결과**:
+| 항목 | 값 |
+|------|-----|
+| 바이럴 점수 | **88점** |
+| 등급 | **S (바이럴 예상)** |
+| 도달 예측 | 높음 |
+| 인게이지먼트 | 높음 |
+| 공유 예측 | 높음 |
+
+**감지된 요소**:
+- ✅ 숫자 포함 (TOP 10)
+- ✅ 강조 표현 ("최고의", "후회")
+- ✅ 감정 트리거 (긍정)
+
+---
+
+## 4. analyze_competitor_content 테스트 ✅
+
+**입력**:
+- URL: https://blog.naver.com/prologue/PrologueList.nhn?blogId=nvr_design
+- analysis_depth: "detailed"
+
+**결과**:
+| 항목 | 값 |
+|------|-----|
+| 제목 | 네이버 설계(디자인) : 네이버 블로그 |
+| 단어 수 | 3,037 |
+| 이미지 수 | 71개 |
+| 비디오 수 | 0개 |
+| 외부 링크 | 4개 |
+
+**전략 인사이트**:
+- H2 태그로 주요 섹션 구분
+- 리스트형 콘텐츠 선호
+- 이미지와 텍스트 적절히 배합
+- 💡 비디오 콘텐츠 추가로 차별화 기회
+
+---
+
+## 5. generate_content_ideas 테스트 ✅
+
+**입력**:
+- topic: "겨울 스킨케어"
+- content_type: "instagram"
+- tone: "casual"
+- target_audience: "20-30대 여성"
+- count: 5
+
+**생성된 아이디어**:
+1. X가지 겨울 스킨케어 꿀팁 (SEO 90점)
+2. 겨울 스킨케어 BEST 10 (SEO 85점)
+3. 2025년 겨울 스킨케어 트렌드 7가지 (SEO 88점)
+4. 겨울 스킨케어 완벽 가이드 (SEO 92점)
+5. 초보자를 위한 겨울 스킨케어 시작하기 (SEO 90점)
+
+**시즌 연계 아이디어**:
+- 연말 x 겨울 스킨케어 (D-5, 긴급)
+- 새해 x 겨울 스킨케어 (D-6, 긴급)
+- 신년 세일 x 겨울 스킨케어 (D-7, 긴급)
+
+---
+
+## 6. analyze_news_trends 테스트 ✅
+
+**입력**:
+- category: "tech"
+- time_range: "24h"
+
+**결과**:
+| 키워드 | 빈도 | 트렌드 |
+|--------|------|--------|
+| AI | 45 | 📈 상승 |
+| 경제 | 38 | ➡️ 유지 |
+| 트렌드 | 32 | 📈 상승 |
+| 투자 | 28 | 📈 상승 |
+| 기술 | 25 | 📈 상승 |
+
+**감성 분석**:
+- 긍정: 35%
+- 중립: 50%
+- 부정: 15%
+
+---
+
+## 7. get_seasonal_content_guide 테스트 ✅
+
+**입력**:
+- days_ahead: 30
+- category: "all"
+
+**다가오는 이벤트**:
+| 날짜 | 이벤트 | D-Day | 콘텐츠 아이디어 |
+|------|--------|-------|-----------------|
+| 12/31 | 연말 | D-5 | 연말 정산, 올해의 회고, 새해 계획 |
+| 01/01 | 새해 | D-6 | 신년 계획, 새해 다짐, 2025 트렌드 |
+| 01/02 | 신년 세일 | D-7 | 할인 정보, 신년 쇼핑 |
+| 01/15 | 정월대보름 | D-20 | 오곡밥, 부럼 깨기, 달맞이 |
+
+---
+
+## 테스트 요약
+
+| 도구 | 상태 | 비고 |
+|------|------|------|
+| get_korean_trends | ✅ 성공 | 이벤트 감지 정상 |
+| predict_viral_score | ✅ 성공 | 88점 S등급 예측 |
+| analyze_competitor_content | ✅ 성공 | 실제 URL 분석 완료 |
+| generate_content_ideas | ✅ 성공 | 5개 아이디어 생성 |
+| analyze_news_trends | ✅ 성공 | 키워드/감성 분석 완료 |
+| get_seasonal_content_guide | ✅ 성공 | 4개 이벤트 감지 |
+
+**전체 테스트 결과: 6/6 통과 (100%)**
+
+---
+
+## 배포 정보
+
+- **npm**: [content-genie-mcp@2.0.0](https://www.npmjs.com/package/content-genie-mcp)
+- **GitHub**: [MUSE-CODE-SPACE/content-genie-mcp](https://github.com/MUSE-CODE-SPACE/content-genie-mcp)