YouTube Transcript & Search MCP Server

YouTube Transcript & Search MCP サーバー

AI エージェントに YouTube を読ませましょう。
5 種類の形式の文字起こし、ネイティブな動画・チャンネル検索、チャンネル・再生リストの一覧表示、 一度に最大 4,000 件の文字起こしを取得できるバックグラウンドジョブを提供します。1 つのホスト型 エンドポイントで 14 個のツールを利用できます。お使いのマシン上で実行されるものはありません。

理由 · クイックスタート · ツール · インストール · レシピ · 料金 · エラー

🎬 理由

エージェントを使う人なら、誰もが一度はこんなやり取りを経験しています。

You:   Summarize this. https://www.youtube.com/watch?v=kCc8FmEb1nY
Agent: I'm not able to watch videos. If you paste the transcript here, I'll gladly help!

エージェントが自力では取得できないものこそ、まさに文字起こしです。このサーバーを 接続すれば、同じ依頼にもすぐに対応できます。

You:   Summarize this. https://www.youtube.com/watch?v=kCc8FmEb1nY
Agent: → get_transcript(video="kCc8FmEb1nY", video_metadata=true)      1 credit

       That's "Let's build GPT: from scratch, in code, spelled out" by Andrej
       Karpathy, 1:56:20. He starts from an empty file and a bigram model,
       derives self-attention step by step, and ends with a working GPT that...

1 本の動画を読むだけで作業が終わることは、ほとんどありません。YouTube のデータを エージェントに取り込む 3 つの方法を実際に比較してみましょう。

⚡ クイックスタート

1. API キーを取得します。 transcriptout.com でアカウントを作成し、 ダッシュボードでキーを作成します。新規アカウントには100クレジットが無料で付与され、 カードの登録は不要です。キーは sk_ で始まり、一度だけ表示されます。

2. クライアントの接続先をサーバーに設定します。 ストリーミング可能な HTTP で通信し、 1つの Bearer ヘッダーで認証します。

