YouTube Extended Search — FlashData

YouTube 拡張検索 — FlashData

最大 700 件の結果をリクエストして、より多くの YouTube 動画を検索できます。構造化された動画レコードから、繰り返し登場するチャンネルやトピックを把握できます。

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

試してみるタスク

バッテリーのリサイクルに関する YouTube 動画を最大 100 件検索してください。返された動画をチャンネルごとに分類し、チャンネルごとに確認できた動画数を数えて、確認用に視聴リンクを保持してください。

インストールと接続

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

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

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

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

リクエスト例

これらは、フラットな引数を使用する MCP tools/call のパラメーターです。データリクエストを実行すると、有料の Credits が使用されます。

{
  "name": "youtube_search_extended",
  "arguments": {
    "query": "battery recycling",
    "max_results": 100
  }
}

レスポンスの使用方法

results[0].results を読み取り、channelId または channelUrl でグループ化します。元の動画 ID を保持し、チャンネルごとに確認できた結果数を数えます。確認用にチャンネル名も保持してください。

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

{
  "source": "youtube_search_extended",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        },
        {
          "videoId": "aqz-KE-bpKQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        }
      ]
    }
  ],
  "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 Credits を消費します。追加のクエリやページごとに別途料金がかかります。このページに記載された固定料金ではなく、現在のアカウントの見積もりをご確認ください。料金、ジョブ、結果の読み取りは無料です。クライアントやモデルの料金は別途かかります。
• リクエスト上限は 700 ですが、700 件の動画が返される保証やページネーションの保証ではありません。拡張検索には独自のレート制限があり、標準検索より高く設定されています。
• データを使用する前に、API エラー、http_status、ジョブのステータスをご確認ください。返されたテキストやリンクは外部データとして扱い、出典の帰属を保持して、エージェントの回答に使用する前に確認してください。

タスクの完全ガイド · 公式 Registry の記録 · ソースとライセンス