YouTube Transcript MCP By GetYouTubeText
公式YouTubeの文字起こしを超高速で取得します。
YouTube Transcript By GetYouTubeText MCPで何ができますか?
- 動画の文字起こしを取得 — 任意のYouTubeリンクまたは動画IDを指定して文字起こしを取得できます。言語の選択や時間範囲の絞り込みも可能です。
- タイムスタンプ付きまたは段落形式の文字起こしを取得 — 各行にタイムスタンプを付けるか、段落ごとにまとめて取得できます。また、文字起こし内の特定の単語を検索できます。
- 動画の詳細を確認 — 文字起こし全体を取得せずに、動画のタイトル、チャンネル、サムネイルを取得できます。
- チャンネルの最新アップロードを一覧表示 — チャンネルID、ハンドル、またはチャンネルURLを指定して、最新の動画15件を取得できます。
ホスト型 MCP サーバー
npx add-mcp 'https://getyoutubetext.com/mcp'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
YouTube Transcript API ドキュメント
ファイル形式を指定しない限り、すべて GET リクエストで JSON が返されます。ベース URL は https://getyoutubetext.com.
クイックスタート
アカウントを作成して、最初のリクエストを送信しましょう。新規アカウントには、無料クレジットが 100 付与されます。
curl "https://getyoutubetext.com/v1/transcript?url=jNQXAC9IVRw" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"video_id": "jNQXAC9IVRw",
"title": "Me at the zoo",
"author": "jawed",
"author_url": "https://www.youtube.com/@jawed",
"language": "en",
"available_languages": ["en", "de"],
"duration_seconds": 19,
"cached": true,
"segment_count": 6,
"text": "All right, so here we are, in front of the elephants...",
"segments": [
{ "text": "All right, so here we are, in front of the elephants", "start": 1.2, "duration": 2.16 },
{ "text": "the cool thing about these guys is that they have really...", "start": 5.318, "duration": 2.656 }
]
}
認証
すべてのリクエストで Authorization ヘッダーにキーを指定してください(X-API-Key ヘッダーも使用できます)。キーは gyt_live_ で始まり、有効期限はありません。ダッシュボードから取り消すことができます。1 つのアカウントにつき、最大 10 個のキーを作成できます。
Authorization: Bearer gyt_live_…
キーはサーバー上で管理してください。ブラウザーのコードや公開リポジトリにキーを置くと、見つけた人なら誰でも使用できます。
クレジット
- 成功したリクエストはすべて 1 クレジットを消費します。対象は、動画の長さや形式を問わない文字起こし、動画情報、チャンネルの最新アップロードです。
- 失敗したリクエストはクレジットを消費しません。字幕がない場合、動画が非公開または見つからない場合、入力が不正な場合、レート制限に達した場合、または当社側でエラーが発生した場合が該当します。アカウントの確認(/v1/me)も無料です。
- 有料プランのクレジットは、年額プランも含め、毎月補充されます。未使用のプランクレジットは繰り越されません。無料プランの 100 クレジットは一度だけ付与されます。
- 有料プランではクレジットパックを購入できます。5,000 クレジットで、有効期限はなく、プランのクレジットを使い切った後に使用されます。
- 同じ動画への再リクエストにはキャッシュが使われます。処理は速くなりますが、引き続き 1 クレジットを消費します。
キーが受け付けられると、文字起こし、動画、チャンネルのすべてのレスポンス(失敗したものも含む)に X-Credits-Charged と X-Credits-Remaining ヘッダーが含まれるため、別のリクエストを行わずに利用状況を確認できます。
文字起こし 1 クレジット
GET /v1/transcript
| Param | Type | Description |
|---|---|---|
| url | string, required | YouTube URL(watch、youtu.be、shorts、embed、live)または 11 文字の動画 ID。 |
| lang | string | es や pt-BR などの言語コード。デフォルトは英語で、次に動画のオリジナル音声トラックが使われます。指定した言語のトラックがない場合はデフォルトのトラックが返され、レスポンスの language で使用された言語を確認できます。 |
| format | string | json(デフォルト)、text、srt、vtt、csv、md。 |
| timestamps | boolean | true に設定すると、text 出力と JSON の text フィールドで各行の先頭に [HH:MM:SS] が付きます。md 出力では各行の先頭に、その動画の該当箇所へ移動するクリック可能な [MM:SS] リンクが付きます。 |
| paragraphs | boolean | true に設定すると、字幕行を一時停止箇所と文末で区切り、段落サイズのまとまりに結合します。 |
| chunk_size | integer | paragraphs=true の場合の、段落あたりの最大文字数。50~10000、デフォルトは 400。 |
| start / end | number | 秒数。この範囲内の文字起こしのみを返します。 |
| search | string | このテキストを含む行のみを、大文字と小文字を区別せずに返します。timestamps=true と組み合わせると、各行が話された位置を確認できます。 |
| segments | boolean | false に設定すると segments 配列を省略し、text のみを返します(JSON のみ)。 |
レスポンスフィールド(JSON)
- language: 取得したトラック。available_languages: 動画にあるすべてのトラック。
- duration_seconds、segment_count、cached
- text: 文字起こし全体を 1 つの文字列として返します
- segments: { text, start, duration } の配列。時刻は秒単位です
例
curl "https://getyoutubetext.com/v1/transcript?url=dQw4w9WgXcQ&format=srt" \
-H "Authorization: Bearer YOUR_API_KEY" -o captions.srt
動画情報 1 クレジット
文字起こしを含まず、動画のタイトル、チャンネル、サムネイルを返します。リンクの内容を表示する場合に便利です。動画が見つからないか非公開の場合は VIDEO_UNAVAILABLE が返され、クレジットは消費されません。
{
"video_id": "jNQXAC9IVRw",
"url": "https://www.youtube.com/watch?v=jNQXAC9IVRw",
"title": "Me at the zoo",
"author": "jawed",
"author_url": "https://www.youtube.com/@jawed",
"thumbnail_url": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg"
}
チャンネルの最新動画 1 クレジット
チャンネルの最新アップロード 15 件を、新しい順に返します。channel にはチャンネル ID(UC…)、@handle、またはチャンネル URL(youtube.com/@handle または youtube.com/channel/UC…)を指定します。古い形式の /c/ および /user/ リンクには対応していないため、代わりにハンドルを使用してください。新しい動画を検出するには定期的にポーリングし、その後、動画の文字起こしを取得します。
{
"channel_id": "UCBJycsmduvYEL83R_U4JriQ",
"channel": "Marques Brownlee",
"channel_url": "https://www.youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ",
"video_count": 15,
"videos": [
{
"video_id": "hdMszZ2ah5Q",
"url": "https://www.youtube.com/watch?v=hdMszZ2ah5Q",
"title": "…",
"published": "2026-11-11T18:43:56+00:00",
"views": 5319666,
"thumbnail_url": "https://i.ytimg.com/vi/hdMszZ2ah5Q/hqdefault.jpg"
}
]
}
アカウント 無料
送信したキーのプラン、残りのクレジット、レート制限を返します。billing は month、year、または無料プランの場合は null です。無料で、レート制限にもカウントされません。
{
"plan": "free",
"billing": null,
"credits_remaining": 96,
"plan_credits_remaining": 96,
"plan_credits_total": 100,
"topup_credits": 0,
"period_end": null,
"rate_limit_per_minute": 30
}
エラー
エラーの形式は常に同じです。安定している code に基づいて処理してください。message は人向けの説明であり、変更される場合があります。
{
"error": {
"code": "NO_CAPTIONS",
"message": "This video has no captions, so there is no transcript to return.",
"retryable": false
}
}
| Status | Code | Meaning | Retry? |
|---|---|---|---|
| 400 | INVALID_URL | url が指定されていないか、YouTube のリンクまたは動画 ID ではありません。 | いいえ |
| 400 | INVALID_PARAM | 使用できない値がパラメーターに指定されています。どの値かはメッセージに記載されています。 | いいえ |
| 401 | INVALID_API_KEY | キーが指定されていないか、間違っているか、取り消されています。 | いいえ |
| 402 | INSUFFICIENT_CREDITS | クレジットが残っていません。 | いいえ |
| 404 | NO_CAPTIONS | 動画は存在しますが、字幕がありません。 | いいえ |
| 404 | VIDEO_UNAVAILABLE | 動画が非公開、削除済み、年齢制限付き、または存在しません。 | いいえ |
| 404 | CHANNEL_NOT_FOUND | 指定された ID またはハンドルに一致するチャンネルがありません。 | いいえ |
| 429 | RATE_LIMITED | 1 分間のリクエスト数が多すぎます。Retry-After ヘッダーの時間だけ待ってください。 | はい |
| 502 | UPSTREAM_ERROR | YouTube から時間内に応答がありませんでした。1~2 秒後に再試行してください。 | はい |
| 500 | INTERNAL_ERROR | 当社側で問題が発生しました。 | はい |
レート制限
制限はアカウント単位で、すべてのキー、MCP サーバー、ダッシュボードのプレイグラウンドで共有され、直近 1 分間のリクエスト数に基づいて計算されます。文字起こし、動画、チャンネルのレスポンスには X-RateLimit-Limit と X-RateLimit-Remaining が含まれます。制限を超えると、秒数を示す Retry-After ヘッダー付きの 429 が返されます。年額プランでは上限が高くなります。Scale の年額プランをご利用の場合は、上限の引き上げについてお問い合わせください。
| Plan | Monthly billing | Yearly billing |
|---|---|---|
| Free | 30 | 30 |
| Starter | 120 | 200 |
| Pro | 300 | 500 |
| Scale | 600 | 1000 |
MCP サーバー
ホスト型の Model Context Protocol サーバーは https://getyoutubetext.com/mcp にあります(Streamable HTTP)。REST API と同じクレジットを使用します。
アプリからサインイン(ChatGPT、claude.ai)
Connect ボタンがあるアプリでは、サーバー URL を指定するだけで利用できます。アプリから GetYouTubeText のサインインページが開くので、接続を承認すると、アプリ専用のトークンが発行されます。これは PKCE と動的クライアント登録を使用する OAuth 2.1 です。メタデータは /.well-known/oauth-authorization-server にあります。接続済みのアプリは、ダッシュボードの MCP ページから削除できます。
ChatGPT: Plugins を開き、Add、Add custom MCP server の順にクリックして、OAuth を使用するサーバー URL を貼り付けます。Advanced OAuth settings で、Registration method を User-Defined OAuth Client に設定し、クライアント ID getyoutubetext-chatgpt を入力します。シークレットは指定せず、認証方式は none にします。
API キーを使用(Claude Code、Cursor、VS Code)
claude mcp add --transport http getyoutubetext https://getyoutubetext.com/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
| Tool | Arguments | Cost |
|---|---|---|
| get_transcript | url (required), lang, timestamps, paragraphs, start, end, search | 1 クレジット |
| get_video_info | url (required) | 1 クレジット |
| get_channel_latest_videos | channel (required) | 1 クレジット |
get_transcript では、モデルがタイムスタンプ付きの段落をより適切に読み取れるため、timestamps と paragraphs のデフォルト値は true です。REST API では、どちらもデフォルトで false です。
ツールのエラーは、isError: true と、REST API と同じエラーコードで始まるメッセージを含む通常のツール結果として返されます。そのため、モデルはエラーを読み取り、次の対応を判断できます。