YouTube Transcript + YouTube Search MCP

YouTube MCP サーバー：文字起こし、検索、チャンネル、プレイリスト

YouTube 向けのリモート MCP サーバーです。文字起こし、動画・チャンネル検索、チャンネル閲覧、チャンネル内検索、プレイリストの抽出ができます。
API キーまたは OAuth 2.1 でサインインできます。無料枠があり、カードは不要です。

Claude、ChatGPT、Cursor、VS Code、Windsurf、その他 15 以上の MCP 対応クライアント向けに、13 個のツールを 1 つのホスト型エンドポイントで提供します。ローカルへのインストールは不要です。

https://getyoutubetranscript.com/api/mcp

まずはお試しください：

Search @veritasium for videos about black holes, pull the transcript of the
two best matches, and tell me where they disagree.

エージェントがsearch_channel_videosとget_youtube_transcriptを自動で連携して実行します。お客様側でコードを書く必要はありません。

この MCP の特長

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

このリポジトリのルートは、Agent Plugins 1.0.0パッケージでもあります。MCP サーバーにyoutubeスキルが同梱されており、どのツールをいつ使うか、それぞれの費用はいくらか、クレジットの無駄をどう避けるかをエージェントに伝えます。

plugin.json                # plugin manifest
mcp.json                   # hosted MCP server (streamable-http, OAuth, no key in the file)
skills/youtube/SKILL.md    # when and how to use the 13 tools

VS Code でChat: Install Plugin From Sourceを実行し、https://github.com/tubeagentkit/youtube-mcpを貼り付けてください。Agent Plugins に対応する他のクライアントでは、このリポジトリまたはローカルクローンを指定できます。Cursor 用には別途プラグインリポジトリがあります。

このパッケージに認証情報は含まれていません。マニフェストが公開済みのスキーマに準拠しているか、ご自身で確認してください。

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

ChatGPT と Codex

同じplugin.jsonには、extensions.com.openaiの下に ChatGPT／Codex プラグインディレクトリの掲載情報が記載されています（他のクライアントは無視します）。scripts/build-openai-zip.shは、OpenAI のフィールド制限に準拠しているかを確認し、plugin.json、mcp.json、skills/、assets/のみを含むアップロード用 ZIP をdist/に作成します。

クイックインストール

必要なもの： 無料の getyoutubetranscript.com アカウント（登録 — 100 クレジット、カード不要）と、ダッシュボードから取得した API キー — または OAuth で接続すれば、キーは不要です（下記の認証を参照）。

ヒント： MCP OAuth に対応しているクライアントでは、以下のスニペットの headers ブロックを省略し、代わりにブラウザーからサインインできます。

ヒント： 「文字起こしツールを使って」と繰り返し指示する手間を省くには、クライアントのルールまたはカスタム指示に常時適用する指示を追加します。例：「YouTube のリンクを共有したら、回答する前に youtube-transcript MCP で文字起こしを取得してください。」

claude mcp add --transport http youtube-transcript https://getyoutubetranscript.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "youtube-transcript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

"mcp.servers": {
  "youtube-transcript": {
    "type": "http",
    "url": "https://getyoutubetranscript.com/api/mcp",
    "headers": { "Authorization": "Bearer YOUR_API_KEY" }
  }
}

