コンテンツへスキップ
JA
APIキーを取得する

ワークフロー / JavaScript

Node.js MCPクライアントをGoogle SearchとYouTubeに接続

接続する FlashData ストリーミング可能 HTTP, discover MCP ツール、および明示的な送信 Google Search リクエストから Node.js 公式サイト SDK.

FlashData · 更新情報

共有インターフェイスを介して接続されたクライアントは、検索とビデオツールにつながります

MCP はクライアント discover ツールを割り当て、共有プロトコルを介して呼び出します。 FlashData は、Google Search と YouTube のデータツールをリモート・ストリーム可能な HTTP エンドポイントで公開します。 このチュートリアルでは、Node.jsクライアントを接続し、利用可能なツールの定義を一覧表示し、明示的に有効化したときにのみ検索を実行します。

これはプロトコル統合ガイドです。 通常の Python 関数をエージェントフレームワークに登録したい場合、 GoogleとYouTubeの検索ツールをAIエージェントに追加.

SDKをインストールし、APIキーをサーバーに保存します。

Node.js 22 以上を使用してください。 例では、FlashData ドキュメントで既に検証済みの公式 MCP SDK 版を使用しています。 APIキーをサーバー環境に保ちます。ブラウザバンドル、パブリックリポジトリ、MCPエンドポイントURLに埋め込むことはできません。

bash
mkdir flashdata-mcp-client
cd flashdata-mcp-client
npm init -y
npm install @modelcontextprotocol/[email protected]
export FLASHDATA_API_KEY='your-api-key'

エンドポイントは https://data.flashdata.dev/mcp. 認証は、 X-API-Key ヘッダ。 ローカルFlashDataサーバを起動する必要はありません。 この接続は、stdioコマンドではなく、HTTPをストリーム可能にします。

接続、検査ツール、オプションで1つの検索を実行

このファイルを保存する mcp-search.mjs. デフォルトでは、呼び出しを呼び出します listTools() 利用可能なツール名とGoogle Search入力スキーマを印刷します。 ツールの発見は、有料のデータクエリを実行しません。

javascript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const key = process.env.FLASHDATA_API_KEY;
if (!key) throw new Error("Set FLASHDATA_API_KEY first.");
const client = new Client({ name: "search-example", version: "1.0.0" });
try {
  await client.connect(new StreamableHTTPClientTransport(
    new URL("https://data.flashdata.dev/mcp"),
    { requestInit: { headers: { "X-API-Key": key } } },
  ));
  const { tools } = await client.listTools();
  console.log("Available tools:", tools.map(tool => tool.name));
  const search = tools.find(tool => tool.name === "google_search");
  if (!search) throw new Error("google_search is not available to this client.");
  console.log("Search input schema:", JSON.stringify(search.inputSchema, null, 2));
  if (process.env.RUN_SEARCH === "1") {
    const result = await client.callTool({
      name: "google_search",
      arguments: { query: process.env.SEARCH_QUERY ?? "MCP protocol",
        gl: "us", hl: "en", num: 3, page: 1, mode: "realtime" },
    });
    if (result.isError) {
      console.error(JSON.stringify(result, null, 2));
      process.exitCode = 1;
    } else {
      console.log(JSON.stringify(result, null, 2));
    }
  } else {
    console.log("Discovery complete. Set RUN_SEARCH=1 to submit a billable query.");
  }
} finally {
  await client.close();
}
bash
node mcp-search.mjs
# Run only when you are ready to submit a search using account Credits:
RUN_SEARCH=1 SEARCH_QUERY='MCP protocol' node mcp-search.mjs

MCP 引数はフラット

REST と MCP は、異なるリクエスト形状で同じ検索タスクを記述します。 REST クエリは、国と言語の制御を内部に配置します。 params. MCP ツールが受け取る gl, hl, num とりあえず page 直接に arguments; REST を送信しない params MCPツールにオブジェクト。 未知のフィールドは拒否されます。

YouTube では、呼び出しをする前にツールスキーマを調べます。 トランスクリプト ツールは video_id, language とりあえず auto; auto 既存の自動またはアップローダーが付与されたトラックを選択します。 欠けている動画のキャプションを生成しません。

非同期ジョブと大きな結果を処理する

利用条件 mode: "async" リアルタイムの結果ではなく、ジョブレシートが必要な場合。 返されたジョブの ID を保ち、そのまま渡して下さい job_id へ へ へ へ get_job. 完了したジョブには、元の応答が含まれている output; 結果は完了の後で24時間のために保持されます。 ジョブの読み込みは、再度クエリを送信しません。

大きい結果はJSONのテキストのチャンクとしてと着きます result_id とりあえず next_offset. コールセンター get_result 同じキーで、返されたオフセットをまで使用し続ける next_offset null です。 解析前の順にチャンクを連結します。 UTF-16コード単位、行やバイト単位では制限が測定されます。 結果キャッシュは、10分を持続し、キーごとに4つの大きな結果を保持し、結果をすぐに回避することができます。

ビデオやオーディオをストレージに配信するには、電話 youtube_download とりあえ storage youtube_downloadを付与するAPIキーと宛先。 返されたジョブの保存 ID と poll get_job. ファイルベースのBulk処理のために、使用して下さい Bulk 処理 API.

何が起こったかに従って失敗を扱います

HTTP交換が成功すると、ツール結果が付いても使用できます。 isError: true; そのフィールドを確認してください。 ツールのエラーは、有用な上流のステータスと識別子を保持します。 無効な引数、パーミッション、またはクレジット残高を再度試行する前に修正します。

タイムアウトや紛失した接続は、クエリが実行されていないことを証明しません。 のために query_outcome_unknown, 、再登録の前に要求Historyを点検して下さい。 このクライアントは、有料のツールコールの周りの自動リトライループを持っていません。 4 MiB には、大きなアップストリーム応答が限られているため、小さな結果カウントで開始します。

Queries は既存のクレジット価格設定を使用し、MCP の追加料金は使用しません。 読む MCP リファレンス, MCPの概要 とりあえず プライシング 生産の顧客のためのconcurrencyかバッチ サイズを選ぶ前に。