Langkau ke kandungan
MS
Dapatkan kunci API

Aliran kerja / JavaScript

Klient Node.js MCP untuk Google Search dan YouTube

Sambungkan ke FlashData Ada di bawah aliran sungai HTTP, discover MCP alat-alat, dan mengirim sebuah eksplisit Google Search permintaan dari Node.js Menggunakan pejabat SDK.

FlashData · Dikemas kini

Klien yang terhubung melalui antarmuka bersama untuk mencari dan video alat

MCP memungkinkan klien alat discover dan memanggil mereka melalui protokol terkongsi. Zioza FlashData mengekspos alat data Google Search dan YouTube melalui titik akhir HTTP yang dapat Streamable jauh. Tutorial ini menghubungkan klien Node.js, mencantumkan 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 agen, gunakan Andikaid Google dan YouTube Alat pencarian ke agen AI.

Pasang SDK dan jaga kunci API di server

Use Node.js 22 atau nanti. Contoh ini menggunakan versi resmi MCP SDK yang sudah diverifikasi dalam dokumentasi FlashData. Keep kunci API dalam lingkungan server; jangan disembatkan dalam bundle browser, 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 akhir adalah https://data.flashdata.dev/mcp. Autentifikasi menggunakan atentifikasi X-API-Key header. Anda tidak perlu memulai server FlashData lokal. Sambungan ini menggunakan Streamable HTTP, bukan perintah stdio.

Gnect, periksa alat dan jalankan satu pencarian secara pilihan

Simpan berkas ini sebagai mcp-search.mjs. Secara default itu panggilan listTools() Sidik dan cetak nama alat yang tersedia dan skema masukan Google Search. Alat-alat penemuan tidak melaksanakan pertanyaan data terbayar.

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 rata

¡MCP menggambarkan tugas pencarian yang sama dengan bentuk permintaan yang berbeda. Sebuah tempat pertanyaan RUANG negara dan kontrol bahasa di dalam params. Sebuah alat MCP menerima gl, hl, num Dan page Secara langsung dalam arguments; jangan kirim REST params Objek ke alat MCP. Medan yang tidak diketahui ditolak.

Untuk YouTube, periksa skema alat sebelum membuat panggilan. Alat transkrip diperlukan video_id, language Dan auto; auto Medis memilih jalur otomatis atau uploader-provided yang ada. Ia tidak menghasilkan kapsi untuk video yang kurang mereka.

Kejayaan dan hasil yang besar

Guna mode: "async" Haqer ketika Anda ingin penerimaan pekerjaan bukan hasil realtime. Tetap kembalikan pekerjaan ID dan luluskan sebagai job_id Ke get_job. Pekerjaan yang sudah selesai termasuk respon asli dalam output; Hasil dikekalkan untuk 24 jam setelah selesai. Pembacaan pekerjaan tidak mengajukan pertanyaan lagi.

Hasil besar mungkin tiba sebagai potongan teks JSON dengan result_id Dan next_offset. Panggilan get_result affine dengan kunci yang sama dan terus menggunakan ofset yang dikembalikan sampai next_offset null. Bagian konkatenasi untuk dikonkatenasi sebelum dihurai. Batasan tersebut diukur dalam satuan kode UTF-16, bukan baris atau byte. Cache hasil freast berlangsung 10 menit, memegang paling banyak empat hasil besar per kunci, dan dapat mengusir hasil lebih cepat.

Untuk mengirimkan video atau audio ke penyimpanan Anda, panggilan youtube_download dengan satu storage Tujuan dan kunci API yang memberikan youtube_download. Simpan pekerjaan yang dikembalikan ID dan jajak pendapat get_job. Untuk pemrosesan Bulk berbasis berkas, gunakan API pemprosesan Bulk.

Perlakuan kegagalan menurut apa yang terjadi

Pertukaran HTTP yang sukses masih dapat memuat hasil alat dengan isError: true; Periksa lapangan itu. Kesalahan alat-alat alat-alat tool tool retain berguna status huluan dan permintaan identifier. Eqxex memperbaiki argumen tidak sah, izin atau saldo kredit sebelum mencoba lagi.

Sebuah tenggat waktu atau sambungan hilang tidak membuktikan bahwa sebuah pertanyaan tidak dilakukan. * Untuk * query_outcome_unknown, Inspeksi Permintaan History sebelum pengiriman kembali. Klien ini sengaja tidak memiliki retry loop otomatis sekitar panggilan alat berbayar. Tanggapan hulu besar yang terbatas pada 4Q MiB, sehingga dimulai dengan jumlah hasil yang kecil.

Kekhawatiran menggunakan harga kredit Anda yang sudah ada, tanpa biaya tambahan MCP. Bacalah referensi MCP, MCP SECARA ORANG ORANG ORANG Dan Keunggulan ¡Cufford sebelum memilih ukuran konkurensi atau batch untuk klien produksi.