content-genie

content-genie-mcp

Claude に Naver／Daum／Google／YouTube／Zum のリアルタイムトレンド、100 件以上の韓国の祝日 DB、バイラルスコア予測機能を提供する韓国コンテンツクリエイター向け MCP です。投稿のたびに 5 つのトレンドダッシュボードを行き来する必要がなくなります。

English · 한국어

---

content-genie が選ばれる理由

多くの「トレンド」MCP は、Google Trends を薄くラップしただけのものです。韓国のオーディエンスに向けて発信する場合（Naver Blog、YouTube Korea、Instagram KR、TikTok）、Google だけではトレンドを捉えきれません。Naver Datalab、Daum 検索、Zum リアルタイム検索、韓国地域の YouTube は、それぞれ異なる時間帯に異なるキーワードを提示します。content-genie は5 つのソースすべてを 1 つの MCP に統合し、韓国の祝日 100 件以上＋14 日間の記念日シリーズ＋節気のイベントデータベースを備えているため、Claude は指示がなくてもペペロデーや大学修学能力試験を考慮して計画できます。さらに、韓国コンテンツの CTR を左右する構造的パターン（数字、括弧、感情を揺さぶる表現、緊急性を示す言葉）に基づいて学習したバイラルスコア予測機能で、一連の作業を完結できます。

Phase 4 のリファクタリング（v2.12.0、2026 年 5 月）により、安心して依存できる仕組みになりました。すべてのスクレイパーは、ソースごとのサーキットブレーカー（3 回失敗すると 5 分間オープン）と古いキャッシュへのフォールバックを備えています。そのため、Naver の HTML が変更されても MCP 全体が停止することはありません。影響を受けたソースのみ機能が低下し、resource://content-genie/sources を通じて LLM にその状況を通知します。

v2.12.0 の新機能

• 17 個のツール、1 つのレジストリ、6 つの小さなファイル。 旧版の 4,712 行の index.ts はなくなり、ツールは src/tools/{trends,seo,contentIdeas,viralScoring,competitorAnalysis,koreanEvents}.ts に配置されています。ツールの追加は 1 行で済みます。
• スクレイパーがサーバーを停止させることはなくなりました。 ソースごとのサーキットブレーカー＋LRU／TTL キャッシュ（15 分、100 件）＋古いキャッシュへのフォールバックを備えています。Naver の機能が低下すると、Claude は source_status: 'stale' を確認して対応します。
• @メンション用の MCP リソースを 2 つ追加。 resource://content-genie/korean-events/{year} は任意の年を基準にしたイベント DB 全体を返し、resource://content-genie/sources はサーキットブレーカーとキャッシュの現在の状態を公開します。
• ガイド付きワークフローとして MCP プロンプトを 2 つ追加。 viral-title は optimize_title_hashtags → predict_viral_score → generate_ab_test_variants の順に実行します。competitor-analysis は URL 分析と、不足を補うアイデア出しを行います。
• 8 つのテストスイートで 38 件のテスト。 サーキットブレーカーの状態遷移、キャッシュの削除、スクレイパーのフォールバック経路、SSRF ガード、すべてのツールグループを対象にしています。CI では Node 22 と 24 で実行されます。

5 分で始める

# 1. Install via Claude Code (recommended)
claude mcp add content-genie -- npx -y content-genie-mcp

# 2. Or add to Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "content-genie": {
      "command": "npx",
      "args": ["-y", "content-genie-mcp"]
    }
  }
}

3. Claude Desktop を再起動します（または claude を実行すると、次回の実行時に読み込まれます）。
4. Claude で次のように試してください。

오늘 한국에서 뜨는 키워드 5개로 유튜브 쇼츠 제목 후보 3개씩 만들고, 각각 바이럴 점수 등급 매겨줘.

5. 期待される動作：Claude は get_korean_trends（naver+daum+google+youtube+zum を統合）を呼び出し、各キーワードについて optimize_title_hashtags を実行し、続いて predict_viral_score を実行します。その後、構造上の理由（「タイトルに数字＋好奇心を刺激するトリガーを含む」）とともに、S/A/B/C/D のランク付き評価表を返します。

実際のユースケース

1. 「明日には古くならない韓国語ブログのテーマが必要です」

