सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें

वर्कफ़्लो / JavaScript

Node.js MCP क्लाइंट को Google Search और YouTube को कनेक्ट करें

FlashData को स्ट्रीम करने योग्य HTTP, discover MCP टूल पर कनेक्ट करें और आधिकारिक SDK का उपयोग करके Node.js से एक स्पष्ट Google Search अनुरोध भेजें।

FlashData · अपडेट किया गया

एक ग्राहक खोज और वीडियो उपकरण के लिए एक साझा इंटरफ़ेस से जुड़ा हुआ है

MCP एक क्लाइंट discover टूल देता है और उन्हें साझा प्रोटोकॉल के माध्यम से बुलाता है। FlashData एक दूरस्थ स्ट्रीम करने योग्य HTTP समापन बिंदु के माध्यम से Google Search और YouTube डेटा उपकरण को उजागर करता है। यह ट्यूटोरियल एक Node.js क्लाइंट को जोड़ता है, उपलब्ध टूल परिभाषाओं को सूचीबद्ध करता है, और जब आप स्पष्ट रूप से इसे सक्षम करते हैं तो केवल एक खोज चलाता है।

यह एक प्रोटोकॉल एकीकरण गाइड है। यदि आप एजेंट फ्रेमवर्क के साथ पंजीकरण करने के लिए साधारण Python फ़ंक्शन चाहते हैं, तो उपयोग करें एक AI एजेंट को Google और YouTube खोज उपकरण जोड़ें.

SDK स्थापित करें और सर्वर पर API कुंजी को रखें

Node.js 22 या बाद में प्रयोग करें। उदाहरण आधिकारिक MCP SDK संस्करण का उपयोग पहले से ही FlashData प्रलेखन में सत्यापित किया गया है। एक सर्वर वातावरण में 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 सर्वर शुरू करने की आवश्यकता नहीं है। यह कनेक्शन स्ट्रीम करने योग्य HTTP का उपयोग करता है, एक stdio कमांड नहीं है।

कनेक्ट करें, टूल का निरीक्षण करें और वैकल्पिक रूप से एक खोज चलाएं

इस फाइल को सेव करें 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 विभिन्न अनुरोध आकृतियों के साथ एक ही खोज कार्य का वर्णन करते हैं। A REST क्वेरी स्थान देश और भाषा नियंत्रण अंदर params. एक MCP उपकरण प्राप्त करता है gl, hl, num और page सीधे arguments; REST (REST) नहीं भेजिए params MCP टूल पर ऑब्जेक्ट करें। अज्ञात क्षेत्रों को अस्वीकार कर दिया जाता है।

YouTube के लिए, कॉल बनाने से पहले टूल स्कीमा का निरीक्षण करें। एक ट्रांसक्रिप्ट टूल लेता है video_id, language और auto; auto मौजूदा स्वचालित या अपलोडर-प्रदत्त ट्रैक का चयन करता है। यह एक वीडियो के लिए कैप्शन उत्पन्न नहीं करता है जिसमें उन्हें कमी है।

अतुल्यकालिक नौकरियों और बड़े परिणामों को संभालना

उपयोग mode: "async" जब आप वास्तविक समय के परिणाम के बजाय नौकरी प्राप्त करना चाहते हैं। लौटाने वाला काम ID रखें और इसे पास करें। job_id to get_job. पूर्ण नौकरियों में मूल प्रतिक्रिया शामिल है output; परिणाम पूरा होने के बाद 24 घंटे के लिए बनाए रखा जाता है। एक नौकरी पढ़ना फिर से क्वेरी प्रस्तुत नहीं करता है।

बड़े परिणाम एक JSON टेक्स्ट चंक के रूप में आ सकते हैं result_id और next_offset. कॉल get_result एक ही कुंजी के साथ और वापसी की ऑफसेट का उपयोग जारी रखने तक next_offset है null. पार्सिंग से पहले क्रम में अलग-अलग हिस्से। सीमा UTF-16 कोड इकाइयों, पंक्तियों या बाइट्स में मापा जाता है। परिणाम कैश 10 मिनट तक रहता है, प्रति कुंजी में चार बड़े परिणाम रखता है, और जल्द ही परिणाम प्राप्त कर सकता है।

अपने भंडारण के लिए वीडियो या ऑडियो प्रदान करने के लिए, कॉल करें youtube_download एक साथ storage गंतव्य और एक API कुंजी जो youtube_download प्रदान करती है। लौटे हुए काम को बचाओ ID और मतदान get_job. फ़ाइल आधारित Bulk प्रसंस्करण के लिए, उपयोग करें Bulk प्रोसेसिंग API.

क्या हुआ के अनुसार विफलताओं का इलाज

एक सफल HTTP एक्सचेंज में अभी भी एक टूल परिणाम हो सकता है isError: true; उस क्षेत्र की जाँच करें। टूल त्रुटियां उपयोगी अपस्ट्रीम स्थिति और अनुरोध पहचानकर्ता को बनाए रखती हैं। फिर से कोशिश करने से पहले अवैध तर्कों, अनुमतियों या क्रेडिट संतुलन को ठीक करें।

एक टाइमआउट या खोए हुए कनेक्शन यह साबित नहीं करता कि एक क्वेरी को निष्पादित नहीं किया गया था। के लिए query_outcome_unknown, Resubmitting से पहले, अनुरोध History का निरीक्षण करें। इस ग्राहक के पास जानबूझकर भुगतान किए गए टूल कॉल के आसपास कोई स्वचालित रिट्री लूप नहीं है। बड़े अपस्ट्रीम प्रतिक्रियाओं को 4 MiB तक सीमित किया जाता है, इसलिए एक छोटे परिणाम की गिनती के साथ शुरू होता है।

Queries अपने मौजूदा क्रेडिट मूल्य निर्धारण का उपयोग करते हैं, जिसमें कोई अतिरिक्त MCP चार्ज नहीं होता है। पढ़ना MCP संदर्भ, MCP अवलोकन और मूल्य निर्धारण एक उत्पादन ग्राहक के लिए सहमति या बैच के आकार चुनने से पहले।