youtube-organic-mcp

youtube-organic-mcp

YouTube オーガニック分析向けの MCP サーバーです。YouTube Data API v3 と YouTube Analytics API v2 を通じて、チャンネルの統計情報、動画のパフォーマンス、総再生時間、視聴者のエンゲージメントを取得します。

Claude Code および MCP 互換のあらゆる AI ツール向けに構築されています。AI アシスタントから、自分のチャンネルのオーガニックデータ（登録者数、再生回数、総再生時間、動画ごとのエンゲージメント、日別の傾向）に読み取り専用で直接アクセスできます。

Rex Jones が提供する The SEO Engine ツールキットの一部です。代理店や企業向けの AI 搭載 SEO およびソーシャルメディアツールです。

このプロジェクトを作った理由

• 優れたオープンソースの YouTube オーガニック分析 MCP がありませんでした。 広告向け MCP は豊富にありますが、オーガニックなチャンネル分析向けのものはありませんでした。
• YouTube は主要プラットフォームの中で最も充実したオーガニック API を備えています。 総再生時間、平均視聴時間、獲得・離脱した登録者数、トラフィックソースなどのデータを、数週間にわたる審査なしで利用できます。
• 既存の Google OAuth を再利用できます。 GA4／GSC／Google Ads の MCP をすでに利用している場合、同じ OAuth クライアントをここでも使えます。

ツール

ツール	説明
list_accounts	設定済みのチャンネルとデフォルトを一覧表示します
get_channel_info	チャンネルのプロフィールと全期間の統計情報（登録者数、総再生回数、動画数、アップロード用再生リスト）を取得します
get_videos	動画ごとの再生回数、高評価数、コメント数、再生時間を含むアップロード動画をページ分割して取得します
get_video_details	指定した動画 ID の詳細を取得します（最大 50 件を一括処理）
get_channel_analytics	期間を指定してチャンネル分析データを取得します。再生回数、総再生時間、平均視聴時間／率、獲得・離脱した登録者数、高評価数、コメント数、共有数が含まれます。日別の集計も指定できます
get_video_analytics	期間を指定して、単一の動画について同じ指標を取得します

すべてのツールで、複数アカウントの設定に使える任意の account パラメーターを指定できます。

接続方法

ステップ 1：API を有効にする

Google Cloud Console で（既存のプロジェクトを再利用できます）、YouTube Data API v3 と YouTube Analytics API を有効にします。

ステップ 2：更新トークンを取得する

デスクトップアプリタイプの OAuth クライアントを作成し、client_secret JSON をダウンロードします。次に、ヘルパーを実行します（pip install google-auth-oauthlib が必要です）。

python3 scripts/get_youtube_token.py /path/to/client_secret.json my-channel

チャンネルを所有する Google アカウントで認証します（プロンプトが表示された場合はブランド アカウントを選択してください）。設定に追加する 3 つの YOUTUBE_* 値が表示され、.youtube_account.json（Git で無視されます）に書き込まれます。

ステップ 3：設定する

Claude Code の MCP 設定に追加します。

{
  "mcpServers": {
    "youtube-organic": {
      "command": "node",
      "args": ["/path/to/youtube-organic-mcp/dist/index.js"],
      "env": {
        "YOUTUBE_CLIENT_ID": "your_client_id.apps.googleusercontent.com",
        "YOUTUBE_CLIENT_SECRET": "your_client_secret",
        "YOUTUBE_REFRESH_TOKEN": "1//your_refresh_token"
      }
    }
  }
}

複数のチャンネルを設定するには、YOUTUBE_ACCOUNTS に JSON 配列を指定します（.env.example を参照）。

アーキテクチャ

src/
  index.ts          # MCP server entry point, tool registration
  accounts.ts       # Multi-account resolution (client_id/secret/refresh_token)
  client.ts         # OAuth token minting + Data/Analytics API HTTP client
  types.ts          # TypeScript interfaces for API responses
  tools/
    channel.ts      # get_channel_info + uploads-playlist resolver
    videos.ts       # get_videos, get_video_details
    analytics.ts    # get_channel_analytics, get_video_analytics

• 外部 HTTP 依存関係はありません — ネイティブの fetch を使用します（Node 18 以降）
• 認証を自動更新 — 更新トークンからアクセストークンを発行し、プロセスごとにキャッシュします
• 複数アカウントに対応 — 1 つのサーバーから複数のチャンネルを監視できます

ライセンス

MIT