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

مرجع API

MCP الأدوات والخصائص

ابحث عن حجج لأداة FlashData MCP, defaults, account reads, job states and result retrieval.

في هذه الصفحة

نسخة Markdown

خيارات الوصول عبر OAuth وCodex وOpenClaw ومفتاح API

اختر نفسك MCP زبون واتصال

النقل والتوثيق

وتستخدم نقطة النهاية التي استضافتها MCP (S Streamable HTTP). API-الوصلات الرئيسية ترسل X-API-Keyالوصول للأدوات يتبع تصريحات المصدر و الائتمانات المتاحة

Streamable HTTP
URL: https://data.flashdata.dev/mcp
X-API-Key: <your API key>

سرقتك الفعلية FlashData API المفتاح في تشكيلة الزبون الإبداعية لا تضعه في محادثة أو حجج للأدوات يغطي هذا الباب API- الاتصالات الرئيسية؛ ويغطي دليل الوصول إلى العملاء OAuth الدخان والاختبار Codex و OpenClaw تشكيلات. youtube_download دعم تنزيلات وسائط الإعلام المتنازعة مع ما هو مناسب API-إذن جيد .

Manage API

أدوات الحجر الصحي

عميلك يكتشف الأدوات التي منحها المفتاح الستة Google ثمانية YouTube عدم توافر أدوات البيانات في الوقت الحقيقي وقبولها أيضا mode: async. submit_batch يدعم كلتا المجموعتين. youtube_download استخدامات التحميل الرسمي API:: يتطلب تخزين العملاء، ويدعم وظائف الأسينك أو submit_batch. ويمكن للنموذج أن يختار ويجمع بين الأدوات اللازمة للمهمة.

Google

google_search · google_images · google_news · google_shopping · google_videos · google_places

YouTube

youtube_search · youtube_search_extended · youtube_metadata · youtube_transcript · youtube_captions · youtube_trainability · youtube_channel · youtube_suggestions · youtube_download

google_search ; arguments JSON
{
  "query": "MCP protocol",
  "num": 3,
  "gl": "us",
  "hl": "en",
  "mode": "async"
}

حجج عنيفة

وتطرح مجالات الاستفسار، مثل الاستفسارات، والأرقام، واللغة، والأسلوب، مباشرة في حجج الأداة، دون أن يكون ملف " REST API " . ويختار اسم أداة الاستفسار مصدرها؛ ولا توجد سوى القيود في submit_batch التي تحتاج إلى مصدر. ومفاتيح API و callback_url ليست حجج أدوات. وأمثلة JSON الواردة أدناه عبارة عن أجسام حجية للزجاجة client.callTool (اسم، حجج }).

استخدم قيم JSON المنطقية والأعداد الصحيحة، وليس سلاسل نصية. تُرفض الحقول غير المعروفة. تقبل أدوات استعلام البيانات الـ14 mode: realtime أو async، والافتراضي realtime. لا تقبل عناصر batch الحقل mode.

Toolمطلوبالحجج الاختيارية
youtube_downloadvideo_id, storage- دعم المواساة فقط (قصير). download_type: audio_video (قصير)/video/audio. video_quality: <=720 (أ) عن طريق التقصير؛ best/worst "أو "ممتاز 144/360/480/720/1080/1440/2160/4320. (و) المقارنات نفسها مع 1–240. output_format: mp4 (default)/webm/mkv للفيديو، m4a (قصير)/mp3/opus للصوت. audio_language: default/original; audio_quality: best/320/256/192/128الصوت فقط yt_dlp_format: حتى 1024 الشخصيات، تتخطى الجودة، واختيار اللغويات. Omit video_quality/fps للصوت audio_language للتخزين بالفيديو فقط مطلوب و يطابق الحمولة API params.storage. start_at/end_at: HH:MM: S، حتى 12 ساعات؛ end_at يجب أن يتبع start_at. upload_metadata: boolean, default false. كل تحميل دفعة يحتاج إلى تخزين. No browser_delivery or callback_url.
storagestorage_type, storage_urlstorage_url هو اسم البكت الخاص بك (في Azure: الحاوية)، وليس دليلًا محليًا. storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tos؛ وobject_prefix اختياري. تستخدم S3 وS3-compatible وOSS وCOS وBOS وTOS حقلي access_key/secret_key مع region/endpoint_url المناسبين. تستخدم GCS الحقل service_account الذي يحوي project_id وclient_email وprivate_key؛ وتستخدم Azure حقلي account_name وsas_token للحاوية بصلاحية الكتابة. يجب أن يتمكن Worker من الوصول إلى نقطة النهاية. اقرأ بيانات الاعتماد من إعداد التخزين؛ ولا تلصقها في المحادثة أو تطبعها.
google_*queryالاستفسار: 1–2,000 characters. gl: two-letter country; hl: 1–35 character code; location/tbs: 1–200 characters; num/page: integers 1–100; autocorrect: boolean. وتستخدم الخيارات المتاحة سلوك مقدِّم خدمات البحث، دون ضمان وجود بلد ثابت أو لغة أو نتيجة محددة.
youtube_searchqueryquery: من 1–2,000 حرف. max_results: من 1–20، والافتراضي 20؛ filters: كائن مرشحات، يُحذف أو تكون قيمته null دون ترشيح.
youtube_search_extendedqueryالاستفسار: 1–2,000 characters. max_results: 1–700, default 20; filters: same as standard search.
youtube_metadatavideo_idinclude_formats وinclude_chapters قيمتان منطقيتان، والقيمة الافتراضية لكلتيهما true.
youtube_transcriptvideo_idامسحي اللغة لتفضّل الضبط، ثم العودة إلى مسار واحد. بالسياراتtrueكل شفرة تفضّل مسارها الأوّلي، ثمّ الشفرة السّيّة؛ صريحة - مُتَحَقّمة وآليةfalse إبقي على وجه الدقة. (أري) حاول كل شيء 1–10 اللغات المطلوبة وتتبعات العودة والأخطاء المطلوبة. true للقبضات التلقائية.
youtube_captionsvideo_idامسحي اللغة لتفضّل الضبط، ثم العودة إلى مسار واحد. بالسياراتtrueكل شفرة تفضّل مسارها الأوّلي، ثمّ الشفرة السّيّة؛ صريحة - مُتَحَقّمة وآليةfalse إبقي على وجه الدقة. (أري) حاول كل شيء 1–10 اللغات المطلوبة وتتبعات العودة والأخطاء المطلوبة. false من أجل الاختباءات المزودة بأجهزة تحميل
youtube_trainabilityvideo_idلا توجد حجج اختيارية إلا طريقة. تصنيف تراخيص الشركات الإبداعية؛ فهو لا يمنح إذناً للتدريب.
youtube_channelhandleمعالج: 1–100 characters; video_limit: 1–100, default 20.
youtube_suggestionsqueryالاستفسار: 1–2,000 characters; language: default en; region: two-letter country code, default US.

