YouTube Transcript AI

YouTube Transcript MCP Server

Claude、ChatGPT、Cursor、Claude Code、その他の MCP クライアントで YouTube の文字起こしを読めるようにします。ホスト型なので、インストールは不要です。無料の API キーで 1 日 10 回リクエストできます。

youtube-transcript.ai を利用する、ホスト型の Model Context Protocol サーバーです。get_youtube_transcript というツールを 1 つ提供します。会話中に YouTube のリンクを貼り付けるだけで、AI が必要に応じて全文の文字起こしを読み取ります。

コネクター URL：

https://youtube-transcript.ai/mcp?key=YOUR_KEY

YOUR_KEY を API キーに置き換えてください。Google アカウントでサインインして無料のキーを作成できます。作成には約 1 分かかります。

---

特長

• 無料で始められます。 無料キーでは、1 日に 10 件の文字起こしを取得できます。Pro は同じキーで年間 120 ドル、1 日 1,000 件です。
• 信頼性があります。 プロキシへのフォールバックを備えた堅牢な取得パイプラインにより、一般的なスクレイパーをブロックする動画でも文字起こしを取得できます。
• あらゆる言語に対応します。 言語コード（en、zh-CN、es、ja、…）で字幕トラックを選ぶか、既定のトラックを自動選択できます。
• エージェント向けに設計されています。 ツールは 1 つで、タイトルとメタデータを含むプレーンテキストを出力します。数時間に及ぶ動画は分割して返されるため、途中で切れることはありません。

認証

ツールの呼び出しには API キーが必要です。OAuth には対応していません。次のいずれかの方法でキーを送信してください。

場所	例
ヘッダー	Authorization: Bearer YOUR_KEY
URL	https://youtube-transcript.ai/mcp?key=YOUR_KEY

URL 形式は、コネクター URL のみを受け付けるクライアント向けです。

クイックスタート

Claude（Web／デスクトップ）

設定 → コネクター → カスタムコネクターを追加

フィールド	値
名前	youtube-transcript.ai
URL	https://youtube-transcript.ai/mcp?key=YOUR_KEY

次のように尋ねます：“この動画を要約してください：https://youtu.be/dQw4w9WgXcQ”

ChatGPT

カスタムコネクター／MCP サーバーの設定で、URL https://youtube-transcript.ai/mcp?key=YOUR_KEY の MCP サーバーを追加し（トランスポート：Streamable HTTP）、チャットで有効にしてから、YouTube のリンクを貼り付けます。

Claude Code

claude mcp add --transport http --scope user youtube-transcript \
  https://youtube-transcript.ai/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor

~/.cursor/mcp.json、またはプロジェクト内の .cursor/mcp.json に追加します：

{
  "mcpServers": {
    "youtube-transcript": {
      "url": "https://youtube-transcript.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Codex

~/.codex/config.toml に追加します：

[mcp_servers.youtube-transcript]
url = "https://youtube-transcript.ai/mcp"
http_headers = { "Authorization" = "Bearer YOUR_KEY" }

ローカルサーバーのみを起動するクライアント

設定ファイルから MCP サーバーを起動し、リモート URL を受け付けないクライアントでは、mcp-remote で接続を中継します：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://youtube-transcript.ai/mcp?key=YOUR_KEY"]
    }
  }
}

エージェントに設定させる

https://youtube-transcript.ai/mcp.md をコーディングエージェントに貼り付けます。AI が実行できるように書かれた、これらの手順のプレーンテキスト版です。

ツールリファレンス

get_youtube_transcript

YouTube 動画の全文文字起こしを取得します。

パラメーター	型	必須	説明
video	string	はい	YouTube URL（watch、youtu.be、ショート、埋め込み形式）、または 11 文字の動画 ID
lang	string	いいえ	字幕の言語コード（例：en、zh-CN、es）。既定のトラックを使う場合は省略します
offset	integer	いいえ	長い文字起こしを続きから取得する位置。前の部分の末尾に示された値を使用します

プレーンテキストで、タイトル、再生時間、利用可能な言語の一覧を含む文字起こしを返します。120,000 文字を超える文字起こしは分割して返され、各部分の末尾には次の呼び出しで使う offset を示すメモが付きます。

プロンプト例

• 「<link> の要点を 5 つの箇条書きでまとめてください。」
• 「この動画の文字起こしを取得して、スペイン語に翻訳してください。」
• 「<link> で話者は価格について何と言っていますか？該当箇所を正確に引用してください。」

プログラムからの利用

このサーバーは、Streamable HTTP 経由の標準 MCP（JSON-RPC）に対応しています。依存関係のないサンプルは examples/quickstart.mjs にあります：

YT_TRANSCRIPT_KEY=YOUR_KEY node examples/quickstart.mjs https://youtu.be/dQw4w9WgXcQ

MCP を使わずに独自のコードから呼び出す場合は、プレーン HTTP エンドポイントも利用できます。YouTube Transcript API を参照してください。

制限

• 無料プラン：1日あたり10リクエスト。Pro：年間120ドルで1日あたり1,000リクエスト。キーのページからアップグレードできます。
• 長い文字起こしの各パートを含め、ツールの呼び出しごとに1リクエストとしてカウントされます。カウントは00:00 UTCにリセットされます。
• 動画には、アップロード者が作成した字幕またはYouTubeが自動生成した字幕が必要です。

注意事項

• YouTubeまたはGoogleとは提携していません。文字起こしは公開されている字幕から取得されます。
• 公式MCP Registryにai.youtube-transcript/youtube-transcriptとして登録されています。

リンク

• Webツール（AIクライアント不要）：https://youtube-transcript.ai
• コネクターのランディングページ：https://youtube-transcript.ai/mcp
• HTTP API：https://youtube-transcript.ai/api

ライセンス

MIT