اسأل Claude وCursor ومساعدات الذكاء الاصطناعي الأخرى عن SEO موقعك

1. أنشئ مفتاح API

في serp.ac افتح الإعدادات ← API وأنشئ مفتاحًا (يمكن ذلك لمالك الحساب والمشرفين فقط). انسخه — فهو يُعرض مرة واحدة فقط. يستخدم خادم MCP المفاتيح نفسها وحد المعدل نفسه (120 طلب في الدقيقة لكل مفتاح) والحصص نفسها التي تستخدمها REST API. يمنح كل مفتاح وصولًا كاملًا إلى الحساب الذي أنشأه، لذا احتفظ به سرًا وألغِه من الصفحة نفسها إذا تسرّب.

2. اربط Claude

Claude ‏(claude.ai وتطبيقات Claude) — موصّل مخصّص

انتقل إلى Settings ← Connectors ← Add custom connector، وسمِّه serp.ac واستخدم عنوان URL للخادم https://serp.ac/api/mcp. يصادق الخادم كل طلب باستخدام مفتاح API الخاص بك المُرسل على هيئة Authorization: Bearer sk_live_…؛ وإذا لم يكن في نافذة الموصّل ضمن خطتك طريقة لإرسال هذه الترويسة، فاستخدم إعداد Claude Desktop أدناه بدلًا من ذلك.

Claude Desktop — ملف الإعداد

افتح Settings ← Developer ← Edit config وأضف الخادم إلى claude_desktop_config.json. يشغّل ذلك جسر mcp-remote ‏(يتطلب Node.js)، الذي يمرّر مفتاحك كترويسة. أعِد تشغيل Claude Desktop بعد ذلك.

{
  "mcpServers": {
    "serp-ac": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://serp.ac/api/mcp", "--header", "Authorization:${SERP_AC_AUTH}"],
      "env": { "SERP_AC_AUTH": "Bearer sk_live_..." }
    }
  }
}

Claude Code

claude mcp add --transport http serp-ac https://serp.ac/api/mcp \
  --header "Authorization: Bearer sk_live_..."

3. اربط Cursor والعملاء الآخرين

Cursor: أضف الخادم إلى ~/.cursor/mcp.json (لكل المشاريع) أو إلى .cursor/mcp.json داخل مشروع، ثم فعّله من Settings ← MCP.

