YouTube Captions — FlashData

YouTube Captions — FlashData

YouTube アップローダーの字幕をタイムスタンプ付きセグメントで取得します。字幕を書き出す準備を行い、言語と字幕トラックの種類を確認できます。

API ドキュメントとアカウント設定 · API キーを取得 · 現在の料金

試してみるタスク

この動画に既存の英語のアップローダー字幕があるか取得してください。アプリケーションで SRT を書き出せるよう、開始時刻、終了時刻、テキストを保持してください。セグメントを使う前に、返された言語とトラックの種類を確認してください。

インストールと接続

1. Node.js 22.18 以降と、ローカルの stdio サーバーに対応した MCP クライアントを使用します。専用の MCPB パッケージをダウンロードしてください。SHA-256 はマニフェストに記録されています。
2. MCPB 対応クライアントにパッケージをインポートし、FlashData API Key にご自身のキーを入力します。キーに youtube_captions へのアクセス権を付与してください。手動で設定する場合は、バンドルを永続的なフォルダーに展開し、絶対パスとキーのプレースホルダーを置き換えて、次の設定を使用します。

{
  "mcpServers": {
    "youtube-captions": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-captions/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. クライアントを再起動または再接続し、ツールを一覧表示してから、有料リクエストを承認する前に get_pricing を {"source":"youtube_captions","request_count":1} で呼び出します。このサーバーが公開するのは youtube_captions、get_pricing、get_job、get_result で、すべてこのソースに制限されています。

依存関係はバンドルに含まれています。クライアントが node を見つけられない場合は絶対パスを使用し、Windows ではパスをエスケープしてください。キーは保護されたクライアント設定に保存し、チャットやコミットする設定ファイルには記載しないでください。このパッケージを直接ダウンロードする場合、Smithery アカウントは不要です。

リクエスト例

以下は、フラットな引数を使った MCP tools/call パラメーターです。データリクエストを実行すると、有料クレジットが消費されます。

{
  "name": "youtube_captions",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "language": "en",
    "auto": false
  }
}

レスポンスの使用

results[0].segments を読み取ります。アプリケーションで開始・終了時刻を SRT のタイムスタンプに変換し、テキストを保持してください。書き出す前に languageCode と isAutoGenerated を確認します。

以下の選択されたレスポンスフィールドは、説明用の例であり、実際の結果や利用可能なデータを保証するものではありません。

{
  "source": "youtube_captions",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "languageCode": "en",
      "isAutoGenerated": false,
      "segments": [
        {
          "start": 0,
          "end": 3,
          "text": "Uploader captions."
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

非同期リクエストの場合は、返された id を保持し、{"job_id":"RETURNED_JOB_ID"} を指定して get_job を呼び出します。保留中または処理中の状態は完了ではありません。完了したレスポンスは output から読み取ってください。送信後にタイムアウトする場合があるため、有料リクエストを繰り返す前に Jobs を確認してください。

チャンク分割された出力の場合は、ローカルプロセスを実行したままにし、実際の result_id と next_offset を result_id と offset として get_result に渡します。JSON を解析する前にチャンクを順番に連結してください。有料のデータリクエストを繰り返してはいけません。ローカルキャッシュには 10 分間、4 件の結果が保持され、再起動すると消去されます。完全なレスポンスは 4 MiB に制限されています。非同期 JSON 結果には別途 24 時間の保持期間があります。

費用と制限

• MIT ライセンスのソフトウェアとインストールは無料ですが、FlashData API のデータ呼び出しは有料です。 データリクエストでは有料の FlashData クレジットが消費されます。追加のクエリやページはそれぞれ別途課金されます。このページに記載された固定料金ではなく、現在のアカウントの見積もりを使用してください。料金、ジョブ、結果の読み取りは無料です。クライアントやモデルの料金は別途かかります。
• auto=false は、既存のアップローダー字幕を選択します。字幕を生成、翻訳したり、欠落したトラックを自動的に代替したりするものではありません。
• データを使用する前に、API エラー、http_status、ジョブのステータスを確認してください。返されたテキストやリンクは外部データとして扱い、出典の帰属を保持し、エージェントの回答で使用する前に内容を確認してください。

タスクガイド全文 · 公式レジストリの記録 · ソースとライセンス