تخطيط سير عمل الذكاء الاصطناعي
توثيق واجهة برمجة تطبيقات SERP ودليل التكامل
أرسل طلب مهمة من جهة الخادم، وصادِق باستخدام حسابك، وافحص حالة HTTP وحالة كل مهمة. استكشف نمط التكامل نفسه عبر مجموعات بيانات SEO والتسويق.
اجمع النتائج العضوية والإعلانات وميزات البحث عبر محركات البحث والأسواق والأجهزة المدعومة. استخدم بيانات JSON وHTML منظّمة و
خاص بالمصدر
البحث.
طلبات المصادقة والمهام
تستخدم حسابات الإنتاج مصادقة HTTP Basic. أنشئ ترويسة Authorization على خادمك باستخدام اسم المستخدم وكلمة المرور المقدَّمين؛ وأبقِ بيانات الاعتماد خارج شيفرة المتصفح والأمثلة المشتركة.
بالنسبة إلى مسارات POST المدعومة لجمع البيانات، أرسل مصفوفة من
task objects. Each task contains that route’s inputs; a keyword query, page URL and product identifier are not interchangeable
الحمولات.
// Server-side example; configure your deployment and credentials.
const url = new URL("/v3/serp/google/organic/live/advanced", process.env.DATASEO_API_ORIGIN);
const auth = Buffer.from(`${process.env.DATASEO_LOGIN}:${process.env.DATASEO_PASSWORD}`).toString("base64");
const response = await fetch(url, {
method: "POST",
headers: {Authorization: `Basic ${auth}`, "Content-Type": "application/json"},
body: JSON.stringify([{"keyword": "running shoes", "location_code": 2840, "language_code": "en", "device": "desktop"}])
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
for (const task of data.tasks ?? []) {
if (task.status_code !== 20000) throw new Error(task.status_message);
}
// Use task.result only after checking task status.Check the HTTP status first, then the top-level response and each task status_code. A successful HTTP 200 can still contain task errors; only read task.result after validating the task.
YOUR_CONFIGURED_TOOL_SERVER
تحقق من حالة الاستجابة
يتطلب جمع الكلمات المفتاحية تحديد مصدر وإعدادات سوق مدعومة. تعامل مع المنافسة الإعلانية على أنها مقياس للإعلانات على شبكة البحث، وافصل أحجام البحث الشهرية عن درجات الاتجاه المعيارية.
لفحص عنوان URL، ابدأ باستخدام /v3/on_page/instant_pages وأدخل عنوان URL. يستخدم عرض المتصفح وLighthouse خيارات أو مسارات منفصلة، وقد يتطلبان إعدادًا إضافيًا.
للحصول على استجابات النماذج الرسمية، استخدم مسار llm_responses المدعوم مع user_prompt. اعرض النماذج المُعدّة واحتفظ بإعداداتها عند مقارنة الإجابات.
تعيد المسارات الخاصة بالمهام الموضوعة في قائمة الانتظار معرّفات لاسترجاع النتائج لاحقًا. احتفظ بالمعرّفات وتحقق من تدفق ready/get الموثّق للمسار المحدد، بدلًا من افتراض أن جميع المنتجات تتبع نمط التسليم نفسه.
احتفظ بالطوابع الزمنية للتحصيل وإعدادات الإدخال ومعرّفات المصدر. اترك الحقول المفقودة فارغة أو غير موجودة؛ ولا تحوّل المقياس غير المتاح إلى صفر.
النتائج العضوية والإعلانات وميزات البحث عبر محركات البحث والأسواق والأجهزة المدعومة. استخدم
خيارات جمع بصيغ JSON وHTML منظمة وخاصة بالمصدر لتتبع الترتيب والبحث التنافسي.
الشفرة والاستجابات على الموقع توضيحية. يجب أن يؤكد النشر المحدد مخطط المسار وإمكانية الوصول والحصص والتعامل مع البيانات وتسعير العملاء قبل جمع البيانات في بيئة الإنتاج.
لا يتضمن التطبيق حاليًا خادم MCP عامًا موثّقًا أو موصلات أصلية للأدوات المعروضة هنا. لا تستخدم تكامل HTTP من جهة الخادم إلا بعد التأكد من المصدر والمسار المطلوبين.
تحقّق من استجابة نموذجية قبل التوسع. افحص القيم الفارغة وأنواع العناصر ووحدات الحقول ورسائل الأخطاء وما إذا كانت النتيجة تجيب عن السؤال الذي يحتاج تطبيقك إلى الإجابة عنه.
احرص على ألا تتضمن السجلات بيانات اعتماد أو محتوى طلبات حساسًا. اتفق على الاحتفاظ والترخيص والاستخدام المسموح به للمصدر المحدد قبل تخزين ملاحظات الإنتاج.
"أبحاث حديثة حول RAG"
اختر مسار منتج مدعومًا، واضبط مصدر النشر وبيانات الاعتماد، ثم اختبر مهمة واحدة قبل جدولة عبء عمل أكبر. تستخدم هذه الواجهة الأمامية بيانات توضيحية محلية ولا ترسل أي طلبات API مباشرة.
اجمع النتائج العضوية
النتائج والإعلانات وميزات البحث عبر محركات البحث والأسواق والأجهزة المدعومة. استخدم خيارات الجمع الخاصة بكل مصدر، بصيغ JSON المنظّمة وHTML، لتتبّع الترتيب