課題： Naver Blog では、今まさにトレンドになっているキーワードをすばやく取り上げると評価されますが、キーワードは4時間ごとに変わります。 この MCP の活用方法： Claude が get_korean_trends({ platform: 'naver', limit: 20 }) を呼び出し、最も新しい5つのキーワードを対象に seasonal: true を指定して generate_content_ideas を実行します。季節要素のレイヤーでは、100件以上を収録した DB から今後の韓国のイベントを加えるため、提案は単なる「AI 추천 도구」ではなく、get_seasonal_content_guide が 수능 まで4週間と判断したことによる「AI 추천 도구 + 수능 D-30 콘텐츠 기획」になります。 Naver Datalab の UI より優れている理由： Datalab が表示するのはグラフです。この MCP は、同じトレンドに基づいた、タイトルとハッシュタグを最適化した投稿の下書きを5件、1回の対話で作成します。

2. 「この YouTube Shorts のタイトルは本当に伸びるでしょうか？」

課題： タイトルの CTR は Shorts で最も大きな効果をもたらす要素ですが、公開するまで結果はわかりません。 この MCP の活用方法： 下書きを Claude に貼り付け、「viral-title プロンプトを使って」と伝えます。このプロンプトは optimize_title_hashtags → predict_viral_score → generate_ab_test_variants の順に実行し、S〜D の評価に加えて、構成上の違い（数字の追加、緊急性を示す語句の追加、25文字への短縮）がわかる A/B テスト用バリエーションを5件返します。 感覚頼りの判断より優れている理由： スコアリングでは、韓国語のコピーライターが使うものと同じ6種類のシグナルを読み取ります。感情に訴える語句（충격|실화|숨겨진）、構成要素（数字／角括弧／?／!）、緊急性、社会的証明、実用性を打ち出す表現（방법|꿀팁|노하우）、文字数の範囲を確認し、不足している要素を伝えます。

3. 「韓国の小さなブランドを運営しています。現地の祝日を考慮したコンテンツカレンダーが必要です」

課題： 汎用的なカレンダーツールは 빼빼로데이、김장철、수능、한가위 연휴 を把握していないため、현충일 にキャンペーンを投稿してしまうことがあります。 この MCP の活用方法： Claude が create_content_calendar({ months: 3, niche: 'beauty' }) を呼び出します。100件以上のイベント DB（공휴일 18 + 데이 시리즈 12 + 절기 15 + 상업 이벤트 15 + 시즌/날씨 12 + 입시 10 + 쇼핑 10 + 크리에이터 특화 8）と3か月の期間を照合し、イベントごとのコンテンツテーマを含む日付別の計画を作成します。 Notion のテンプレートより優れている理由： DB は任意の年に合わせて更新されるため（resource://content-genie/korean-events/2027 は @-mention 1回で利用できます）、あなたが更新しなくても、翌年も正確なカレンダーを使えます。

ツール／リソース／プロンプト

名前	種類	機能
get_korean_trends	ツール	Naver／Daum／Google／YouTube／Zum のリアルタイムトレンドを統合し、重複を排除します
analyze_news_trends	ツール	カテゴリー別に分類した韓国のニュース見出しのトレンドを分析します
analyze_seo_keywords	ツール	Naver と Google のオートコンプリート候補を取得し、ロングテールキーワードを展開します
optimize_title_hashtags	ツール	CTR に最適化したタイトルの書き換えと、プラットフォーム別のハッシュタグセットを作成します
generate_hashtag_strategy	ツール	プラットフォーム別（IG／YT／TikTok／Naver）のハッシュタグ構成を、幅と深さに分けて作成します
generate_content_ideas	ツール	トレンド、季節、ニッチをもとにアイデアを生成します
generate_script_outline	ツール	長編スクリプト、またはシーンごとに分けた短編のアウトラインを作成します
repurpose_content	ツール	1つの投稿を複数のプラットフォーム向けに変換します（ブログ → Shorts → Reel → スレッド）
predict_viral_score	ツール	構成、感情、緊急性を理由として、S〜D の評価を予測します
generate_ab_test_variants	ツール	変更する要素をそれぞれ変えた N 個の A/B テスト用タイトル案を作成します
predict_content_performance	ツール	CTR、シェア、保存数をヒューリスティックに推定します
analyze_thumbnail	ツール	サムネイル案を分析し、CTR 最適化のチェックリストを作成します
analyze_competitor_content	ツール	URL から競合の投稿を取得し（SSRF 対策済み）、ギャップを分析します
benchmark_content_performance	ツール	ニッチ／プラットフォーム別の業界ベンチマークを提示します
analyze_influencer_collab	ツール	インフルエンサーとの適合性、オーディエンスの重複を分析し、ブリーフを作成します
create_content_calendar	ツール	韓国のイベント DB と照合した複数月のカレンダーを作成します
get_seasonal_content_guide	ツール	「今後 2 週間で何を投稿すべきか？」をイベントに応じて提案します
resource://content-genie/korean-events/{year}	リソース	任意の年に対応した 100 件以上のイベント DB 全体（JSON）
resource://content-genie/sources	リソース	スクレイパーの稼働状況とキャッシュ状態をリアルタイムで表示し、機能縮退に対応します
prompt://content-genie/viral-title	プロンプト	最適化 → 予測 → A/B 案の作成を、1 つのスラッシュコマンドで実行します
prompt://content-genie/competitor-analysis	プロンプト	URL 取得 → ギャップを埋めるアイデア生成のワークフロー

