YouTube Autocomplete — FlashData

YouTube オートコンプリート — FlashData

クエリの先頭部分、言語、地域を指定して、YouTube の検索候補を取得します。実際のオートコンプリートフレーズからキーワードのアイデアシートを作成できます。

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

試してみるタスク

米国で「battery recycling」に対する英語の YouTube オートコンプリート候補を取得してください。フレーズの重複を除いてトピックのアイデアシートにまとめ、クエリの先頭部分、言語、地域を保持してください。

インストールと接続

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

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

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

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

リクエスト例

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

{
  "name": "youtube_suggestions",
  "arguments": {
    "query": "battery recycling",
    "language": "en",
    "region": "US"
  }
}

レスポンスの使用方法

results[0] の候補文字列を読み取ります。調査シートには、元のクエリの先頭部分、言語、地域、取得時刻を保持したまま、フレーズの重複を除いて記載してください。

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

{
  "source": "youtube_suggestions",
  "status": "done",
  "results": [
    [
      "battery recycling at home",
      "battery recycling safely"
    ]
  ],
  "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 を消費します。クエリやページを追加するたびに別途料金がかかります。このページから固定料金を引用するのではなく、現在のアカウント見積もりを確認してください。料金、ジョブ、結果の読み取りは無料です。クライアント／モデルの料金は別途かかります。
• オートコンプリートが返すのはフレーズであり、動画の検索結果や検索ボリュームの推定値ではありません。候補は需要の大きさを示す証拠ではありません。
• データを使用する前に、API エラー、http_status、ジョブの状態を確認してください。返されるテキストやリンクは外部データとして扱い、出典の帰属を保持したうえで、エージェントの回答で使用する前に確認してください。

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