{
  "mcpServers": {
    "transcriptout": {
      "url": "https://api.transcriptout.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

このページの上部には Cursor と VS Code 用のワンクリックボタンがあります。それ以外の クライアント用の正確な設定例は、クライアントへのインストールに記載されています。

3. リンクを貼り付けます。

Summarize this talk and pull the three strongest quotes.
https://www.youtube.com/watch?v=dQw4w9WgXcQ

エージェントは自動で get_transcript を選択し、タイムコード付きのテキストを読み取って、それをもとに回答します。すべての レスポンスには X-Credits-Remaining ヘッダーが含まれるため、セッション中は常に残りのクレジットを確認できます。

🧰 14個のツール

接続すると、14個すべてのツールが自動的に公開されます。ほとんどの呼び出しのコストは1クレジットです。 YouTube に到達する前に呼び出しが失敗した場合（検証エラー、レート制限、当サービス側の容量不足）は、クレジットが自動的に返金されます。そのため、失敗ではなく回答に対して課金されます。「この動画には字幕がありません」という確定的な結果は回答として扱われ、通常どおり課金されます。

1. get_transcript · 1クレジット

任意の YouTube 動画のトランスクリプトを取得します。format=text（デフォルト）では、モデルが処理しやすい、読みやすいプレーンテキストが返されます。format=json ではタイムコード付きのセグメントが返されます。

segment を省略すると、自動生成トラックは約180文字のセグメントに分割され、手動トラックは作成者が区切ったとおりに返されます。トラックの種類にかかわらずサイズを統一したい場合は、値を指定してください。

出力例（format=json）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "kind": "manual",
  "transcript": [
    { "text": "Never gonna give you up", "start": 18.0, "duration": 4.12 },
    { "text": "Never gonna let you down", "start": 22.12, "duration": 3.85 }
  ]
}

srt と vtt は字幕ファイルの本文全体が返されるため、エージェントがそのままディスクに書き込めます。 srv3 はソースの生 XML であり、segment と併用できません。

2. get_video_info · 1クレジット

1本の動画のメタデータ（タイトル、チャンネル、再生時間、再生回数、サムネイル）と、利用可能な トランスクリプト言語の一覧を取得します。字幕のダウンロードは行いません。

クレジット節約のヒント： トランスクリプトも取得する場合は、代わりに video_metadata=true を指定して get_transcript を呼び出してください。2回の呼び出しが必要な情報を、1クレジットでまとめて取得できます。

3. search_youtube · 1 クレジット／ページ

YouTube で動画やチャンネルを検索します。next_page_token を使ってページネーションできます。has_more は次のページがあるかどうかを示します。

4. list_channel_videos · 1 クレジット／ページ

チャンネルの「動画」タブから、動画を新しい順に一覧表示します。@handle、チャンネル名、UC... チャンネル ID、またはチャンネル URL を指定できます。

ids_only=true は、submit_transcripts_job に渡す際のコストを抑える方法です。

5. search_channel_videos · 1 クレジット／ページ

YouTube の標準の関連性検索を使って、1 つのチャンネル内を検索します。タイトルにクエリの単語が含まれない結果が出ることもあります。結果は部分文字列ではなく、関連性に基づいてランク付けされます。

6. latest_channel_videos · 1 クレジット

チャンネルの RSS フィードから、最新の約 15 件の動画を取得します。チャンネルが最近公開した動画を確認する最も速く、最も低コストな方法です。

7. list_playlist_videos · 1 クレジット／ページ

プレイリスト内のすべての動画を、プレイリストの順序で表示します。PL... プレイリスト ID、または list= を含む URL を指定できます。

8. search_playlist_videos · 1 クレジット

タイトルの部分文字列でプレイリスト内の動画を検索します（大文字と小文字は区別されません）。YouTube にはプレイリストを検索する標準機能がないため、最大 500 件のプレイリスト項目をスキャンします。truncated=true は、スキャンした範囲の外にも一致する項目がある可能性を示します。

9. submit_transcripts_job · 動画1本につき1クレジット

多数の動画（最大4,000本）の文字起こしを一括でキューに登録し、すぐにjob_idを取得できます。作業はバックグラウンドで続行され、レート制限に応じたペースで処理されます。数本を超える動画に対してget_transcriptを繰り返し呼び出す代わりに、こちらを使用してください。

ユーザーキー（sk_...）が必要です。クレジットは送信時に請求され、こちらの過失により動画を配信できなかった場合は、動画ごとに返金されます。

10. get_transcripts_job · 無料

一括ジョブの進捗を確認できます。ステータス（queued／running／done／cancelled）、準備完了、失敗、処理待ちの動画数が表示されます。すでに料金を支払ったジョブのポーリングは無料です。

11. get_transcripts_results · 無料

一括ジョブで完了した文字起こしを、送信した順に取得できます。next_page_tokenを使ってページ分割されます（limitは1～500、デフォルトは100）。結果は取得され次第表示されるため、ジョブの完了前でも読み取れます。各エントリーは、その動画に対してget_transcriptが返す内容にステータスを加えたものです。

12. get_transcripts_result · 無料

一括ジョブの結果から、動画IDを指定して1本分の結果を取得できます。結果全体をページ分割して確認する必要はありません。404は、ジョブが存在しないか、この動画の処理がまだ完了していないことを示します。そのため、何かを結論づける前にget_transcripts_jobを確認してください。

13. cancel_transcripts_job · 無料

一括ジョブをキャンセルします。クレジットが返金されるのは、まだ処理が開始されていない動画分のみです。すでに取得済みの結果は残り、その分の料金も発生します。

14. get_credits · 無料

パラメーターなしで、キーの残りクレジット残高を取得できます。残高はすべてのレスポンスのX-Credits-Remainingヘッダーにも含まれますが、ヘッダーはモデルから見えないため、ユーザーが実際に残高を尋ねた場合はツールが必要です。一括処理の送信時には動画1本につき1クレジットが請求されるため、大量の一括処理の直前にも便利です。

🔌 クライアントにインストールする

サーバーはリモートなので、以下のインストールはいずれも設定を追加するだけです。どの方法でも、クイックスタートに記載されている URL と Bearer ヘッダーの 2 つが必要です。

一度設定すれば、クライアントで常に有効なルールになります

クライアントのルール／指示にこれを追加しておけば、YouTube のリンクを貼るだけで十分です。「transcript」と入力する必要はありません。

Whenever a YouTube link or video ID appears in my message, call the
transcriptout get_transcript tool first and answer from the transcript,
whether I asked for a summary, a quote, a translation or a question.

{
  "mcpServers": {
    "transcriptout": {
      "url": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

claude mcp add --transport http transcriptout https://api.transcriptout.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

"mcp.servers": {
  "transcriptout": {
    "type": "http",
    "url": "https://api.transcriptout.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

{
  "mcpServers": {
    "transcriptout": {
      "serverUrl": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcriptout": {
      "url": "https://api.transcriptout.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "context_servers": {
    "transcriptout": {
      "source": "remote",
      "url": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcriptout": {
      "type": "streamable-http",
      "url": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

amp mcp add transcriptout https://api.transcriptout.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

"augment.advanced": {
  "mcpServers": [
    {
      "name": "transcriptout",
      "url": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  ]
}

{
  "mcpServers": {
    "transcriptout": {
      "type": "streamable-http",
      "url": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcriptout": {
      "url": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcriptout": {
      "httpUrl": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcriptout": {
      "httpUrl": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcriptout": {
      "serverUrl": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcriptout": {
      "url": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcriptout": {
      "url": "https://api.transcriptout.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "transcriptout": {
    "url": "https://api.transcriptout.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

{
  "url": "https://api.transcriptout.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

🧩 エージェントプラグインとしてインストール

このリポジトリのルートは、ChatGPT、Codex、Cursor、GitHub Copilot、Kiro、VS Code がサポートするポータブル形式である、準拠 Agent Plugins 1.0.0 パッケージです。インストールするだけで、MCP サーバーと、各ツールをいつ使うべきか、クレジットを無駄にしない方法をエージェントに教える youtube スキルをまとめて利用できます。

plugin.json                # manifest
mcp.json                   # hosted MCP server, streamable-http
skills/youtube/SKILL.md    # when + how to use the 14 tools

VS Code。 コマンドパレット → Chat: Install Plugin From Source を選び、次の内容を貼り付けます。

https://github.com/artemchuikin/youtube-mcp

または、settings.json にローカルクローンを登録します。

"chat.pluginLocations": { "/absolute/path/to/youtube-mcp": true }

Cursor。 サイドバーの Customize → プラグインを探す → Install を選びます。ローカルクローンの場合：

git clone https://github.com/artemchuikin/youtube-mcp ~/.cursor/plugins/local/transcriptout

続いて Developer: Reload Window を選びます。

ChatGPT、Codex、GitHub Copilot、Kiro、その他のクライアント。 クライアントのプラグイン機能をこのリポジトリまたはローカルクローンに指定します。Agent Plugins 1.0.0 が標準化するのはパッケージ形式であり、インストール方法ではないため、インストールの流れは各クライアントによって異なります。

このパッケージに認証情報は含まれていません。Agent Plugins 1.0.0 では、シークレットの埋め込みが禁止されています。サーバーは、クライアントの MCP 設定に追加する API キーで認証します（キーとセキュリティを参照）。パッケージを自分で検証するには：

curl -sO https://agent-plugins.org/schemas/1.0.0/plugin.schema.json
curl -sO https://agent-plugins.org/schemas/1.0.0/mcp.schema.json
npx ajv-cli@5 validate --spec=draft2020 -s plugin.schema.json -d plugin.json
npx ajv-cli@5 validate --spec=draft2020 -s mcp.schema.json    -d mcp.json

🔑 キーとセキュリティ

• キーが表示されるのは作成時の一度だけです。環境変数に保存し、バージョン管理の対象外にしてください。
• キーが漏えいしても、ダッシュボードで無効化すれば、その時点で使えなくなります。 1つのアカウントで最大20個のキーを保持できるため、マシンごとに個別のキーを用意してください。
• チャット内で完結させたい場合は、付属の youtube-skillsをインストールしたエージェントが、ブラウザーを使わずに、メールアドレスと6桁のコードでアカウントを開いてキーを発行できます。
• OAuth フローはまだないため、カスタムヘッダーを送信できないコネクターを持つクライアント（Claude Desktop、Claude Web）は、現時点では Claude Code を経由してください。

🐳 ローカルで実行

ホストされたエンドポイントはインストール不要ですが、stdio のみをサポートするクライアント、サンドボックス、コンテナプラットフォームでは、独自のプロセスが必要になることがあります。このリポジトリには、そのための server.js が含まれています。これは完全なローカル MCP サーバー（公式 SDK、stdio トランスポート）で、14個のツールそれぞれが TranscriptOut REST API をHTTPSで1回呼び出します。SaaSをバックエンドとする一般的なMCPサーバーと同じ構成です。

# as a container
docker build -t transcriptout-mcp https://github.com/artemchuikin/youtube-mcp.git
docker run -i -e TRANSCRIPTOUT_API_KEY=sk_your_key transcriptout-mcp

# or straight from a checkout (Node 20+)
npm install && TRANSCRIPTOUT_API_KEY=sk_your_key node server.js

キーがなくても接続してすべてのツールを一覧表示できます。ツールを呼び出すと、キーの入手先を明示した分かりやすい401エラーが返されます。ツール定義は tools.json に格納され、ネットワークに接続できる場合は起動時に最新のカタログから更新されるため、ローカルの一覧が古くなることはありません。

🍳 レシピ

以下のプロンプトは、記載どおりに貼り付けて使えます。

一括処理のレシピを詳しく説明します。「チャンネル全体をアーカイブする」には、スクリプトではなく4回のツール呼び出しが必要です。

1. list_channel_videos に ids_only=true を指定します：1ページあたり最大500件の動画IDを取得します
2. 取得したIDを指定して submit_transcripts_job を呼び出します（最大4,000件、課金前に重複を除外し、 idempotency_key を指定すれば再試行は無料です）
3. status が done になるまで get_transcripts_job を呼び出します。ジョブはレート制限の範囲内で自動的に処理速度を調整します
4. get_transcripts_results をページごとに呼び出します。ジョブの実行中でも結果を読み取れます

サービスが取得できなかった動画の分は返金されるため、請求額はアーカイブの内容に一致します。

💳 料金と制限

• サブスクリプションでは、月1,000〜100,000クレジットを1,000単位でスライダー調整でき、1,000クレジットあたりの料金は利用量に応じて下がります（月10,000クレジットなら $44.90 ではなく $27.49）。年間割引は利用量に応じて約16%から約35%まで拡大します。
• 1クレジット = 回答済みリクエスト1件です。 YouTube に到達する前に失敗した呼び出し（検証、レート制限、当社の処理能力によるもの）は自動的に返金されます。現在の残高は X-Credits-Remaining ヘッダーで確認できます。
• 有効なサブスクリプションに加えて、期限のない使い切りクレジットパックを購入できます。
• 料金を見る · 請求を管理する

🧯 呼び出しが失敗した場合

🌐 通常の REST をお使いですか？

エージェントではなくアプリを構築していますか？同じバックエンドが JSON REST API として提供されており、 5 種類の字幕形式に加えて、ファイルの生データをダウンロードできます（download=true）。

ベース URL：https://api.transcriptout.com/v1

クライアントライブラリは Python と Node.js 向けに提供されています。どちらも広く使われている オープンソースライブラリのドロップイン代替で、インポートを 1 行変更するだけで切り替えられます。

pip install transcriptout   # replaces youtube-transcript-api
npm i transcriptout         # replaces youtube-transcript

ソース：youtube-transcript-python · youtube-transcript-js

🔗 リンク

• 🌐 ウェブサイト： transcriptout.com
• 📚 ドキュメント： transcriptout.com/docs
• 🧰 エージェントスキル（同じバックエンド、MCP 不要）： github.com/artemchuikin/youtube-skills
• 🐍 Python ライブラリ： github.com/artemchuikin/youtube-transcript-python
• 📦 Node.js ライブラリ： github.com/artemchuikin/youtube-transcript-js
• 💬 お問い合わせ： [email protected]

📇 MCP Registry

このサーバーは、公式のModel Context Protocol Registryに 次の名前で公開されています：

com.transcriptout/youtube-transcript-and-youtube-search

TranscriptOut は独立したサービスであり、YouTube または Google LLC とは提携、推奨、後援の関係にありません。 「YouTube」は Google LLC の商標です。

_{© 2026 TranscriptOut · MIT Licenseに基づいて公開}