仕組み

                    Claude (or any MCP client)
                              │
                              ▼
                        McpServer (SDK 1.25)
                              │
                  ┌───────────┼───────────┐
                  ▼           ▼           ▼
              17 tools    Resources    Prompts
                  │
                  ▼
            runScraper()  ◄── core/cache.ts (LRU + 15min TTL)
                  │       ◄── core/circuitBreaker.ts (3-fail → open 5min)
                  ▼
         scrapers/{naver,daum,google,youtube,zum}.ts
                  │
                  ▼
            core/security.ts (SSRF + 30s timeout + 5MiB cap)

重要な設計上の選択は 3 つあります。

1. ソースごとのサーキットブレーカー。 Naver の調子が悪くても、他の 16 個のツールには影響しません。影響するのは Naver を必要とするトレンド系ツールだけで、それらもキャッシュの古いデータを含む status: 'stale' のエンベロープを返すため、LLM はそれに応じて対応できます。
2. スクレイパーは例外をスローしません。 ScrapeResult エンベロープ（ok | stale | unavailable）を返します。エラー処理はすべて 1 か所（runScraper）に集約されるため、新しいソースを追加する場合は「スクレイパーを書き、ScrapeResult を返せば完了」です。
3. イベント DB は読み込み時に年を再設定します。 100 件以上の韓国の祝日／イベント DB は月日ルールとして保存され、必要に応じて任意の年に再設定されます。そのため、…/korean-events/2027 は今すぐ利用できます。

設定

環境変数	デフォルト	用途
MCP_HTTP_MODE	false	stdio の代わりに Streamable HTTP サーバーとして実行する場合は true に設定します
HOST	0.0.0.0	HTTP バインドホスト
PORT	3000	HTTP バインドポート
CONTENT_GENIE_ALLOWED_HOSTS	KR 検索／ソーシャル／コマースの許可リスト	analyze_competitor_content の SSRF 対策で使用する、カンマ区切りのホスト許可リストです。独自の競合ドメインを追加するには、設定を上書きします。

HTTP エンドポイント（MCP_HTTP_MODE=true の場合）：

メソッド	パス	用途
GET	/	サーバー情報
GET	/health	ヘルスチェック（Railway／Docker）
POST	/mcp	MCP JSON-RPC リクエスト（2025-03-26 仕様）
GET	/mcp	サーバー起点のメッセージ用 SSE ストリーム

既知の制限事項

• スクレイパーはHTMLに依存します。 Naver／Daum／Zumは公開トレンドAPIを提供していないため、スクレイパーはHTMLを解析します。マークアップが変更されると、パーサーの修正をリリースするまで、該当するソースは status: 'unavailable' を返します。その間も、サーキットブレーカーによってMCPの残りの機能は動作し続けます。
• バイラルスコアは意味的なものではなく、構造的なものです。 predict_viral_score は韓国語のコピーのパターンをもとにしたヒューリスティックです。投稿の 意味 を読み取ることはできず、タイトルと説明に含まれる構造、感情、緊急性のシグナルのみを判定します。
• サムネイル画像の分析には対応していません。 analyze_thumbnail が扱うのは、アップロードされた画像ではなく、サムネイルのコンセプト説明 です。画像入力はロードマップに含まれています。
• 韓国語を優先しています。 ハッシュタグのテンプレート、緊急性を示す語句、イベントデータベースは韓国語です。英語／日本語モードはv2.xの対象外です。

このツールを使用すべきでない場合

• グローバルトレンドのダッシュボードが必要な場合は、Google Trendsを直接使用してください。content-genieは韓国のクリエイター向けツール群に特化しています。
• 検索ボリューム付きの有料キーワードデータ（네이버 검색광고 API、Ahrefs、SEMrush）が必要な場合は、それらを使用してください。content-genieのSEOツールは、無料のオートコンプリートとヒューリスティックなロングテールキーワードの拡張に依存しています。
• コンプライアンス上の理由から、LLMを使わない決定論的なコピー生成が必要な場合は、このMCPを使用しないでください。このMCPはLLMに入力を渡し、実際のタイトルを作成するのはLLMです。

