Lewati ke isi
ID
Dapatkan kunci API

Aliran Kerja / JavaScript

Hubungkan a Node.js MCP klien ke Google Search dan YouTube

Menyambung ke FlashData di atas Streamable HTTP, discover MCP alat, dan mengirim eksplisit Google Search permintaan dari Node.js menggunakan pejabat SDK.

FlashData · Diperbarui

Klien yang terhubung melalui antarmuka bersama untuk mencari dan membuat video

MCP memungkinkan klien discover alat dan memanggil mereka melalui protokol bersama. FlashData mengekspos Google Search dan YouTube perangkat data melalui remote Streammable HTTP titik akhir. Tutorial ini menghubungkan klien Node.js, daftar definisi alat yang tersedia, dan menjalankan pencarian hanya ketika Anda secara eksplisit mengaktifkannya.

Ini adalah panduan integrasi protokol. Jika Anda ingin fungsi Python biasa untuk mendaftar dengan kerangka kerja agen, gunakan Tambahkan Google dan YouTube alat pencarian ke agen AI.

Pasang kunci SDK dan simpan kunci API pada server

Gunakan Node.js 22 atau nanti. Contoh menggunakan pejabat MCP SDK versi telah diverifikasi dalam FlashData dokumentasi. Simpan kunci API dalam suatu lingkungan server; jangan embed dalam sebuah bundel peramban, repositori publik atau MCP titik akhir 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'

Titik akhirnya adalah https://data.flashdata.dev/mcp. Otentikasi memakai X-API-Key tajuk. Anda tidak perlu memulai server FlashData lokal. Koneksi ini menggunakan HTTP yang dapat di-stream-kan, bukan perintah stdio.

Menyambung, memeriksa alat dan mungkin menjalankan satu pencarian

Simpan berkas ini sebagai mcp-search.mjs. Secara default ia memanggil listTools() dan mencetak nama alat yang tersedia dan skema masukan Google Search. Menemukan alat tidak menjalankan kuiri data yang dibayar.

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

argumen MCP adalah datar

REST dan MCP menggambarkan tugas pencarian yang sama dengan bentuk permintaan yang berbeda. Sebuah query REST tempat negara dan kontrol bahasa di dalam params. Sebuah alat MCP menerima gl, hl, num dan page langsung masuk arguments; jangan kirim REST params objek ke alat MCP. Bidang tak dikenal ditolak.

Untuk YouTube, periksa skema alat sebelum membangun panggilan. Sebuah alat transkrip mengambil video_id, language dan auto; auto memilih trek yang otomatis atau uphauder yang telah ada. Ini tidak menghasilkan takarir untuk video yang kurang mereka.

Menangani pekerjaan asinkron dan hasil besar

Gunakan mode: "async" ketika Anda ingin tanda terima pekerjaan bukan hasil real time. Simpan pekerjaan yang kembali ID dan lulus sebagai job_id ke get_job. Pekerjaan yang selesai termasuk respon asli dalam output; hasil tetap untuk 24 jam setelah selesai. Membaca pekerjaan tidak mengirimkan permintaan lagi.

Hasil besar mungkin tiba sebagai potongan teks JSON dengan result_id dan next_offset. Call get_result dengan kunci yang sama dan terus menggunakan ofset yang dikembalikan sampai next_offset adalah null. Konkatenasi potongan dalam rangka sebelum parsing. Batas diukur dalam unit kode UTF- 16, bukan baris atau byte. Cache hasil berlangsung 10 menit, memegang paling banyak empat hasil besar per kunci, dan dapat mengusir hasil lebih cepat.

Untuk memberikan video atau audio ke penyimpanan Anda, panggil youtube_download dengan storage tujuan dan kunci API yang memberikan youtube_download. Simpan pekerjaan yang dikembalikan ID dan jajak pendapat get_job. Untuk pemrosesan Bulk berbasis file-, gunakan API pemrosesan Bulk.

Memperlakukan kegagalan sesuai dengan apa yang terjadi

Pertukaran HTTP yang sukses masih dapat memuat suatu hasil alat dengan isError: true; periksa lapangan itu. Galat alat mempertahankan status upstream yang berguna dan permintaan identifier. Perbaiki argumen, hak akses, atau keseimbangan Kredit sebelum mencoba lagi.

Tenggat waktu atau koneksi hilang tidak membuktikan bahwa permintaan tidak dijalankan. Untuk query_outcome_unknown, Pemeriksaan Permintaan History sebelum mengajukan kembali. Klien ini sengaja tidak memiliki loop coba ulang otomatis sekitar panggilan yang dibayar. respon upstream besar terbatas untuk 4 MiB, jadi mulai dengan jumlah hasil kecil.

Kueri menggunakan harga Credits yang ada, tanpa tambahan biaya MCP. Baca MCP referensi, MCP tinjauan dan Harga sebelum memilih konkueces atau batch ukuran untuk klien produksi.