YouTube MCP Server

Claude Code に YouTube を統合する MCP サーバー — 動画のトランスクリプト、検索、メタデータ、チャンネル情報、プレイリスト、コメント、急上昇動画、エンゲージメント分析、チャプター抽出、SponsorBlock 統合、Most Replayed ヒートマップを提供します。YouTube Data API v3、youtube-transcript、SponsorBlock を使用しています。

クイックスタート

ステップ 1: API キーを取得

1. Google Cloud Console に移動

2. プロジェクトを作成（既存のものを選択も可）

3. YouTube Data API v3 を有効化:

   • API ライブラリ に移動

   • 有効化 をクリーク

4. API キーを作成:

   • 認証情報 に移動

   • 認証情報を作成 > API キー をクリーク

5. キーをコピー（スてップ3 で必要になります）

ステップ 2: 前提条件をインストール

• Node.js 18+ - こちらからダウンロード

• Claude Code CLI - インストールガイド

ステップ 3: MCP サーバーをインストール

3.1 リポジトリをクローン

git clone https://github.com/wynandw87/claude-code-youtube-mcp.git
cd claude-code-youtube-mcp

3.2 依存関係をインストール

macOS / Linux / Windows:

npm install

注: 依存関係のインストールとサーバーのビルドは、1つのスてップで自動的に行われます。

3.3 Claude Code に登録

インストールスコープを選択:

YOUR_API_KEY を実際の YouTube Data API キーに置き換え、dist/index.js への完全パスを使用してく ださい。

ヒント: 完全パスを取得するには、クローンしたデイレクトリから次を実行:

• macOS/Linux: echo "$( pwd)/dist/index.js"

• Windows: echo %cd%\dist\index.js

macOS / Linux:

claude mcp add -s user youtube -e YOUTUBE_API_KEY=YOUR_API_KEY -- node /full/path/to/dist/index.js

Windows (CMD):

claude mcp add -s user youtube -e "YOUTUBE_API_KEY=YOUR_API_KEY" -- node "C:\full\path\to\dist\index.js"

Windows (PowerShell):

claude mcp add -s user youtube -e "YOUTUBE_API_KEY=YOUR_API_KEY" '--' node "C:\full\path\to\dist\index.js"

代替: npm ヘルパーを使用する（API キーが環環境変数に設定されている場合）

export YOUTUBE_API_KEY=YOUR_API_KEY
npm run install:claude

ステップ 4: Claude Code を再起動

変更を反映するには、Claude Code を閉じて再度開いてく ださい。

ステップ 5: インストールを確認

claude mcp list

接続済みステータスで youtube が一覧に表示されるはずです。

Related MCP server: youtube-mcp

機能

トランスクリプトとキャプション

• Get Transcript (get_transcript) - タイムスタンプ付きの完全な動画トランスクリプトを取得します。複数の言語に対応。

• Search Transcript (search_transcript) - キーワードやフレーズが動画のどの位置に出てくるかをタイムスタンプ付きで検索します。

• Clean Transcript (get_clean_transcript) - SponsorBlock によりスポンサーの読み上げ、イントロ、アウトロ、フィラーを除いたトランスクリプトを取得します。

• Extract Chapters (extract_chapters) - 動画の説明文からチヤプターのタイムスタンプを抽出します。

検索と発見

• Search Videos (search_videos) - 日付、長さ、タイプ、並び替え順のフィルター付きの完全な YouTube 検索。

• Search Within Channel (search_within_channel) - 特定のクリエイターの動画を検索します。

• Get Trending Videos (get_trending_videos) - 地域とカテゴリ別の現在の急上昇動画。

• Get Channel Videos (get_channel_videos) - チャンネルの最近のアップロード動画を、日付または再生回数順に取得します。

動画とチャンネル情報

• Video Metadata (get_video_metadata) - タイトル、説明、再生時間、再生回数、高評価数、タグなど。

• Channel Info (get_channel_info) - 登録者数、動画本数、説明、国。

• Playlist Items (get_playlist_items) - プレイリスと内の全動画を、位置とメタデータ付きで取得します。

分析とエンゲージメント

• Calculate Engagement (calculate_engagement) - 公開データから高評価率、コメント率、エンゲージメント率を計算します。

• Most Replayed (get_most_replayed) - 視聴者が最も見直す部分を示すヒートマップデータを取得します。