比較

	content-genie-mcp	自分で行う生スクレイピング	Naver Datalab UI	SmartEditor／네이버 검색광고 API
複数ソースの統合（韓国の5つのソース）	あり	自前で実装	Naverのみ	Naverのみ
韓国のイベントデータベースを内蔵	100件以上のイベント	なし	なし	なし
サーキットブレーカー＋キャッシュ	あり	自前で実装	該当なし	該当なし
バイラルスコアのヒューリスティック	あり	なし	なし	なし
MCPネイティブ（Claudeの@-mentionイベント）	あり	なし	なし	なし
コスト	無料（npm）	開発時間	無料	無料枠を超えると有料

ロードマップ

• ソースの追加。 Tistoryリアルタイム、Brunchのピックアップ、Kakao Viewを追加する予定です。現在は5つのソースで、8つを目指しています。
• 画像入力によるサムネイル分析。 アップロードされたサムネイルを受け入れ、ビジョンベースのCTRスコアリングを実行します。
• トレンドのキャッシュリソース。 resource://content-genie/trends/{platform}/latest を公開し、ツール呼び出しを使わずにLLMが最後のスクレイピング結果を@-mentionできるようにします。
• 動画スクリプトからキャプション／字幕を生成。 generate_script_outline とキャプションフォーマッターを組み合わせ、Shortsへのアップロードに対応します。
• Naver 검색광고 APIとの統合（オプトイン）。 ユーザーがAPIキーを指定すると、SEOツールをオートコンプリートのヒューリスティックから実際の検索ボリュームに切り替えます。

貢献

PRを歓迎します。Phase 4のリファクタリングにより、コードベースは貢献しやすくなりました。ツールの追加は単一ファイルの変更で済みます。下記のContributingセクションを参照するか、大きな変更について相談したい場合は、まずissueを作成してください。CIでは、すべてのPRに対してNode 22と24でtypecheck + test + buildを実行します。

コントリビューター向けの簡単な手順：

git clone https://github.com/MUSE-CODE-SPACE/content-genie-mcp
cd content-genie-mcp
npm install
npm run typecheck && npm test && npm run build

セキュリティ

このMCPはサードパーティのURLを取得し、LLMによって生成された入力を受け取ります。脅威モデル、SSRFホスト許可リスト、30秒のフェッチタイムアウトと5 MiBのボディ上限、およびCONTENT_GENIE_ALLOWED_HOSTSによる上書きについては、SECURITY.mdに記載されています。脆弱性は、GitHub Security Advisory（https://github.com/MUSE-CODE-SPACE/content-genie-mcp/security/advisories/new）から非公開で報告してください。

ライセンス

MIT — SPDX識別子はpackage.jsonで宣言されています（トップレベルのLICENSEファイルは次回リリースで追加されます）。

メンテナー

@yoon-k（MUSE-CODE-SPACE）。サポートが必要な場合は、issueを作成してください：https://github.com/MUSE-CODE-SPACE/content-genie-mcp/issues。

---

한국어 요약

content-genie-mcp는 한국 콘텐츠 크리에이터를 위한 MCP 서버입니다. 네이버 / 다음 / 구글 / 유튜브 / 줌 5개 소스의 실시간 트렌드를 한 번에 합쳐 보여주고, 100+ 한국 기념일/이벤트 DB(공휴일 18, 데이 시리즈 12, 절기 15, 상업 이벤트 15, 시즌/날씨 12, 입시 10, 쇼핑 10, 크리에이터 특화 8)와 바이럴 점수 예측기(S~D 등급, 한국어 카피 패턴 기반)를 함께 제공합니다.

v2.12.0(2026-05-20)에서 17개 도구가 도메인별로 모듈화되었고, 스크래퍼별 회로 차단기 + LRU 캐시 + stale fallback 으로 한 소스가 망가져도 나머지가 정상 동작합니다. @-mention 가능한 MCP Resources 2개와 슬래시 명령용 Prompts 2개도 추가되었습니다.

설치 (Claude Code):

claude mcp add content-genie -- npx -y content-genie-mcp

첫 호출 예시:

오늘 한국에서 뜨는 키워드 5개로 유튜브 쇼츠 제목 후보 3개씩 만들고, 각각 바이럴 점수 등급 매겨줘.

자세한 내용은 영문 섹션, 변경 이력은 CHANGELOG.md, 위협 모델은 SECURITY.md를 참고하세요.