YouTube Transcript & Search MCP Server

🎬 なぜ

エージェントを扱う人なら誰でも、このやりとりを一度は経験したことがあるはずです。

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つの方法を実際に比較してみます。

Related MCP server: VidLens

⚡ クイックスタート

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文字のセグメントに分割し、手動トラックは作者がそのまま分割した形で返します。どのトラックが返るかにかかわらず、1つのサイズが必要な場合はこのパラメータを渡してください。

出力例（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本の動画のメタデータ（タイトル、チャンネル、再生時間、再生回数、サムネイル）と、利用可能な文字起こし言語の一覧を、字幕をダウンロードせずに返します。

クレジットの使い方： どうせ文字起こしを取得するなら、代わりにget_transcriptをvideo_metadata=trueで呼び出しましょう。本来は2回の呼び出しと2クレジット相当の情報を、1クレジットの同じ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・無料

バッチジョブから1本の動画の結果を、動画IDで取得します。結果全体をページングする必要はありません。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.

ワンクリックインストール:

インストール後、サーバー設定を開き、あなたのキーを含む Authorization ヘッダーを追加してください。

手動設定（~/.cursor/mcp.json）:

{
  "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"

Claude のカスタムコネクタはリモートサーバーを OAuth で認証しますが、TranscriptOut はまだ OAuth に対応していません（APIキーのみ）。デスクトップでは、APIキーのヘッダーに対応している Claude Code（上記を参照）を使用してください。OAuth対応はロードマップに予定されています。changelog をご覧ください。

または、VS Code のユーザー設定（settings.json）に以下を追加します。

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

1. 新しいエージェントを作成します

2. Action または Tools で、新しい MCP Server を追加します

3. URL: https://api.transcriptout.com/mcp

4. 認証タイプ: API Key

5. dashboard から取得した API キーを貼り付けます

~/.codeium/windsurf/mcp_config.json に追加します:

{
  "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"
      }
    }
  }
}

Zed の settings.json 内:

{
  "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"

settings.json の augment.advanced セクション内:

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

.kilocode/mcp.json 内:

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

Settings → Tools → AI Assistant → MCP 内:

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

~/.gemini/settings.json 内:

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

~/.qwen/settings.json 内:

{
  "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"
      }
    }
  }
}

mcp.json 内:

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

Settings → AI → MCP 内:

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

Settings → Connectors → Advanced 内:

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

🧩 Agent プラグインとしてインストールする

このリポジトリのルートは、Agent Plugins 1.0.0 に準拠したパッケージです。ChatGPT、Codex、Cursor、GitHub Copilot、Kiro、VS Code がサポートするポータブルな形式です。1回のインストールで、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

🔑 キーとセキュリティ

• キーは生成時に一度だけ表示されます。環境変数に保管し、バージョン管理には入れないでください。

• 漏えいしたキーは dashboard で失効させた瞬間に無効化されます。アカウントには最大20個のキーを保持できるため、マシンごとに専用のキーを用意してください。

• そのままチャット内で作業したい場合は、付属の youtube-skills をインストールしたエージェントが、ブラウザなしでメールアドレスと青印字6桁のコードを使ってアカウントを開き、キーを発行できます。

• OAuth フローはまだ無いため、カスタムヘッダーを送信できないコネクタ（Claude Desktop や Claude Web）は、今のところ Claude Code を経由してください。

🐳 ローカルで実行する

ホスト型エンドポイントにはインストールは不要ですが、stdioのみのクライアント、サンドボックス、コンテナプラットフォームでは、専用のプロセスが必要になることがあります。このリポジトリにはそのプロセスが含まれています。server.js は完全なローカル MCP サーバー（公式 SDK、stdio トランスポート）で、14 のツールがそれぞれ TranscriptOut REST API に 1 回の HTTPS 呼び出しを行います。これは、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

キーがなくても接続して全てのツールを一覧表示できます。ツールの呼び出しには、003を告知し取得方法を明示した明確な 401 が返ります。ツール定義は tools.json に含まれており、起動時にネットワークが使える場合にはライブのカタログから更新されるため、ローカルの一覧が古くなることはありません。

🍳 レシピ

以下のプロンプトは、そのままコピーして使えます。

バルクのレシピを具体的に説明します。 「チャンネル全体をアーカイブする」は、スクリプトではなく 4 回のツール呼び出しで行えます。

1. ids_only=true を指定した list_channel_videos: 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 ヘッダーで確認できます。

• 有効期限がない1回限りのクレジットパックを、サブスクリプション中に追加購入することもできます。

• 料金を見る ・ 請求管理

🧯 呼び出しが失敗したとき

• APIキーが sk_ で始まっていることを確認してください

• コピーする際に余分なスペースが入っていないか確認してください

• キーが ダッシュボード で有効になっていることを確認してください

• 失効したキーは即座に失敗します。ダッシュボードで新しいキーを発行してください

• ダッシュボード で残高を確認してください

• transcriptout.com/billing でサブスクリプションに登録するか、クレジットパックを購入してください

• 404: 動画に指定した言語・トラックのキャプションがないか、IDが間違っています。これは最終的な回答であり、再試行しても結果は変わりません。

• 410: 動画が削除されています。

• 451: 年齢制限付き、またはメンバー限定のコンテンツです。

• Retry-After ヘッダーに従ってください。いずれも自動的に返金されます

• 大量に処理する場合は submit_transcripts_job を使ってください。レート制限に弾かれるのではなく、その範囲内で自らペースを調整します

エラーボディは常に {"ok": false, "code": "...", "detail": "...", "request_id": "req_..."} という形式です。 人が読むためのテキストではなく、機械可読な code で分岐してください。サポートに連絡する際は request_id を含めてください。

🌐 素のRESTがお好みですか?

エージェントではなくアプリを作っていますか? 同じバックエンドが JSON REST API としても提供されており、同じ5つのトランスクリプト形式に加えて、生ファイルのダウンロード(download=true)にも対応しています。

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

🔗 リンク

• 🌐 ウェブサイト: transcriptout.com

• 📚 ドキュメント: transcriptout.com/docs

• 🧰 エージェントスキル(同じバックエンド、MCP不要): github.com/artemchuikin/youtube-skills

• 💬 お問い合わせ: support@transcriptout.com

📇 MCPレジストリ

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

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

TranscriptOut は独立したサービスであり、YouTube や Google LLC との提携、承認、スポンサー関係は一切ありません。「YouTube」は Google LLC の商標です。