• Video Comments (get_video_comments) - 高評価数と返信数付きのトップコメントを取得します。

ユーティリティ

• Parse YouTube URL (parse_youtube_url) - あらゆる YouTube URL 形式から動画/チャンネル/プレイリスと ID を抽出します。

使用方法

インストール後、トリガー文句を使って YouTube ツールを呼び出します:

または、自然に質問することもできます:

• "この YouTube 動画のトランスクリプトを取得して要約して"

• "この動画の最も見直されている部分はどこ？"

• "このチャンネルで TypeScript に関する最近の動画を探して"

• "この動画の再生回数と高評価数は？"

• "この動画のコメントを取得して感情を要約して"

• "このチュートリアルのチャプターを表示して"

• "スポンサーの読み上げなしのクリーンなトランスクリプトを取得して"

• "今、YouTube のゲームで急上昇しているのは？"

ツールリファレンス

parse_youtube_url

あらゆる YouTube URL 形式を解析し、ID を抽出します。API キーは不要です。

パラメーター:

• url (string,必須) - YouTube の URL または動画 ID

対応形式: youtube.com/watch?v=, youtu.be/, /shorts/, /embed/, /playlist?list=, /channel/, /@handle, /c/, /user/, 動画 ID 単体

get_transcript

YouTube 動画の完全なトランスクリプト/キャプションを取得します。API キーは不要です。

パラメーター:

• url (string,必須) - YouTube 動画の URL または動画 ID

• lang (string,任意) - キャプションの言語コード (デフォルト: "en")

search_transcript

動画のトランスクリプト内でキーワードやフレーズを検索します。

パラメーター:

• url (string,必須) - YouTube 動画の URL または動画 ID

• query (string,必須) - 検索するキーワードまたはフレーズ

• lang (string,任意) - キャプションの言語コード (デフォルト: "en")

extract_chapters

動画の説明文からチヤプターのタイムスタンプを抽出します。

パラメーター:

• url (string,必須) - YouTube 動画の URL または動画 ID

get_clean_transcript

SponsorBlock によりスポンサーの読み上げ、イントロ、アウトロ、フィラーを除いたトランスクリプトを取得します。

パラメーター:

• url (string,必須) - YouTube 動画の URL または動画 ID

• lang (string,任意) - キヤプションの言語コード (デフォルト: "en")

get_most_replayed

視聴者が最も見直す部分を示す "Most Replayed" ヒートマップデータを取得します。

パラメーター:

• url (string,必須) - YouTube 動画の URL または動画 ID

注: ヒートマップデータを利用するには、約50K+ の再生回数が必要です。

search_videos

フィルター完全対応の YouTube 検索を実行します。

パラメーター:

• query (string,必須) - 検索クエリ

• max_results (number,任意) - 結果数、1-50 (デフォルト: 10)

• order (string,任意) - "relevance", "date", "viewCount", "rating" (デフォルト: "relevance")

• duration (string,任意) - "short" (4分未満), "medium" (4-20分), "long" (20分超)

• upload_date (string,任意) - "hour", "day", "week", "month", "year"

• type (string,任意) - "video", "channel", "playlist" (デフォルト: "video")

get_video_metadata

YouTube 動画の詳細なメタデータを取得します。

パラメーター:

• url (string,必須) - YouTube 動画の URL または動画 ID

戻り値: タイトル、説明、チャンネル、再生時間、再生回数/高評価数/コメント数、タグ、カテゴリ、サムネイル、ライブ配信状態など。

get_channel_info

YouTube チャンネルの情報を取得します。

パラメーター:

• url (string,必須) - YouTube チャンネルの URL、@handle、またはチャンネル ID

戻り値: タイトル、説明、登録者数/動画本数/再生回数、国、カスタム URL、サムネイル。

get_playlist_items

YouTube プレイリスと内の全動画を取得します。

パラメーター:

• url (string,必須) - YouTube プレイリスとの URL またはプレイリスと ID

• max_results (number,任意) - 項目数、1-50 (デフォルト: 25)

get_channel_videos

YouTube チャンネルの最近の動画を取得します。

パラメーター:

• url (string,必須) - YouTube チャンネルの URL、@handle、またはチャンネル ID

