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つの方法を実際に比較してみます。
本サーバー | ローカルyt-dlp / スクレイパーMCP | Google YouTube Data API | |
文字起こし | ✅ すべての公開動画、5形式 | ⚠️ データセンターのIPでブロックされ、YouTubeのマークアップ変更で壊れる | ❌ そもそも提供されていません |
セットアップ | ✅ URLとAPIキーのみ | ❌ ローカルインストール、維持が必要なバイナリ | ❌ クラウドプロジェクト、OAuth同意画面の設定が必要 |
YouTube検索 | ✅ ネイティブ、1ページあたり1クレジット | ❌ | ⚠️ 検索あたり100クォータユニット |
チャンネルとプレイリスト | ✅ 1ページあたり100本、IDのみなら500件 | ❌ 一度に1本 | ⚠️ アイテムごとにクォータを消費 |
一括文字起こし | ✅ バックグラウンドジョブあたり4,000件 | ❌ | ❌ |
RAG-readyチャンク化 | ✅ 20〜5,000文字、単語レベルのタイムスタンプ | ❌ | ❌ |
YouTubeが変わったとき | ✅ サーバー側で修正済み、更新不要 | ❌ 自分で修正して再デプロイ | ✅ |
失敗した呼び出し | ✅ クレジットが自動で返金される | ❌ 自作の再試行ロジックが必要 | ⚠️ クォータは消費される |
Related MCP server: mcp-transcripted
⚡ クイックスタート
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はタイムスタンプ付きセグメントを返します。
パラメータ | 型 | デフォルト | 説明 |
| string | 必須 | YouTube URL(完全か短縮)または11文字のビデオID |
| string |
| トラックの言語コード( |
| string |
|
|
| string | 自動検出 |
|
| integer | 下記参照 | セグメントあたりの最大文字数。500〜1500でRAGに使えるチャンクになります。 |
| boolean |
| 同じ呼び出し(同じ1クレジット)で、タイトル、チャンネル、再生時間、再生回数を追加します。 |
省略した場合、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本の動画のメタデータ(タイトル、チャンネル、再生時間、再生回数、サムネイル)と、利用可能な文字起こし言語の一覧を、字幕をダウンロードせずに返します。
パラメータ | 型 | デフォルト | 説明 |
| string | 必須 | YouTubeのビデオIDまたはURL |
クレジットの使い方: どうせ文字起こしを取得するなら、代わりに
get_transcriptをvideo_metadata=trueで呼び出しましょう。本来は2回の呼び出しと2クレジット相当の情報を、1クレジットの同じ1回の呼び出しで取得できます。
3. search_youtube · 1クレジット/ページ
YouTubeの動画またはチャンネルを検索します。next_page_tokenでページングします。has_moreは、別のページがさらに存在するかどうかを示します。
パラメータ | 型 | デフォルト | 説明 |
| string | 必須* | 検索クエリ(ページング中は省略可) |
| string |
|
|
| integer |
| 1ページあたりの結果数、1〜50 |
| string | 前回の結果から得たトークン |
4. list_channel_videos · 1クレジット/ページ
チャンネルの「動画」タブから動画を新しい順に一覧表示します。@handle、チャンネル名、UC...チャンネルID、またはチャンネルURLを受け付けます。
パラメータ | 型 | デフォルト | 説明 |
| string | 必須(*、ページング中は除く) |
|
| integer |
| ページサイズ。 |
| boolean |
|
|
| string | 前の結果のトークン |
ids_only=trueは、submit_transcripts_jobに渡すデータを安く用意する方法です。
5. search_channel_videos · 1クレジット/ページ
YouTube独自の関連性検索を使って、1つのチャンネル内を検索します。タイトルに検索語が欠けた結果が出るのは正常です。結果は部分文字列ではなく関連性に基づいて並べられます。
パラメータ | 型 | デフォルト | 説明 |
| string | 必須 |
|
| string | 必須 | チャンネル内を検索するクエリ |
| string |
| 1ページあたりの件数、1〜100 |
| string | ページングトークン | 前の結果のトークン |
6. latest_channel_videos · 1クレジット
チャンネルのRSSフィードから、そのチャンネルの直近の~15本の動画を取得します。最近公開されたものを確認する、最高速で最安の方法です。
パラメータ | 型 | デフォルト | 説明 |
| string | 必須 |
|
7. list_playlist_videos · 1クレジット/ページ
プレイリストのすべての動画をプレイリスト順に返します。PL...プレイリストIDまたはlist=を含むURLを受け付けます。
パラメータ | 型 | デフォルト | 説明 |
| string | 必須(ページング中は除く) | プレイリストIDまたはURL |
| integer |
| ページサイズ( |
| boolean |
|
|
| string | ページング用トークン |
8. search_playlist_videos · 1クレジット
プレイリスト内の動画を、タイトルの部分文字列(大文字小文字を区別しない)で検索します。YouTubeにはネイティブなプレイリスト検索がないため、最大500件のプレイリスト項目をスキャンします。truncated=trueは、スキャンした範囲の外にさらに一致する項目がある可能性を意味します。
パラメータ | 型 | 既定値 | 説明 |
| string | 必須 | プレイリストIDまたはURL |
| string | 必須 | 動画タイトル内で一致させる部分文字列 |
| integer |
| 最大一致数。1〜100 |
9. submit_transcripts_job · 1動画ごとに1クレジット
多数の動画(最大4,000件)の文字起こしをまとめてキューに投入し、即座に job_id を受け取れます。処理はバックグラウンドで、レート制限のペースに合わせて進行します。動画が数本を超える場合は、get_transcript をループで呼び出す代わりに、これを使ってください。
パラメータ | 型 | 既定値 | 説明 |
| string[] | 必須 | 動画IDまたはURL(最大4,000件)。重複は課金前に破棄されます |
| string |
| ジョブ全体で使用する1つの言語 |
| string |
|
|
| string | 自動検出 |
|
| integer | ジョブ全体で使用する1つのセグメントサイズ | |
| boolean |
| 動画ごとのメタデータ。追加費用なし |
| string | 同じキーで同じリストを再送信すると同じジョブが返り、二重請求はありません |
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 を確認してください。
パラメータ | 型 | 既定値 | 説明 |
| string | 必須 |
|
| string | 必須 | ジョブに含まれていた動画IDのうちのいずれか |
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"
}
}
}新しいエージェントを作成します
Action または Tools で、新しい MCP Server を追加します
URL:
https://api.transcriptout.com/mcp認証タイプ: API Key
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 toolsVS 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 に含まれており、起動時にネットワークが使える場合にはライブのカタログから更新されるため、ローカルの一覧が古くなることはありません。
🍳 レシピ
以下のプロンプトは、そのままコピーして使えます。
ユースケース | プロンプト例 |
📝 動画を要約する | 「この動画の要点を要約してください: |
🔍 トピックを調べる | 「ニューラル ラディアンス フィールドについて、YouTube で最も 00 視聴されている 5 本の動画を検索し、各動画を要約してください。」 |
🧠 学習ノートを作成する | 「この MIT 講義シリーズのプレイリストから学習ノートを作成してください: [PLAYLIST URL]」 |
⚖️ 視点を比較する | 「これら 2 本の動画の議論を比較してください: [URL1] [URL2]」 |
🌐 翻訳する | 「この動画の文字起こしをスペイン語に翻訳してください: [URL]」 |
✍️ コンテンツを転用する | 「この動画を 1,500 字のブログ記事にしてください: [URL]」 |
📡 投稿者を監視する | 「毎朝 @kurzgesagt の新着動画を一覧にして、どれを見るべきか教えてください。」 |
🏛️ コンテンツ データベースを構築する | 「@3blue1brown のすべての動画 ID を取得し、全動画の 文字起こしバッチ をキュー に入れてください。」 |
🎯 競合分析 | 「@fireship の動画の中から [競合製品] に関する動画を検索し、要点をまとめてください。」 |
🧩 RAG 取り込み | 「このプレイリストの字幕を JSON で |
バルクのレシピを具体的に説明します。 「チャンネル全体をアーカイブする」は、スクリプトではなく 4 回のツール呼び出しで行えます。
ids_only=trueを指定したlist_channel_videos: 1ページあたり最大500件の動画IDを取得そのIDを渡して
submit_transcripts_jobを呼び出します(最大4,000件。重複は課金前に除外され、idempotency_keyを使えば再試行も無料)statusがdoneになるまでget_transcripts_jobを実行します。ジョブはレート制限内で自らペースを調整しますget_transcripts_resultsをページごとに取得できます。ジョブの実行中でも読み取れます
サービスが配信できなかったものは動画ごとに返金されるため、請求額はアーカイブとぴったり一致します。
💳 料金と制限
プラン | 料金 | クレジット | レート制限 |
無料 | $0 | 登録時に100(1回限り) | 200 req/min |
Starter | $4.49/月 | 1,000/月 | 200 req/min |
Starter 年払い | $45.29/年(約$3.77/月) | 1,000/月 | 200 req/min |
Scale | スライダーで最大$198.99/月 | 最大100,000/月 | 200 req/min |
サブスクリプションは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)にも対応しています。
MCP | REST API | |
最適な用途 | AIアシスタントとエージェント | アプリとバックエンドサービス |
セットアップ | URLとキーを追加 | コードに組み込む |
はじめ方 | このREADME |
ベース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-searchTranscriptOut は独立したサービスであり、YouTube や Google LLC との提携、承認、スポンサー関係は一切ありません。「YouTube」は Google LLC の商標です。
Available Tools
14 toolscancel_transcripts_jobCancel batch jobADestructiveIdempotentInspect
Cancel a batch job. Credits are refunded ONLY for videos not started yet — anything already fetched stays in the results and stays paid for. Free.
Inputs: job_id (required). Returns: status
get_creditsCredit balanceARead-onlyInspect
Check the remaining credit balance of the API key. Free. Use it when the user asks how many credits are left, or before submit_transcripts_job to confirm a large batch fits the balance (the batch charges 1 credit per video on submit).
Inputs: no named parameters. Returns: credits, metered, user_id
get_transcriptGet transcriptARead-onlyInspect
Get the transcript (subtitles) of a YouTube video. Accepts a video id or any YouTube URL. Set video_metadata=true to get the title, channel and duration in the SAME call — do not call get_video_info first, that is a second billed call for data this one already returns. format=text returns plain readable text (default, cheapest to read); format=json returns timed segments with start/duration in seconds; srt/vtt return ready subtitle file bodies and srv3 the raw YouTube XML. Prefer text unless you need timestamps or a file. Costs 1 credit.
Inputs: video (required), kind, lang, format, +2 more. Returns: kind, language, metadata, video_id, +2 more
get_transcripts_jobBatch job progressARead-onlyInspect
Check the progress of a batch job: status (queued/running/done/cancelled), how many videos are ready, failed and still pending. Free — polling a job you already paid for costs nothing. Read the transcripts themselves with get_transcripts_results.
Inputs: job_id (required). Returns: done, count, ready, failed, +2 more
get_transcripts_resultOne batch resultARead-onlyInspect
Read ONE video's result out of a batch job by its video id, without paging through get_transcripts_results. 404 means the job does not exist or this video has not finished yet — check get_transcripts_job before concluding anything. Free.
Inputs: job_id (required), video_id (required). Returns: status, video_id, transcript
get_transcripts_resultsBatch job resultsARead-onlyInspect
Read finished transcripts from a batch job, in the order submitted. Results appear as they are fetched, so this can be called before the job is done. Each entry is exactly what get_transcript returns for that video, plus its status. Page with next_page_token. Free.
Inputs: job_id (required), limit, next_page_token. Returns: count, results, has_more, next_page_token
get_video_infoGet video infoARead-onlyInspect
Get metadata for one YouTube video (title, channel, duration, views, thumbnails) plus the list of available transcript languages, WITHOUT downloading the subtitles. Use it only when the transcript itself is not wanted. If you are going to fetch the transcript anyway, call get_transcript with video_metadata=true instead — it returns both for one credit, where these are two separate calls and two credits.
Inputs: id (required). Returns: title, available_langs
latest_channel_videosLatest channel videosARead-onlyInspect
Get the ~15 most recent videos of a channel from its RSS feed. Fastest and cheapest way to check what a channel published recently.
Inputs: name (required). Returns: videos, channel
list_channel_videosList channel videosARead-onlyInspect
List videos from a channel's Videos tab, newest first. Accepts an @handle, a UC... channel id or a channel URL. ids_only=true returns just video ids (up to 500 per page) — use it when you only need ids to fetch transcripts.
Inputs: name, limit, ids_only, next_page_token. Returns: count, videos, channel, has_more, +2 more
list_playlist_videosList playlist videosARead-onlyInspect
List videos of a playlist in playlist order. Accepts a PL... playlist id or a URL with list=. ids_only=true returns just video ids (up to 500 per page).
Inputs: id, limit, ids_only, next_page_token. Returns: count, videos, has_more, playlist, +2 more
search_channel_videosSearch within a channelARead-onlyInspect
Search videos inside one channel using YouTube's native relevance search. Results are ranked by relevance, so a video whose title lacks the query word is normal.
Inputs: q, name, limit, next_page_token. Returns: videos, channel, has_more, next_page_token
search_playlist_videosSearch within a playlistARead-onlyInspect
Find videos inside a playlist by a substring of the title (case-insensitive). YouTube has no native playlist search, so this scans up to 500 playlist items. truncated=true means there may be more matches beyond the scanned window.
Inputs: q (required), id (required), limit. Returns: truncated
search_youtubeSearch YouTubeARead-onlyInspect
Search YouTube for videos or channels. Paginate by passing next_page_token from the previous result. has_more tells you whether another page exists.
Inputs: q, type, limit, next_page_token. Returns: has_more, next_page_token
submit_transcripts_jobSubmit transcripts batchAInspect
Queue transcripts for MANY videos at once (up to 4000) and get a job_id back immediately — the work continues in the background. Use this instead of calling get_transcript in a loop for more than a handful of videos. Feed it video ids from list_channel_videos or list_playlist_videos (ids_only=true). Next: poll get_transcripts_job until status is 'done', reading finished transcripts from get_transcripts_results as they land. Costs 1 credit per video, charged on submit; duplicates are removed first. Requires a user key (sk_...).
Inputs: videos (required), kind, lang, format, +3 more. Returns: count, job_id, status, credits
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Each tool has a distinct job: search, list, fetch single transcript, manage batch jobs, or check credits. The main ambiguities are get_transcripts_results vs get_transcripts_result and get_video_info vs get_transcript with video_metadata=true, but the descriptions clearly point agents to the right choice.
Most names follow a clean verb_noun pattern like get_transcript, list_channel_videos, submit_transcripts_job. The pattern is slightly mixed by latest_channel_videos and the singular/plural get_transcripts_results/get_transcripts_result, but conventions remain mostly predictable.
With 14 tools, the server is well-scoped for transcript retrieval plus YouTube search and batch job management. Every tool addresses a real workflow and none feel redundant.
The surface covers the full workflow: discover videos, get metadata, fetch individual or batch transcripts, poll job status, retrieve results, cancel jobs, and monitor credits. There are no obvious missing operations for the stated domain.
Maintenance
Related MCP Connectors
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
TranscriptAPI.com: hosted YouTube transcripts, search, channels and playlists for AI agents
YouTube transcripts for AI agents: 150+ languages, AI transcription fallback, search, summaries.
15 media & data tools for AI agents: search, transcribe, subtitles, voiceover, translate & more.
Related MCP Servers
- AlicenseBqualityNot gradedmaintenanceYouTube intelligence layer for AI agents. 41 tools across 10 modules ; search, explore, transcripts, comments, visual search, analytics, and more. Zero config.41150 npm-
- FlicenseNot gradedqualityDmaintenancePay-per-success YouTube transcript extractor for AI agents and RAG pipelines. Timestamps, SRT, plain text. Failed videos are never charged. $0.005/video.-
- AlicenseAqualityCmaintenanceEnables AI agents to search YouTube like a database, retrieve transcripts and channel data, and mine videos for claims, numbers, and demand signals — without needing an API key.681 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to search videos, retrieve metadata and transcripts, pinpoint exact moments via hybrid semantic search, and conduct multi-video research with timestamp deep links—all without YouTube API keys.51MIT