تخطَّ إلى المحتوى
AR
الحصول على مفتاح API

تدفقات العمل / JavaScript

اربط عميل MCP في Node.js ببحث Google وYouTube

اتصل بـ FlashData عبر Streamable HTTP، واكتشف أدوات MCP، ثم أرسل طلب Google Search صريحًا من Node.js باستخدام SDK الرسمي.

FlashData · آخر تحديث

عميل متصل من خلال واجهة مشتركة مع أدوات البحث والفيديو

يتيح MCP للعميل اكتشاف الأدوات واستدعاءها عبر بروتوكول مشترك. تعرض FlashData أدوات Google Search وبيانات YouTube عبر نقطة Streamable HTTP بعيدة. يربط هذا الدليل عميل Node.js، ويسرد تعريفات الأدوات المتاحة، وينفّذ بحثًا فقط عندما تفعّله صراحة.

هذا دليل تكامل البروتوكولات. إذا كنت تريد عاديا Python وظائف للتسجيل مع إطار عمل، استخدام أضف أدوات بحث 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ليس أمراً مُستقيماً.

الاتصال بالأدوات التفتيشية واختيارياً إجراء بحث واحد

احفظ هذا الملف 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; لا ترسلوا مهرجاناً params يعترض على MCP أداة. وتُرفض الحقول غير المعروفة.

For 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، ويحصل على أكثر من أربعة نتائج كبيرة لكل مفتاح، ويمكن أن يطرد النتائج في وقت أقرب.

لتوصيل الفيديو أو الصوت إلى مخزنك، الاتصال youtube_download مع storage مقصد ومفتاح API الذي يمنح youtube_download. وفّر الوظيفة المعادة ID وإستطلاع get_job. للملفات Bulk المعالجة، استخدام واجهة API لمعالجة Bulk.

إخفاقات الشجار وفقا لما حدث

ويمكن أن يظل تبادل الـ HTTP الناجح متضمناً نتيجة لأداة isError: true; تحقق من هذا الحقل وتحتفظ الأخطاء المتعلقة باللجوء بوضعية مفيدة في أعلى المجرى وتطالب بتحديد هويات. أصلح الحجج الباطلة أو الأذن أو التوازن الائتماني قبل المحاولة مرة أخرى.

ولا يثبت انقضاء الوقت أو ضياع الصلة أن أي استفسار لم يُنفذ. For query_outcome_unknown, "مفتش الطلب" History قبل إعادة تقديم الطلب هذا العميل عمداً ليس لديه أي حلقة إستعراض تلقائي حول مكالمة بأداة مدفوعة الأجر تقتصر الاستجابات الكبيرة في المراحل الأولى على 4 (مي بي)، لذا ابدأي بحساب النتائج الصغيرة

تستخدم القراصنة التسعير الحالي الخاص بك، دون رسوم إضافية MCP. اقرأ MCP, MCP و التسعير قبل أن تختاروا مقاساً متوافقاً أو دفعة لزبون إنتاج