واجهة REST + خادم MCP

واجهة API لتقارير SEO
للمطورين ووكلاء الذكاء الاصطناعي

أنشئ التقارير عبر REST، واستعلم عن حالتها، واقرأ نفس كائن التقرير المحفوظ الذي يراه فريقك على الموقع. ونفس مفتاح API يربط أي وكيل يدعم MCP.

نموذج الوصول

حساب مجاني + مفتاح API

الوصول إلى API مرتبط بالحساب. أنشئ حسابًا مجانيًا، أصدّر مفتاحًا API، وابدأ مع معاينات الدرجات. لا حاجة لبطاقة للخطوة التقييمية.

كائن تقرير واحد

جلسات الموقع، مكالمات API، وجلسات الوكيل تُقرأ من نفس حالة التقرير المحفوظ.

تدفق مباشر

أنشئ تقريراً، استعلم عن الحالة، ثم اقرأ المعاينة أو النتائج الكاملة من نفس الكائن.

انظر التسعير

نقاط النهاية المتاحة

POST/api/v1/reports/preview

إنشاء معاينة الدرجات لتدفقات الشريك وإطلاق المنتج.

POST/api/v1/reports

أنشئ تقريراً جديداً أو أعد استخدام تقرير موجود بالفعل.

GET/api/v1/reports/:id

احصل على أحدث حالة تقارير وأقسامها.

GET/api/v1/reports/:id/result

اقرأ النتائج الكاملة بعد فتح التقرير.

GET/api/v1/reports/:id/download?format=json

تصدير حمولة التقرير كـ JSON للدمج البرمجي.

العميل الرسمي TypeScript

مصادقة بدون إعداد، جاهزة للطبقة المجانية، جاهزة لمنصة الإطلاق.

انظر تكامل منصة الإطلاقعرض المستندات

سطر الأوامر

شغّل التقارير من طرفك. تثبيت عالمي واحد، معاينات فورية.

Bash
npm install -g @seoreport/client
احصل على مفتاح API

خادم MCP — نفس الواجهة، نفس المفتاح

وجّه أي عميل يدعم MCP إلى https://seoreport.dev/mcp وصادِق باستخدام نفس مفتاح API من نوع Bearer الذي تستخدمه مع REST. تُعرض أدوات التقارير والحساب عند الاتصال، فيستطيع الوكيل تشغيل التدقيق وقراءة النتائج دون أي شيفرة وسيطة.

إعداد عميل MCPJSON
{
  "mcpServers": {
    "seoreport": {
      "url": "https://seoreport.dev/mcp",
      "headers": {
        "Authorization": "Bearer sr__live_your_api_key"
      }
    }
  }
}
create_report

ابدأ تقريراً لرابط معيّن واحصل على معرّف المهمة.

get_report_status

استعلم عن المهمة حتى يصبح التقرير جاهزاً.

get_report

اقرأ التقرير المكتمل بدرجته ونتائجه.

list_reports

اعرض قائمة تقارير الحساب.

get_report_download

احصل على رابط تنزيل بصيغة JSON أو Markdown أو نص أو PDF.

get_usage

تحقق من الرصيد المتبقي وفترة الفوترة الحالية.

الدفع والإلغاء وحذف الحساب تُعيد رابط تأكيد يُفتح في المتصفح بدلاً من التنفيذ المباشر. يمكن للوكيل بدؤها، ولا يمكن إتمامها إلا لشخص.

دليل إعداد الوكلاءمرجع API الكامل
رد مثالJSON
{
  "success": true,
  "report": {
    "jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
    "stage": "snapshot_ready",
    "status": "completed",
    "targetUrl": "https://rbeckner.com",
    "isSnapshotReady": true,
    "preview": {
      "sectionKeys": ["hero_summary", "top_findings"]
    },
    "paidUnlock": {
      "unlockEligible": true,
      "unlocked": false
    }
  },
  "pollAfterMs": 0
}

جاهز للبناء?

احصل على مفتاح API المجاني وابدأ في دمج تقارير SEO في منتجك.

ابدأ تقريرًااحصل على مفتاح API الخاص بك