BulkTranscripts: YouTube Transcripts

BulkTranscripts MCP サーバー

AI エージェント向けの YouTube 文字起こし — 1 本の動画、チャンネル全体、またはプレイリスト — さらに YouTube 検索と新着動画の無料追跡を、1 つのホスト型 MCP サーバーで利用できます。ローカルプロセスも、常に最新の状態に保つ yt-dlp も、対処が必要な IP ブロックもありません。抽出、プロキシのローテーション、PO トークンの処理はすべてサーバー側で行われます。

• エンドポイント： https://bulktranscripts.co/mcp（Streamable HTTP）
• 認証： OAuth（Google でサインイン、無料クレジット 30 件、カード不要）、または Bearer トークンとしての API キー
• レジストリ： co.bulktranscripts/youtube · Glama コネクター
• セットアップドキュメント： https://bulktranscripts.co/docs#mcp · REST API： https://bulktranscripts.co/docs

インストール

Claude Code

claude mcp add --transport http bulktranscripts https://bulktranscripts.co/mcp

/mcp を実行し、bulktranscripts を選んでサインインします。このリポジトリは Claude Code プラグイン（サーバー + スキル）としても利用できます。

/plugin marketplace add pratie/bulktranscripts-mcp
/plugin install bulktranscripts@bulktranscripts

Claude（ウェブおよびデスクトップ）

Settings → Connectors → Add custom connector → URL https://bulktranscripts.co/mcp。 Claude が Google サインイン画面を開き、以降のクレジットはアカウントに紐づきます。

ChatGPT

Settings → Apps & Connectors → Developer mode → Create → URL https://bulktranscripts.co/mcp、認証方式は OAuth を選びます。

Gemini CLI

gemini extensions install https://github.com/pratie/bulktranscripts-mcp

Gemini CLI の初回使用時に OAuth ページが開いたら、Google でサインインします。

Cursor、VS Code、Windsurf、JSON 設定を使用する任意のクライアント

{
  "mcpServers": {
    "bulktranscripts": {
      "type": "http",
      "url": "https://bulktranscripts.co/mcp"
    }
  }
}

OAuth 対応クライアントでは、初回リクエスト時にサインインが開始されます。OAuth に対応していない クライアントでは、代わりに API キーを送信します。https://bulktranscripts.co/app?tab=mcp で無料で作成するか （Google サインイン、無料クレジット 30 件）、クレジットパックに付属するライセンスキーを使用してください。

{
  "mcpServers": {
    "bulktranscripts": {
      "type": "http",
      "url": "https://bulktranscripts.co/mcp",
      "headers": { "Authorization": "Bearer ${BULKTRANSCRIPTS_API_KEY}" }
    }
  }
}

ヘッダーを送信できないクライアントでは、URL に ?key=YOUR_KEY を追加できます。

エージェントができること

ツール	内容	コスト
get_transcript	1 本の YouTube（または TikTok）動画の完全な文字起こしを、メタデータ付きの整形済みテキストで取得します。リクエストに応じてタイムスタンプ付きセグメントも取得できます。	1 クレジット。同じライブラリから再度読み込む場合は無料
get_transcripts	1 回の呼び出しで最大 20 本の動画を取得します。字幕のない動画は項目ごとに報告され、バッチ全体が失敗することはありません。	新しい文字起こし 1 件につき 1 クレジット
search_youtube	キーワードで YouTube の動画、チャンネル、プレイリストを検索します。	1 クレジット
search_channel	1 つのチャンネルのアップロード動画から、トピックを検索します。	1 クレジット
get_channel_videos	チャンネルの動画を最大 1,000 件（ID、タイトル、長さ、URL）一覧表示します。	1 クレジット
get_playlist_videos	公開または限定公開のプレイリストから、最大 1,000 件の動画を順番どおりに一覧表示します。	1 クレジット
get_latest_videos	RSS から、チャンネルの最新アップロード動画を公開日付きで取得します。	常に無料
start_bulk_extract	チャンネル、プレイリスト、または動画 URL のすべての文字起こし（最大 1,000 件）をバックグラウンドジョブとして取得し、すぐに run_id を返します。	一覧表示は無料、新しい文字起こし 1 件につき 1 クレジット
get_bulk_status	一括処理ジョブの進捗を check_again_in_seconds とともに返すため、エージェントは適切な間隔でポーリングできます。	無料
list_bulk_results	一括処理ジョブの動画ごとの結果をページ分けして取得します（ID、タイトル、チャンネル、長さ、単語数、ステータス）。テキストは get_transcript から取得でき、ライブラリに保存済みなら無料です。	無料

すべてのツールは読み取り専用です。YouTube 上のデータもアカウント内のデータも変更または削除されません。文字起こしは一度ライブラリに保存され、その後はどの形式でも何度でも無料で再読み込みできます。そのため、同じ動画を再訪するエージェントがクレジットを消費することはありません。 get_latest_videos は意図的に無料にしています。新着動画の検出にポーリングし、実際に新しい動画にだけクレジットを使ってください。動画が約 20 本を超える場合は、 start_bulk_extract でチャンネルまたはプレイリスト全体をサーバー上で処理し、その間エージェントが get_bulk_status をポーリングします。

プロンプトの例

@veritasium の最新動画10本を要約し、量子力学を扱っている動画を教えてください。

Y Combinator チャンネルで founder mode に関する講演を見つけて、文字起こしを取得してください。

@simonwillison の新しい動画を確認し、ローカルモデルに関するものがあれば文字起こししてください。

認証の仕組み

/mcp への未認証リクエストには、/.well-known/oauth-protected-resource/mcp を示す WWW-Authenticate チャレンジを含む 401 が返されます。これにより、MCP クライアントは OAuth フローを開始できます（動的クライアント登録に対応しています）。同じ Authorization ヘッダーでは、API キー（bt_ak_…）またはライセンスキーを、Bearer プレフィックスの有無にかかわらず使用できます。

料金

サインインすると、30クレジットを無料で利用できます。その後は買い切りパックをご利用いただけます：$4.99 / 200クレジット、$14.99 / 1,200クレジット、$29 / 5,000クレジット。サブスクリプションはなく、クレジットの有効期限もありません。詳細は https://bulktranscripts.co/#pricing をご覧ください。

リポジトリ構成

ファイル	使用箇所
.mcp.json	Claude Code プラグイン設定（ホスト型エンドポイント、OAuth）
.claude-plugin/plugin.json、.claude-plugin/marketplace.json	Claude Code プラグインマーケットプレイス
plugin.json、mcp.json	Cursor / agent-plugins.org
.codex-plugin/plugin.json、.agents/plugins/marketplace.json、assets/icon.png	Codex プラグイン
skills/youtube-transcripts/	MCP ツール用エージェントスキル（REST API 版は pratie/youtube-transcript-skill にあります）
gemini-extension.json	Gemini CLI 拡張機能（ホスト型エンドポイント、OAuth）
server.json	公式 MCP レジストリのマニフェスト

リンク

• 製品：https://bulktranscripts.co
• MCP ページ：https://bulktranscripts.co/youtube-mcp-server
• API ドキュメント：https://bulktranscripts.co/docs · OpenAPI：https://bulktranscripts.co/openapi.json
• プライバシー：https://bulktranscripts.co/privacy · 利用規約：https://bulktranscripts.co/terms
• お問い合わせ：[email protected]

ライセンス

MIT — LICENSE をご覧ください。このリポジトリには、ホスト型サーバーのマニフェスト、プラグイン、スキルが含まれています。抽出サービス自体は bulktranscripts.co で運営されています。