{
  "mcpServers": {
    "youtube-transcript": {
      "serverUrl": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "youtube-transcript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "type": "streamableHttp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "context_servers": {
    "youtube-transcript": {
      "source": "remote",
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

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

amp mcp add youtube-transcript https://getyoutubetranscript.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

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

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

{
  "mcpServers": {
    "youtube-transcript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

30 秒で試す

Summarize this video for me: https://youtu.be/dQw4w9WgXcQ

エージェントがget_youtube_transcriptを呼び出し、結果を要約します。OAuth で接続している場合、設定するキーはありません — 接続を一度承認するだけです。

ローカルで実行する（stdio）

ローカルプロセスを使いたい場合は、server/をご覧ください。公式 MCP TypeScript SDK を基盤とした、同じ 13 個のツールを備えるオープンソースの stdio MCP サーバーです。API キーを使って公開 REST API を呼び出します。

git clone https://github.com/tubeagentkit/youtube-mcp
npm install --prefix youtube-mcp/server

続いて、クライアントからこのサーバーを指定します。例：Claude Desktop / Cursor

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/server/index.js"],
      "env": { "GYT_API_KEY": "sk_live_your_key_here" }
    }
  }
}

ライブ統合テスト（無料ツールのみを使用）：GYT_API_KEY=sk_live_... npm test --prefix server

認証

API キー

あらゆる MCP クライアントで使える汎用方式です。ダッシュボードで無料のキーを取得し（100 クレジット、カード不要）、Bearer トークンとして送信します。

"headers": { "Authorization": "Bearer sk_live_your_key_here" }

OAuth 2.1

キーを手動で管理する必要はありません — ブラウザーからサインインすれば、あとはサーバーが処理します。

• Dynamic Client Registration（DCR）： 接続時にクライアントを自己登録するクライアント（Claude Desktop/Web、ChatGPT など、多くのクライアント）でサポートされています。
• Client ID Metadata Documents（CIMD）： 現行の MCP 仕様（2026-07-28）に準拠し、独自のメタデータドキュメントをホストするクライアントでサポートされています — DCR に代わる、より新しい方式で、共有シークレットは不要です。
• 初回接続時に、許可されるアクセス内容を正確に示す同意画面が開きます。一度承認すれば接続完了です。

どちらの方式でも、この MCP サーバーにスコープが限定され、対象が固定されたトークンが発行されます — 他の API で再利用することはできません。

利用可能なツール

接続すると、13 個すべてのツールが自動的に公開されます。1 クレジット = リクエストの成功 1 回。 失敗した呼び出しやレート制限された呼び出しでは、クレジットは消費されません。

1. get_youtube_transcript

YouTube 動画の全トランスクリプトと、タイトル／投稿者／サムネイルのメタデータを取得します。

料金： timestamps の有無にかかわらず、1 クレジット。

2. get_transcript_languages

動画で利用できる字幕の言語と、投稿者がアップロードしたものか自動生成されたものか、およびデフォルトのリクエストで返される言語を一覧表示します。

空のリストは、動画の字幕がオフであることを意味します。通常のトランスクリプト取得では不要です。get_youtube_transcript が、返された言語をすでに報告します。

料金： 1 クレジット。

3. search_youtube

YouTube の動画またはチャンネルをページ分割して検索します。

料金： 1 ページにつき 1 クレジット。

4. get_channel_latest_videos

チャンネルのメタデータと最新のアップロード動画を取得します。

料金： 1 クレジット。

5. search_channel_videos

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

料金： 1 ページにつき 1 クレジット。

6. list_channel_videos

チャンネルの最新動画以外のアップロード動画を一覧表示します。過去のエピソード、人気動画、Shorts、過去のライブ配信などを取得できます。

料金： 1 ページにつき 1 クレジット。

7. list_channel_playlists

チャンネルが公開したプレイリストを一覧表示します。プレイリストの id を list_playlist_videos に渡すと、収録動画を確認できます。

料金： 1 ページにつき 1 クレジット。

8. list_channel_posts

チャンネルのコミュニティ投稿を一覧表示します。テキスト、リンク、高評価、コメント、および添付画像があればそれも含まれます。

料金： 1 ページにつき 1 クレジット。

9. get_related_videos

YouTube が動画の横に次におすすめする動画の一覧です。各動画のタイトル、動画 ID、リンク、チャンネル、再生回数、公開時期、長さが含まれます。

料金： 1 クレジット。

10. get_channel_banner

チャンネルのトリミング前のバナー、YouTube が提供するすべてのトリミングサイズ、およびアバターを取得します。チャンネルにバナーがない場合、has_banner は false になります。

料金： 1 クレジット。

11. get_video_dislikes

動画の高評価数、低評価数、星評価、再生回数を取得します。YouTube は低評価数を公開していないため、これらは推定値です。

料金： 1 クレジット。

12. list_playlist_videos

YouTube プレイリスト内のすべての動画を取得します。

料金： 1 ページにつき 1 クレジット。

13. get_credits _{· FREE}

キー／アカウントの残りのクレジット残高を確認します。パラメーターはありません。

料金： 無料。

ユースケースとプロンプト

料金とレート制限

• 1 クレジット = 成功したリクエスト 1 件。失敗したリクエストやレート制限されたリクエストではクレジットは消費されません。
• get_credits は唯一の無料ツールです。
• 請求を管理 →

トラブルシューティング

検証

このリポジトリには、ローカルの stdio MCP サーバーの MIT ライセンス対象ソース（server/ 内のツール定義、入力検証、API 呼び出し、エラーマッピング）と、ホステッドエンドポイントのマニフェストが含まれています。ホステッドエンドポイントと、その両方の背後にある REST API は getyoutubetranscript.com が運用しており、オープンソースではありません。どちらかを自分で確認するには、次の手順を実行してください。

• ローカルサーバーのライブテストを実行する — GYT_API_KEY=sk_live_... npm test --prefix server を実行すると、server/index.js が stdio 経由で起動し、13 個すべてのツールを一覧表示して、無料のツールを呼び出します。
• ホステッドエンドポイントに対して verify.js を実行する — 依存関係も認証も不要です：

  node verify.js
  

  ライブエンドポイントに対して実際の MCP ハンドシェイク（initialize の後に tools/list）を行い、13 個すべての実際のツールスキーマを含む、サーバーの実際の応答を出力します。 ツールの 検出 は公開されています。ツールの 呼び出し にのみ API キーまたは OAuth トークンが必要です（認証を参照）。
• 4 つのサードパーティ MCP ディレクトリによる独立した検証済み — いずれもライブエンドポイントに接続し、こちらの説明をそのまま信じたのではなく、ツール自体を確認しています：
  • 公式 MCP Registry — com.getyoutubetranscript/youtube-transcript-and-youtube-search。ドメイン所有権を検証済みの HTTP mcp-publisher を通じて公開されています
  • Smithery — 独自のスキャナーが接続し、6 個すべてのツールを検出しました
  • Glama
  • LobeHub
• 2026-09-12 から稼働中 — OAuth 2.1（DCR + CIMD）フローも、CIMD 経由で接続した実際のサードパーティクライアント（Smithery）によってエンドツーエンドでテストされ、その過程で実際の相互運用性の問題が明らかになり、修正されました（コミット履歴を参照）。

REST API も利用できます

エージェントではなくアプリを構築していますか？同じバックエンドを通常の JSON REST API として利用できます。エンドポイントの全リファレンスについては Agent Skill リポジトリを、直接キーを取得するにはダッシュボードをご覧ください。

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

接続

• 🌐 ウェブサイト： getyoutubetranscript.com
• 🔑 ダッシュボード： getyoutubetranscript.com/dashboard
• 🧩 Agent Skill 版： tubeagentkit/youtube-transcript-skills

開示

getyoutubetranscript.com は独立した製品であり、YouTube や Google とは提携しておらず、承認も受けていません。

関連プロジェクト

GetYouTubeTranscript APIを利用するその他の方法：

• youtube-transcript-api：YouTube Transcript API のドキュメント、エンドポイントリファレンス、OpenAPI 仕様、および curl、Python、JavaScript、Go、PHP のサンプル
• youtube-transcript-api-python：Python 用 YouTube Transcript API SDK
• youtube-transcript-api-node：Node.js / TypeScript 用 YouTube Transcript API SDK
• youtube-transcript-skills：Claude Code、Cursor、Codex、OpenClaw 用 YouTube transcript Agent Skill
• youtube-transcript-cursor-plugin：MCP サーバー、スキル、コマンド、リサーチエージェントを同梱した YouTube Transcript Cursor プラグイン
• n8n-nodes-getyoutubetranscript：YouTube transcript の n8n コミュニティノード。AI エージェントのツールとしても利用できます

ライセンス

MIT — LICENSEを参照してください。