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

البدء

FlashData MCP

أعطِ وكيلَكَ Google Search و YouTube أدوات. اتصل بمضيفك، ثم أطلب نتيجة أولى.

في هذه الصفحة

1. الاتصال والتوقيع في

اختر Codex أو OpenClaw لتسجيل OAuth عبر المتصفح. لمضيف آخر، اختر Remote / API key إذا كان يدعم Streamable HTTP والترويسات المخصصة، أو Local / stdio إذا كان يشغّل عمليات MCP. لا يحتاج الخادم المستضاف إلى تثبيت محلي.

ادمجوا الثقب السفلي إلى.../.codex/config.tomlثمّ يُديرُ أمرَ الدخولَ. اكتمل FlashData التوقيع أو التوقيع أو الموافقة في المصفح. ابدأوا من جديد Codex جلسة بعد لوج.

config.toml
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"

[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"
تسجيل الدخول
codex mcp login flashdata --scopes mcp:research

2. تحقق من الصلة

أرسل هذا إلى جلسة عملاء جديدة يتوقع نجاح اتصالات get_pricing و get_balance، سعر متاح للزدجاجي google_search وميزانك الائتماني المتاح. أي رصيد صفري يعني أنك بحاجة إلى الائتمانات للبحث؛ لا يعني أن التوثيق فشل.

التحقق من الارتباط
استخدم اتصال flashdata MCP الموجود.
استدعِ get_pricing باستخدام {"source":"google_search","request_count":1}.
استدعِ get_balance باستخدام {}.
أبلغ عما إذا نجح الاستدعاءان، وما إذا كان للمصدر سعر متاح،
وعن الرصيد المتاح. الرصيد الصفري لا يعني فشل المصادقة.
لا تنفّذ بحثًا أو تنزيلًا، ولا تنشئ تجربة، ولا تغيّر بيانات الاعتماد.

3. أطلبي مهمتك الأولى

استولي على هذا في عميلك المتصل وتُعتبر عمليات التحقق من الرصيد والتسعير مجانية؛ وتستخدم عمليات البحث أرصدة لحسابها.

المهمة الأولى
استخدم FlashData للتحقق من رصيدي وسعر بحث Google واحد. إذا كان الرصيد كافيًا، استدعِ google_search مرة واحدة مع query بقيمة "battery recycling research" وnum بقيمة 5 وmode بقيمة "realtime". أعد العناوين وروابط المصادر ومقتطفات قصيرة والرصيد المستخدم فعليًا. توقف بعد هذه المهمة.

تحقق من النتيجة

ينبغي أن يعيد وكيلك روابط المصادر ومقتطفاتها والرصيد المستخدم فعليًا. تحتوي نتيجة البحث الأساسية status: done وresults[].organic. النتيجة الفارغة صالحة؛ وعلى الوكيل الإبلاغ عنها. المثال أدناه توضيحي.

جواب مثال
مكتمل Google البحث.
1. بحوث إعادة تدوير البطاريات - https://example.org/recycling
   مقتطف من البحث
الأرصدة الدائنة المستخدمة: 0.02

الأدوات المتاحة

API-المكالمات الرئيسية تستخدم التصاريح الممنوحة لهذا المفتاح إكتشفوا أدوات الخادم وخصائص مدخلاته من أجل الكاتالوج الحالي الكامل

المهامToolالوصول
فتش Googlegoogle_searchmcp:research / API key
اعثر على أشرطة فيديو من طراز YouTubeyoutube_searchmcp:research / API key
اقرأ البيانات الوصفية بالفيديوyoutube_metadatamcp:research / API key
استرجاع الأغلال القائمةyoutube_transcriptmcp:research / API key
شريط فيديو أو صوتيyoutube_downloadمفتاح API + مخزن المقصد
حساب الشيك والتسعيرget_balance, get_pricing, get_limits, get_usageالحساب الحر يقرأ

بشأن OAuth, permissions and trials

OAuth يربط حساب مالكك المتحقق منه ويسمح للمخزن المضيف ويعيد فتح الشيكات وتغطي منحة mcp:research المصادر البحثية الأربعة المذكورة أعلاه. API-الوصلات الرئيسية تستخدم حماية X-API-Key رئيس ويمكن أن يشمل مصادر أخرى مأذون بها.

محاولة FlashData قبل إنشاء حساب، استخدام CLI سير التجربة وتربط شركة MCP OAuth حساباً للمالك؛ وهي لا تسجل أو تطالب بتجربة. ألف CLI لا يُطلع على ملفك تلقائياً MCP مضيف.

اضطرابات

المشكلةجرب هذا
No FlashData toolsإنهاء الموافقة، وإعادة الاتصال، والبدء في دورة جديدة. تحققي من نقل URL وSreamable HTTP.
invalid_client / callback errorFor Codex أو OpenClawاستخدم تشكيلة عملائه بالضبط و مصفح يمكنه الوصول إلى ردة الفعل المحلية بالنسبة لمضيف آخر، استخدم مركبه المدعوم API-key أو جهاز الاستديو فوق.
401وقد انتهت صلاحية إعادة الاتصال أو ألغيت إمكانية وصول OAuth، أو تحقق من مفتاح API الذي تم توريده للمضيف. أكرر الشيك المجاني
403تحقق من المصدر المطلوب و التصاريح الرئيسية وتحتاج شركة YouTube Download إلى مالك مفتاح API مع شركة youtube_download وخزن الوجهات؛ ولا تشمل شركة mcp:research.
402تحقق Billing والسعر الحالي. ولا يضاف إلى ذلك إعادة ربط الاختراع الصحيح.
429أتبع Retry-After. ابقوا أي عمل قائم أو نتيجــة ID قبل أن يقرروا ما إذا كانوا سيعيدون العمل.
الوقت أو الاستجابة غير الكاملةحافظ على الطلب ID وتحقق History. اقرأوا مواصلات كبيرة مع get_result بدلاً من تكرار البحث.

إذهب أبعد