YouTube Metadata — FlashData

YouTube Metadata — FlashData

YouTube 動画の詳細、説明、統計情報、利用可能なチャプターを読み取ります。フォーマットを確認したり、タイムスタンプ付きのチャプターナビゲーションを作成したりできます。

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

試してみるタスク

この動画を確認し、タイトル、説明、利用可能なチャプターの開始時刻を含むチャプターナビゲーション用の概要を作成してください。チャプターがない場合は、タイムラインを推測せず、欠落していることを示してください。

インストールと接続

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

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

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

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

リクエスト例

以下は、フラットな引数を指定した MCP tools/call のパラメーターです。データリクエストの実行には有料のクレジットを使用します。

{
  "name": "youtube_metadata",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "include_formats": false,
    "include_chapters": true
  }
}

レスポンスの使用

results[0] を読み取り、タイトル、説明、存在する場合はチャプターを確認してください。チャプターの start_time/end_time と動画の視聴 URL を組み合わせて、ナビゲーション用の概要を作成します。

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

{
  "source": "youtube_metadata",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "title": "Example video",
      "channel": "Example",
      "channelId": "channel-one",
      "channelUrl": "https://www.youtube.com/@Example",
      "viewCount": 100,
      "duration": 90,
      "chapters": [
        {
          "title": "Introduction",
          "start_time": 0,
          "end_time": 30
        }
      ],
      "description": "Example description"
    }
  ],
  "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 を解析する前に、チャンクを順番どおりに連結します。有料データリクエストを繰り返さないでください。ローカルキャッシュには最大 4 件の結果が 10 分間保持され、再起動すると消去されます。完全なレスポンスの上限は 4 MiB です。非同期の JSON 結果には、別途 24 時間の保持期間が適用されます。

費用と制限

• MIT ソフトウェアとインストールは無料ですが、FlashData API のデータ呼び出しは有料です。 データリクエストには有料の FlashData クレジットを使用します。追加のクエリやページごとに別途料金が発生します。このページに記載された固定料金ではなく、現在のアカウント見積もりを使用してください。料金、ジョブ、結果の読み取りは無料です。クライアントやモデルの料金は別途発生します。
• フィールドやチャプターが存在しない場合があります。メタデータにトランスクリプトは含まれません。トランスクリプトの取得には別途有料の呼び出しが必要です。
• データを使用する前に、API エラー、http_status、ジョブのステータスを確認してください。返されたテキストやリンクは外部データとして扱い、出典表記を維持したうえで、エージェントの回答に使用する前に確認してください。

タスクガイド全文 · 公式 Registry レコード · ソースとライセンス