video_id هو 11-منتج YouTube ID استخدام الرسائل أو الأرقام أو التأكيدات أو الفيزياء؛ إمداد ID بدلاً من الفيديو URL. كل شفرة لغوية 1–35 شخصيات تستخدم الحروف أو الأرقام أو الفيفين. بالنسبة للعنوان الفرعي، يُختار التلقائي (true) الأصفاد التلقائية، ويختار (false) الأصفاد المزودة بأجهزة تحميل، دون حدوث أي تداعيات تلقائية بينهما. بالنسبة للصفائف اللغوية، تفحص الأخطاء حتى عندما تنجح الوظيفة.

مرشحي البحث YouTube

filters.type: video/channel/playlist/movie؛ upload_date: today/last_hour/this_week/this_month/this_year؛ duration: <4 أو 4-20 أو >20؛ sort_by: rating/relevance/view_count/upload_date. أعلام الخصائص قيم منطقية؛ وتعني true اشتراط الخاصية: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180.

youtube_search ; arguments JSON
{
  "query": "renewable energy",
  "max_results": 5,
  "filters": {
    "type": "video",
    "duration": "<4",
    "subtitles": true
  }
}

بصيرة الحسابات (خالية)

get_balance يقرأ رصيد حسابك المشترك؛ get_pricing (أ) تقديرات تكاليف الاستفسار؛ get_limits (أ) يقرأ حدود الخطة والوظائف الحالية التي لم يبت فيها بعد؛ get_usage تلخيص آخر 7 يوماً بعد التقصير، مع الحد الأقصى 31- نافذة يومية. ويشمل الاستخدام جميع مفاتيح حساب المصادر المأذون بها بمفتاح الاتصال، ويمكن تأخيرها.