{
  "mcpServers": {
    "serp-ac": {
      "url": "https://serp.ac/api/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

يعمل أي عميل MCP آخر (ChatGPT أو VS Code أو Windsurf أو وكيلك الخاص) بالطريقة نفسها ما دام يدعم نقل Streamable HTTP ويمكنه إرسال ترويسة Authorization. ويمكن للعملاء الذين يدعمون stdio فقط استخدام جسر mcp-remote الموضّح أعلاه.

فحص سريع من الطرفية:

curl https://serp.ac/api/mcp \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

وضع القراءة فقط

الأدوات المعلَّمة بـ تغيّر البيانات تضيف عناصر إلى حسابك، والأدوات المعلَّمة بـ تستهلك الحصة تستهلك حصصك الشهرية؛ ويُطلب من المساعدات سؤالك أولًا. لإتاحة أدوات القراءة فقط، اتصل عبر https://serp.ac/api/mcp?readonly=1. وضع القراءة فقط إعداد خاص بالاتصال، لا بالمفتاح — فالمفتاح يحمل دائمًا كامل صلاحيات الحساب.

الأدوات

تُجيب كل أداة بملخص قصير إضافةً إلى البيانات نفسها بصيغة JSON منظّمة. القوائم محدودة (حتى 200 صف) ولا تحتوي إلا على بيانات حسابك. يمكن الإشارة إلى المشاريع بالمعرّف (id) أو بالنطاق.

• list_projectsقراءة

  يسرد مشاريع serp.ac (المواقع) في هذا الحساب مع معرّفاتها ونطاقاتها وعدد الكلمات المفتاحية وموجّهات AI والروابط المشتراة التي يتتبّعها كل منها. استدعِه أولًا للحصول على معرّفات المشاريع.

• get_rankingsقراءة

  ترتيب Google للكلمات المفتاحية المتتبَّعة في مشروع: الترتيب الحالي، والتغيّر منذ الفحص السابق (موجب = تقدّم للأعلى)، وعنوان URL المُرتَّب، وما إذا كان Google AI Overview معروضًا ويستشهد بالموقع، ووقت آخر فحص. مع مرشّح اختياري لنص الكلمة المفتاحية ومرشّح للجهاز.

• get_ai_visibilityقراءة

  ظهور مشروع في ChatGPT وPerplexity وGemini وClaude وGoogle AI Mode: نسبة الإجابات التي تذكر العلامة التجارية، ومعدل الاستشهاد، ومتوسط الترتيب، وأرقام كل محرك، ومصفوفة موجّه × محرك، وأكثر نطاقات المصادر استشهادًا، وحصة الظهور، والعلامات التجارية الأخرى التي توصي بها مساعدات الذكاء الاصطناعي.

• get_backlinks_summaryقراءة

  نظرة عامة على الروابط الخلفية لمشروع: إجمالي الروابط الخلفية والنطاقات المُحيلة، وتصنيف النطاق، ونسبة dofollow، والروابط الجديدة في آخر 30 يومًا، والروابط المفقودة، وأقوى النطاقات المُحيلة.

• list_purchased_linksقراءة

  الروابط المشتراة (المدفوعة) المتتبَّعة في إدارة الروابط: الحالة (pending، active، issue، lost، expired، cancelled = متوقف مؤقتًا)، والمشكلات المكتشفة، والسعر، ودورة الفوترة، وتاريخ الدفعة / التجديد التالي، والمورّد، إضافةً إلى المدفوعات المستحقة خلال الـ 30 يومًا القادمة. لكل المشاريع ما لم يُحدَّد مشروع.

• get_index_jobقراءة

  حالة مهمة فحص الفهرسة التي بدأت عبر check_index، مع حالة فهرسة كل عنوان URL ‏(indexed، not_indexed، queued، error).

• get_usageقراءة

  خطة الحساب وحالة الاشتراك، وحدود الخطة مع الاستخدام الحالي (المشاريع، الكلمات المفتاحية، موجّهات AI، الروابط)، والحصص الشهرية المتبقية (إرسالات الفهرسة، فحوصات الفهرسة، استعلامات بيانات الكلمات المفتاحية).

• get_maps_rankingsقراءة

  تتبّع الترتيب في Google Maps (شبكة جغرافية محلية) لمشروع: بدون حملة، كل حملات Maps مع أحدث درجة حضور محلي (0–100)، ونسبة التغطية في أفضل 10 نتائج، ومتوسط الترتيب؛ ومع حملة (المعرّف أو نص الكلمة المفتاحية)، ترتيب أحدث مسح عند كل نقطة في الشبكة، وسجلّ المسح، والمنافسون المتقدّمون عليك، والحزمة المحلية (local pack).

• track_keywordsتغيّر البيانات

  يبدأ تتبّع ترتيب Google لكلمات مفتاحية جديدة في مشروع. تُحتسب كل كلمة مفتاحية جديدة ضمن حد كلمات SERP المفتاحية في الخطة؛ وتبقى الكلمات المتتبَّعة مسبقًا دون تغيير. اسأل المستخدم قبل إضافة كلمات مفتاحية كثيرة.

• add_ai_promptsتغيّر البيانات

  يضيف موجّهات (أسئلة يطرحها الناس على مساعدات الذكاء الاصطناعي) إلى تتبّع الظهور في الذكاء الاصطناعي لمشروع؛ ثم تُشغَّل وفق جدول. يُحتسب كل موجّه جديد ضمن حد موجّهات AI في الخطة؛ وتبقى الموجّهات المتتبَّعة مسبقًا دون تغيير.

• add_purchased_linkتغيّر البيانات

  يضيف رابطًا مشترى (مدفوعًا) إلى إدارة الروابط في مشروع ليفحصه serp.ac يوميًا ويذكّر بالمدفوعات. يُحتسب ضمن حد الروابط المتتبَّعة في الخطة. يفشل مع already_tracked إذا كان الرابط نفسه المصدر ← الهدف موجودًا.

• check_indexتستهلك الحصة

  يبدأ مهمة تفحص ما إذا كانت عناوين URL مفهرسة في Google. يستهلك كل عنوان URL فحص فهرسة واحدًا من الحصة الشهرية (ثم من الحزم المشتراة)؛ ولا يُخصم أي شيء إذا لم يكن الرصيد كافيًا. يُرجع معرّف مهمة — استدعِ get_index_job للحصول على النتائج.

• get_keyword_dataتستهلك الحصة

  حجم البحث، وCPC، والمنافسة، وصعوبة الكلمة المفتاحية، ونية البحث، واتجاه 12 شهرًا لكل كلمة مفتاحية. تُحتسب كل كلمة مفتاحية غير مخزّنة مؤقتًا ضمن حصة الاستعلام الشهرية المدفوعة للحساب (الكلمات المخزّنة مؤقتًا مجانية)؛ افحص get_usage أولًا للقوائم الكبيرة.

الحدود والأخطاء

• تلتزم أدوات الكتابة بخطتك تمامًا مثل لوحة التحكم وREST API: حدود الكلمات المفتاحية والموجّهات والروابط، ومحركات الذكاء الاصطناعي المشمولة في الخطة، ووجود خطة أو تجربة فعّالة.
• تستهلك check_index فحص فهرسة واحدًا لكل عنوان URL من الحصة الشهرية، ثم من الحزم؛ وتستهلك get_keyword_data حصة الاستعلام الشهرية عن الكلمات المفتاحية غير المخزّنة مؤقتًا. لا يُخصم أي شيء عندما تكون الحصة غير كافية.
• تعود مشكلات الاستدعاء (مشروع غير معروف، أو وسائط غير صالحة، أو بلوغ الحد) كخطأ أداة يستطيع المساعد قراءته. ويُرجع المفتاح المفقود أو الملغى HTTP 401، والحساب المعلّق 403، والطلبات الكثيرة جدًا 429.

تريد الأتمتة دون مساعد ذكاء اصطناعي؟ راجع مرجع REST API ضمن الإعدادات ← API.