ytranscript-mcp

ytranscript-mcp

Claude、Cursor、VS Code、その他の AI ツールに、あらゆる YouTube 動画の文字起こしを提供する MCP サーバーです。

• どこからでも利用できます。 AWS、Lambda、Vercel、n8n Cloud などのクラウドホストで問題なく動作します。プロキシを購入したり、IP 制限を回避したりする必要はありません。YouTube は文字起こしのリクエストに対して、ほとんどのクラウド IP をブロックしますが、yTranscript API がその問題に対処します。
• 字幕のない動画にも対応します。 動画に字幕がない場合は、AI 音声認識で文字起こしします。
• デフォルトでは、実際に話されている言語を返します。 自動吹き替えされた動画も対象です。lang を指定すると、特定の字幕トラックを選択できます。
• 長い動画も扱いやすくできます。 プレーンテキストまたはタイムスタンプ付きの行を選び、長さに上限を設定すれば、2 時間の動画でモデルのコンテキストがあふれるのを防げます。

セットアップ

1. ytranscript.com/developers で無料の API キーを取得します。無料プランには月 50 ユニットが含まれ、カードは不要です。
2. 以下の設定のいずれかを使って、サーバーをクライアントに追加します。

Claude Code

claude mcp add ytranscript -e YTRANSCRIPT_API_KEY=yk_live_your_key -- npx -y ytranscript-mcp

Claude Desktop

claude_desktop_config.json に追加します。Settings → Developer → Edit Config から開いてください。

{
  "mcpServers": {
    "ytranscript": {
      "command": "npx",
      "args": ["-y", "ytranscript-mcp"],
      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "ytranscript": {
      "command": "npx",
      "args": ["-y", "ytranscript-mcp"],
      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "ytranscript": {
      "command": "npx",
      "args": ["-y", "ytranscript-mcp"],
      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
    }
  }
}

stdio サーバーを実行できる他の MCP クライアントも同様に、YTRANSCRIPT_API_KEY を設定して npx -y ytranscript-mcp を実行します。

ツール：get_transcript

引数	必須	説明
video	はい	YouTube の URL（watch、youtu.be、shorts、embed）または 11 文字の動画 ID
lang	いいえ	取得する字幕トラックの言語コード（en や es など）。省略すると、動画の元の言語を取得します
format	いいえ	text（デフォルト）はプレーンテキストを返します。timestamped は各セグメントを [m:ss] の時刻付きで 1 行ずつ返します
max_characters	いいえ	この文字数を目安に文字起こしを切り詰めます。省略された文字数はレスポンスに記載されます

アシスタントへの依頼例：

• 「この動画を要約してください：https://youtu.be/...」
• 「話者は料金について何と言っていますか？また、その箇所のタイムスタンプは？」
• 「このスペイン語の動画の文字起こしを取得して、英語に翻訳してください。」

すべてのレスポンスの末尾には、使用したユニット数と月間合計が表示されるため、利用状況を確認できます。

料金

字幕付き動画の文字起こしは 1 ユニットです。字幕のない動画を AI で文字起こしする場合は 15 ユニットです。失敗したリクエストは無料です。

プラン	価格	月間ユニット数
Free	$0	50
Starter	$9/mo	1,000
Developer	$29/mo	10,000
Scale	$79/mo	50,000

詳細は ytranscript.com/developers をご覧ください。

関連項目

• ytranscript-api は、このサーバーの基盤となっている JavaScript/TypeScript クライアントです。

ライセンス

MIT