• max_results (number,任意) - 動画数、1-50 (デフォルト: 25)

• order (string,任意) - "date", "viewCount" (デフォルト: "date")

get_trending_videos

現在の急上昇/人気の YouTube 動画を取得します。

パラメーター:

• region_code (string,任意) - ISO 3166-1 alpha-2 国コード (デフォルト: "US")

• category_id (string,任意) - YouTube カテゴリ ID (例: "10" は音楽、"20" はゲーム、"28" は科学/テクノロジー)

• max_results (number,任意) - 結果数、1-50 (デフォルト: 10)

search_within_channel

特定の YouTube チャンネル内で動画を検索します。

パラメーター:

• url (string,必須) - YouTube チャンネルの URL、@handle、またはチャンネル ID

• query (string,必須) - 検索クエリ

• max_results (number,任意) - 結果数、1-50 (デフォルト: 10)

get_video_comments

YouTube 動画のトップレベルのコメントを取得します。

パラメーター:

• url (string,必須) - YouTube 動画の URL または動画 ID

• max_results (number,任意) - コメント数、1-100 (デフォルト: 20)

• order (string,任意) - "relevance", "time" (デフォルト: "relevance")

calculate_engagement

YouTube 動画のエンゲージメント指標を計算します。

パラメーター:

• url (string,必須) - YouTube 動画の URL または動画 ID

戻り値: 再生回数、高評価数、コメント数、高評価率、コメント率、および総合エンゲージメント率。

動作の仕組み

この MCP サーバーは stdio トランスポートを介して Claude Code に接続し、15 個のツールを提供します:

注意: API キーがなくても動作するツールは 5 つあります（トランスクリプト、SponsorBlock、ヒートマップ、URL 解析）。残りの 10 ツールは YouTube Data API v3 キーが必要です。

設定

環境変数

YouTube API クォータ

YouTube Data API v3 には 1 日あたり 10,000 ユニット のクォータがあります。ツールによって使用量は異なります:

ヒント: 検索操作は最もコストが高くつきます。最新のアップロードだけが必要な場合は、search_within_chanel（100 ユニット）ではなく get_chanel_videos（1 ユニット）を使用してください。

トラブルシューティング

APIキーの修正

API キーを間違って入力した場合は、削除して再インストールしてください:

claude mcp remove youtube

その後、上記 Step 3.3 のコマンドを使用して再インストールしてください（最初にインストールしたときと同じスコープを使用します）。

MCPサーバーが表示されない

サーバーがインストールされているか確認してください:

claude mcp list

一覧にない場合は、Step 3 に従ってインストールしてください。

サーバーが起動しない

1. API キーが有効であることを Google Cloud Console で確認してください

2. YouTube Data API が有効になっていることを確認してください:

   • API Library に移動する

   • 「Enabled」と表示されているはずです

3. Node.js のバージョンを確認してください（18 以降が必要）:

   node --version

4. サーバーがビルドされていることを確認してください — dist/index.js がない場合は npm install を再実行してください

接続エラー

1. dist/index.js が存在することを確認してください — ない場合は npm install を実行してください

2. claude mcp add コマンドのパスが絶対パスであることを確認してください

3. 設定変更後は Claude Code を再起動してください

クォータ超過

「quotaExceeded」エラーが表示される場合:

• 太平洋時間の午前0時まで待つ（クォータは毎日リセットされます）

• 別の API キーを使用する

• 検索ツール（100 ユニット）ではなく低コストのツール（get_video_metadata は 1 ユニット）を優先する

トランスクリプトを取得できない

一部のビデオではトランスクリプトが無効になっています。get_transcript ツールは明確なエラーメッセージを返します。以下を試してください:

• 別の言語コード（例: lang: "es"）

• 手動のキャプションがない場合同でも、自動生成されたキャプションが利用できる場合同があります

タイムアウトエラー

接続が遅い場合同は、YOUTUBE_TIMEOUT 環境変数を増やしてください:

claude mcp add -s user youtube -e YOUTUBE_API_KEY=YOUR_KEY -e YOUTUBE_TIMEOUT=60000 -- node /path/to/dist/index.js

現在の設定を確認する

claude mcp list

コントリビューション

Pull request 歓迎します！シンプルで初心者に優しいものをお願いします。

ライセンス

MIT

Claude Code コミュニティのために作られました