youtube-mcp

@ザビエル-zav のYouTubeチャンネル分析を、Claudeから直接できるようにするMCPサーバー。 「先週の動画、どれが一番CTR良かった?」のような質問に、実データを取ってきて答えられる状態を目指す。

Node.js製(Python不使用)。YouTube Analytics API / Reporting API / Data API v3 を 公式のNode用ライブラリ(googleapis, google-auth-library)でラップし、 MCP公式のTypeScript SDK(@modelcontextprotocol/sdk)でツールとして公開している。

使うAPIと使い分け

CTRだけ取得方式が根本的に違う(バルクレポート)ため、register-reach-job.js で ジョブ登録 → download-reports.js で定期的にローカルへCSVを蓄積、という別経路になっている。

Related MCP server: YouTube MCP Server

セットアップ

1. Google Cloud Console

1. プロジェクトを作成

2. 以下3つのAPIを有効化

   • YouTube Analytics API

   • YouTube Reporting API

   • YouTube Data API v3

3. OAuth同意画面を設定(ユーザーの種類=外部、テストユーザーに自分のGoogleアカウントを追加)

4. 認証情報 > OAuthクライアントID > アプリの種類=デスクトップアプリ を作成し、JSONをダウンロード

5. ダウンロードしたJSONを client_secret.json という名前でこのリポジトリ直下に置く

   client_secret.json と、初回認証後に作られる token.json は絶対にコミットしないこと。 .gitignore 済みだが、誤って git add -f しないよう注意。

2. Node.jsと依存パッケージ

Node.js 18以上が必要(未インストールなら nodejs.org からLTS版を入れる。 インストーラーに npm も含まれるので、Pythonのような別途PATH設定は基本不要)。

npm install

3. リーチレポート(CTR)のジョブ登録 — 最優先で実行

Reporting API は「ジョブを登録した日」からデータ生成が始まり、過去分も登録時点から 30日前までしか遡れない。登録が遅れるほど過去のCTRデータが失われるので、 他の作業より先にこれだけ実行しておく。

npm run register-reach-job

初回はブラウザが開いて認証を求められる(以降は token.json で自動更新)。

4. MCPサーバー起動

npm start

Claude Desktop から使う場合は claude_desktop_config.json に以下のように登録する。

{
  "mcpServers": {
    "youtube-analytics": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/server.js"]
    }
  }
}

5. リーチレポートのダウンロード(登録から数時間〜2日後)

npm run download-reports

data/reach/<report_type>/ 配下にCSVが蓄積される。レポートはYouTube側で60日 (過去データ分は30日)で消えるため、定期的に(できれば1日1回)実行し続けること。 Windowsならタスクスケジューラ、Mac/Linuxならcronに登録しておくとよい。 get_reach ツールはこのローカルCSVを読む。

公開ツール一覧

出力は生JSONではなく、丸めた数値・上限20件程度のテキスト表で返す (Claude側のコンテキスト消費を抑えるため)。

既知の制約

• Analytics APIのデータは YouTube Studio 表示より最大2日程度のラグがある。「昨日の数字」は取れないことがある。

• get_reach はローカルにダウンロード済みのCSVしか見ない。download-reports.js を実行していない期間のデータは出てこない。

• channel_reach_basic_a1 / channel_reach_combined_a1 の正確な列構成は未確認。get_reach は列名をキーワードで推測して読むフォールバックにしてあるが、実際にダウンロードしたCSVのヘッダーで一度確認すること。

• 書き込み系スコープは付けていない(読み取り専用)。動画を誤って変更・削除する経路は存在しない。

デプロイ先の分岐

スマホからも使いたい場合は、StdioServerTransport を StreamableHTTPServerTransport (@modelcontextprotocol/sdk/server/streamableHttp.js)に切り替えて、 既存のホスティング環境に相乗りするのが早い。