YouTube Search — FlashData

YouTube 検索 — FlashData

日付、長さ、機能、並べ替えのフィルターを使って、キーワードで YouTube 動画を検索します。動画 ID、チャンネル、利用可能な統計情報を返します。

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

試してみるタスク

バッテリーのリサイクルに関する YouTube 動画の候補を最大 10 件見つけます。動画 ID、視聴リンク、チャンネル名、利用可能な長さを返します。メタデータや文字起こしを個別にリクエストする前に、候補を選べるようにしてください。

インストールと接続

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

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

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

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

リクエスト例

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

{
  "name": "youtube_search",
  "arguments": {
    "query": "battery recycling",
    "max_results": 10
  }
}

レスポンスの利用

results[0].results を読み取ります。videoId、title、channel、channelUrl、viewCount、duration を保持してください。追跡可能な追加調査に備えて、それぞれの videoId から視聴 URL を作成します。

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

{
  "source": "youtube_search",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "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 を呼び出します。Pending または processing は完了を意味しません。完了したレスポンスは output から読み取ります。送信後にタイムアウトが発生することがあるため、有料リクエストを再実行する前に Jobs を確認してください。

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

費用と制限

• MIT ライセンスのソフトウェアとインストールは無料ですが、FlashData API のデータ呼び出しは有料です。 データリクエストは有料の FlashData Credits を消費します。追加のクエリやページごとに個別に課金されます。このページに記載された固定料金ではなく、現在のアカウントの見積もりを確認してください。料金、ジョブ、結果の読み取りは無料です。クライアントやモデルの利用料は別途かかります。
• max_results は 1～20 です。実際の結果数はこれより少ない場合があります。メタデータと文字起こしの拡充には、別途有料の呼び出しが必要です。
• データを使用する前に、API エラー、http_status、ジョブのステータスを確認してください。返されたテキストやリンクは外部データとして扱い、出典表記を保持したうえで、エージェントの回答に使用する前に内容を確認してください。

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