get_balance و get_limits خذ {}. get_pricing تقبل مصدرا اختياريا؛ وتحذفه للجميع MCP مصادر الاستفسار مرخصة بمفتاحك request_count هو ثلاجة من 1 إلى 100000, default 1; كل صفحة أو قطعة من الورق تعد كطلب منفصل. get_usage تقبل مصدرا اختياريا؛ وتحذفه من جميع المصادر المأذون بها. وهو يشمل استخدام youtube_download. عودة تسعير الحمولة creditsPerTb (1 TB = 10^12 (أ) تُحمّل الأرصدة الدائنة الاحتياطية وتُسوّى باللوحات المحملة فعلاً. request_count لا ينطبق على عمليات التنزيل estimatedCredits هو null.

يجب أن تكون from/to في get_usage توقيتات ISO بصيغة UTC مثل 2026-09-21T00:00:00Z، مع 1–3 أرقام اختيارية لكسر الثانية. تشمل الفترة from وتستثني to، وتُقرَّب إلى أسفل للدقائق. النافذة الافتراضية 7 أيام والحد الأقصى 31 يومًا. مع from فقط، تكون to بعد سبعة أيام؛ ومع to فقط، تكون from قبلها بسبعة أيام. اقرأ from/to في الاستجابة لمعرفة النافذة الفعلية.

get_pricing ; arguments JSON
{
  "source": "google_search",
  "request_count": 3
}
get_usage ; arguments JSON
{
  "source": "youtube_metadata",
  "from": "2026-09-21T00:00:00Z",
  "to": "2026-09-22T00:00:00Z"
}

الوظائف والنتائج الكبيرة

A async request returns a job id; pass it as job_id to get_job to read job.status. وتشمل الوظائف المنجزة الرد الأصلي على الاستفسارات في الناتج. وفيما يتعلق بالتحميلات، فإن الناتج هو بيان التحميل: يشير output.results[0].file_url إلى تخزين العملاء، مع file_size و downloaded_bytes و md5. الملفات الخاصة تحتاج لتوثيق تخزينك وتُحتفظ بنتائج JSON لساعات التردد 24؛ وتتبع سياسات التخزين الخاصة بوسائط الإعلام، وتقبل شركة submit_batch على الأقل سؤالاً واحداً من طراز Google أو من استفسار من شركة YouTube (بما في ذلك التحميلات)، مع حجج مثبتة من المصدر على كل دخول. وكل دخول يتم حسابه على حدة، وتطبق دفعة خطتكم والحدود المعلقة. وظائف القراءة لا تهمة ثانيةً Bulk ليس أداة MCP.

تجهيز ملف ID؟ استخدام Bulk HTTP API

youtube_transcript ; arguments JSON
{
  "video_id": "FUfGcZ092b0",
  "language": "en",
  "auto": true,
  "mode": "async"
}
submit_batch ; arguments JSON
{
  "queries": [
    {
      "source": "google_search",
      "query": "renewable energy",
      "num": 3
    },
    {
      "source": "youtube_metadata",
      "video_id": "FUfGcZ092b0",
      "include_formats": false
    }
  ]
}

يستعاض عن المثال job_id, result_id ومقابلة قيم من ردكم. اقرأ الشق التالي دون إعادة تقديم السؤال

get_job ; arguments JSON
{
  "job_id": "job_REPLACE_WITH_RETURNED_ID"
}

تتضمن الاستجابات الكبيرة جزء نص JSON وresult_id وnext_offset. استدعِ get_result بالمفتاح نفسه وresult_id العائد. offset عدد صحيح غير سالب، وافتراضيه 0؛ استخدم next_offset السابق للمتابعة. limit عدد صحيح من 1 إلى 16000، وافتراضيه 16000، ويُقاس بوحدات UTF-16 وليس بالبايتات أو صفوف النتائج. اجمع الأجزاء بالترتيب قبل تحليل JSON؛ وتشير next_offset=null إلى النهاية. تُخزّن النتائج مؤقتًا لمدة 10 دقائق، بحد أقصى أربع نتائج كبيرة لكل مفتاح، وقد تُزال قبل ذلك. لا تكرر قراءة الأجزاء الاستعلام ولا تخصم رصيدًا.

get_result ; arguments JSON
{
  "result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
  "offset": 16000,
  "limit": 16000
}

Billing and errors

تستخدم الاستعلامات أسعار الرصيد في خطتك الحالية دون رسوم MCP إضافية. تضبط أخطاء الأدوات isError وتحتفظ بحالة HTTP ومعرّف الطلب من الخدمة الأصلية. أضف رصيدًا عند عدم كفايته وتحقق من صلاحيات المفتاح عند أخطاء الوصول.

لا يعني انتهاء المهلة أو فقدان الاتصال أن الاستعلام لم يُنفّذ. عند query_outcome_unknown، تحقق من Request History في وحدة التحكم قبل تقرير إعادة الإرسال. لا تعِد الإرسالات المدفوعة تلقائيًا؛ ويمكن إعادة قراءة المهام أو الأجزاء الموجودة. الحد الأقصى للاستجابات الأصلية 4 MiB، لذا حدّد حجم البحث؛ فقد تكون الرسوم قد احتُسبت لاستجابة كبيرة جدًا.

Undering HTTP code · قواعد الاسترداد

تم التحقق من ذلك مع عميلة من طراز JavaScript

ويستخدم هذا العميل الموظف الذي تم التحقق من وجوده في شركة SDK 1.30.0 للتواصل مع شركة Streamable HTTP وقائمة الأدوات دون إجراء استفسارات مدفوعة الأجر. احفظه كما هو mcp-check.mjsمجموعة FLASHDATA_API_KEY في بيئتِكَ، ثمّ يَدْفعُ العقدةَ mcp-check.mjs.

npm
npm install @modelcontextprotocol/[email protected]
mcp-check.mjs
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: 'my-app', version: '1.0.0' });
try {
  await client.connect(new StreamableHTTPClientTransport(
    new URL('https://data.flashdata.dev/mcp'),
    { requestInit: { headers: { 'X-API-Key': key } } }
  ));
  console.log((await client.listTools()).tools.map(tool => tool.name));
} finally {
  await client.close();
}