Skip to main content
Glama
YouTube Transcript & Search MCP Server

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はタイムスタンプ付きセグメントを返します。

パラメータ

型

デフォルト

説明

video

string

必須

YouTube URL(完全か短縮)または11文字のビデオID

lang

string

"en"

トラックの言語コード(en、de、...)

format

string

"text"

"text"(プレーンテキスト)、"json"(秒単位のstart/durationを持つセグメント)、"srt"/"vtt"(字幕ファイル本体)、"srv3"(YouTubeの元のXML)

kind

string

自動検出

"manual"または"auto"。省略すると手動トラックが優先され、自動がフォールバックになります。

segment

integer

下記参照

セグメントあたりの最大文字数。500〜1500でRAGに使えるチャンクになります。

video_metadata

boolean

false

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

パラメータ

型

デフォルト

説明

id

string

必須

YouTubeのビデオIDまたはURL

クレジットの使い方: どうせ文字起こしを取得するなら、代わりにget_transcriptをvideo_metadata=trueで呼び出しましょう。本来は2回の呼び出しと2クレジット相当の情報を、1クレジットの同じ1回の呼び出しで取得できます。

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

YouTubeの動画またはチャンネルを検索します。next_page_tokenでページングします。has_moreは、別のページがさらに存在するかどうかを示します。

パラメータ

型

デフォルト

説明

q

string

必須*

検索クエリ(ページング中は省略可)

type

string

"video"

"video"または"channel"

limit

integer

20

1ページあたりの結果数、1〜50

next_page_token

string

前回の結果から得たトークン

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

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

パラメータ

型

デフォルト

説明

name

string

必須(*、ページング中は除く)

@handle、チャンネル名、UC...ID、またはURL

limit

integer

100

ページサイズ。ids_only利用時は最大500

ids_only

boolean

false

video_ids[]のみ返す(1ページ最大500件)

next_page_token

string

前の結果のトークン

ids_only=trueは、submit_transcripts_jobに渡すデータを安く用意する方法です。

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

YouTube独自の関連性検索を使って、1つのチャンネル内を検索します。タイトルに検索語が欠けた結果が出るのは正常です。結果は部分文字列ではなく関連性に基づいて並べられます。

パラメータ

型

デフォルト

説明

name

string

必須

@handle、チャンネル名、UC...IDまたはURL

q

string

必須

チャンネル内を検索するクエリ

limit

string

30

1ページあたりの件数、1〜100

next_page_token

string

ページングトークン

前の結果のトークン

6. latest_channel_videos · 1クレジット

チャンネルのRSSフィードから、そのチャンネルの直近の~15本の動画を取得します。最近公開されたものを確認する、最高速で最安の方法です。

パラメータ

型

デフォルト

説明

name

string

必須

@handle、チャンネル名、UC...IDまたはURL

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

プレイリストのすべての動画をプレイリスト順に返します。PL...プレイリストIDまたはlist=を含むURLを受け付けます。

パラメータ

型

デフォルト

説明

id

string

必須(ページング中は除く)

プレイリストIDまたはURL

limit

integer

100

ページサイズ(ids_onlyで最大500)

ids_only

boolean

false

video_ids[]のみを返す(1ページ最大500件)

next_page_token

string

ページング用トークン

8. search_playlist_videos · 1クレジット

プレイリスト内の動画を、タイトルの部分文字列(大文字小文字を区別しない)で検索します。YouTubeにはネイティブなプレイリスト検索がないため、最大500件のプレイリスト項目をスキャンします。truncated=trueは、スキャンした範囲の外にさらに一致する項目がある可能性を意味します。

パラメータ

型

既定値

説明

id

string

必須

プレイリストIDまたはURL

q

string

必須

動画タイトル内で一致させる部分文字列

limit

integer

30

最大一致数。1〜100

9. submit_transcripts_job · 1動画ごとに1クレジット

多数の動画(最大4,000件)の文字起こしをまとめてキューに投入し、即座に job_id を受け取れます。処理はバックグラウンドで、レート制限のペースに合わせて進行します。動画が数本を超える場合は、get_transcript をループで呼び出す代わりに、これを使ってください。

パラメータ

型

既定値

説明

videos

string[]

必須

動画IDまたはURL(最大4,000件)。重複は課金前に破棄されます

lang

string

"en"

ジョブ全体で使用する1つの言語

format

string

"text"

"text"、"json"、"srt"、"vtt"、"srv3" のいずれか。ジョブ全体で1つ

kind

string

自動検出

"manual" または "auto"

segment

integer

ジョブ全体で使用する1つのセグメントサイズ

video_metadata

boolean

false

動画ごとのメタデータ。追加費用なし

idempotency_key

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 を確認してください。

パラメータ

型

既定値

説明

job_id

string

必須

submit_transcripts_job で取得したジョブID

video_id

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.

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

Install MCP Server

インストール後、サーバー設定を開き、あなたのキーを含む 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 に含まれており、起動時にネットワークが使える場合にはライブのカタログから更新されるため、ローカルの一覧が古くなることはありません。


🍳 レシピ

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

ユースケース

プロンプト例

📝 動画を要約する

「この動画の要点を要約してください: \[URL]」

🔍 トピックを調べる

「ニューラル ラディアンス フィールドについて、YouTube で最も 00 視聴されている 5 本の動画を検索し、各動画を要約してください。」

🧠 学習ノートを作成する

「この MIT 講義シリーズのプレイリストから学習ノートを作成してください: [PLAYLIST URL]」

⚖️ 視点を比較する

「これら 2 本の動画の議論を比較してください: [URL1] [URL2]」

🌐 翻訳する

「この動画の文字起こしをスペイン語に翻訳してください: [URL]」

✍️ コンテンツを転用する

「この動画を 1,500 字のブログ記事にしてください: [URL]」

📡 投稿者を監視する

「毎朝 @kurzgesagt の新着動画を一覧にして、どれを見るべきか教えてください。」

🏛️ コンテンツ データベースを構築する

「@3blue1brown のすべての動画 ID を取得し、全動画の 文字起こしバッチ をキュー に入れてください。」

🎯 競合分析

「@fireship の動画の中から [競合製品] に関する動画を検索し、要点をまとめてください。」

🧩 RAG 取り込み

「このプレイリストの字幕を JSON で segment=1000 として取得し、インデックスに取り込んでください。」

バルクのレシピを具体的に説明します。 「チャンネル全体をアーカイブする」は、スクリプトではなく 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 をページごとに取得できます。ジョブの実行中でも読み取れます

サービスが配信できなかったものは動画ごとに返金されるため、請求額はアーカイブとぴったり一致します。


💳 料金と制限

プラン

料金

クレジット

レート制限

無料

$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_ で始まっていることを確認してください

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

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

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

  • 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

APIドキュメント →

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


🔗 リンク


📇 MCPレジストリ

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

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

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

Available Tools

14 tools
cancel_transcripts_jobCancel batch jobA
DestructiveIdempotent
Inspect

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 balanceA
Read-only
Inspect

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 transcriptA
Read-only
Inspect

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 progressA
Read-only
Inspect

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 resultA
Read-only
Inspect

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 resultsA
Read-only
Inspect

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 infoA
Read-only
Inspect

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 videosA
Read-only
Inspect

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 videosA
Read-only
Inspect

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 videosA
Read-only
Inspect

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 channelA
Read-only
Inspect

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 playlistA
Read-only
Inspect

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 YouTubeA
Read-only
Inspect

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

    A4.3/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers