اربط RankMeFast بأدوات الذكاء الاصطناعي لديك

لشرح مختصر، راجع دليل ربط RankMeFast MCP.

يوفّر RankMeFast نقطة نهاية بعيدة لبروتوكول Model Context Protocol (MCP). وهي تتيح لوكيل برمجة أو بيئة تطوير متكاملة أو أداة سطر أوامر متوافقة قراءة بيانات SEO وبدء عمليات التدقيق من دون مغادرة سير عملك الحالي.

الإعداد خلال خمس دقائق

1. افتح الإعدادات ← مفاتيح API، واختر إنشاء مفتاح، ثم انسخ المفتاح عند ظهوره. يعرض RankMeFast المفتاح الكامل مرة واحدة فقط.

2. استخدم نقطة نهاية MCP الخاصة بـ RankMeFast:

   https://rankme.fast/api/mcp
   

3. في العملاء الذين يدعمون متغيرات البيئة، عيّن المفتاح قبل تشغيل العميل:

   export RANKMEFAST_API_KEY='rmf_REPLACE_WITH_YOUR_KEY'
   

   في PowerShell:

   $env:RANKMEFAST_API_KEY = 'rmf_REPLACE_WITH_YOUR_KEY'
   

4. اختر عميلك أدناه، والصق تهيئته، ثم أعد تشغيل العميل أو تحميله.

5. تحقّق من الاتصال باستخدام: «استخدم RankMeFast لعرض مواقعي.»

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

يتوفر الوصول إلى MCP ضمن خطط Starter وPro وAgency. كما تعمل مفاتيح Agency مع واجهة REST API العامة للقراءة فقط.

التحكم في الصلاحيات ونطاقات المفاتيح

افتح الإعدادات ← MCP لإدارة إعدادات الحساب الافتراضية المشتركة بين MCP ومساعد الذكاء الاصطناعي في الجلسة المسجّلة:

1. شغّل كل أداة من أدوات RankMeFast أو أوقفها.
2. اترك المواقع المسموح بها على جميع المواقع، أو اختر المواقع التي تستطيع الأدوات استخدامها.
3. أوقف السماح بإجراءات الإنفاق إذا كان يجب ألا تعمل start_audit مطلقًا.
4. احفظ الإعدادات. تعرض بطاقة البدء السريع في التبويب نفسه نقطة النهاية واختصار مفاتيح API وتهيئة عميل قابلة للنسخ.

تكون إعدادات الحساب الافتراضية متساهلة بالكامل إلى أن تغيّرها، لذلك تستمر المفاتيح الحالية في العمل. يستخدم المساعد هذه الإعدادات مباشرة لأنه يعمل عبر جلستك المسجّلة.

يمكنك إضافة نطاقات أضيق عند إنشاء مفتاح ضمن الإعدادات ← مفاتيح API، أو تعديل مفتاح حالي لاحقًا. لا تستطيع نطاقات المفتاح إلا تضييق الوصول. يكون وصول MCP الفعلي دائمًا هو التقاطع:

• لا تتوفر الأداة إلا إذا سمح بها الحساب والمفتاح معًا.
• عندما يحدد الحساب والمفتاح مواقع، لا تتوفر إلا المواقع الموجودة في القائمتين.
• تتطلب start_audit السماح بالأداة وبإجراءات الإنفاق في المستويين.

ترك النطاق بلا قيود يعني «اتباع إعداد الحساب الافتراضي»، ولا يتجاوز قيدًا على الحساب. تُحذف الأداة غير المسموح بها من الاكتشاف، ويعيد الموقع المحظور أو غير المملوك نتيجة «غير موجود» نفسها.

اللغة وعقد JSON-RPC

بالنسبة إلى tools/list والطلبات التي لا تتضمن تجاوزًا للأداة، يختار MCP النص البشري عبر x-lang ثم Accept-Language ثم en. تُطبّع وسوم الرؤوس الإقليمية مثل fr-CA بأمان إلى fr. لا تقرأ نقطة نهاية bearer ملفات تعريف ارتباط المتصفح أو لغة الحساب أو تفضيلات مساحة العمل.

تقبل كل أداة وسيط locale اختياريًا. تتجاوز قيمة مطابقة من en أو ar أو fr أو de أو es أو ru أو zh الرؤوس لتنفيذ الأداة وأخطائها الآمنة ونص نجاحها وحقل locale في النتيجة المنظمة وContent-Language في HTTP. يبقى الوسيط غير المدعوم خطأ معاملات غير صالحة (-32602) بلغة طلب bearer، ولا يخضع للتطبيع الإقليمي. تضيف الاستجابات x-lang, Accept-Language إلى Vary من دون إزالة القيم الموجودة.

تُترجم فقط أوصاف الأدوات وملخصات النتائج البشرية ورسائل الأخطاء الآمنة. تبقى أسماء الأدوات ومخططاتها وحقول JSON-RPC‏ jsonrpc وcode الرقمي وid وأسماء الخصائص وقيم التعداد والحالة والقيم المنطقية والأعداد والمعرّفات والنطاقات وعناوين URL والكلمات المفتاحية والطوابع الزمنية والمؤشرات والأدلة ونص المستخدم أو المزود المخزن كما هي. تضيف النتائج المنظمة locale ولا تحذف أي حقل موجود.

تحافظ أخطاء البروتوكول على شرطها الرقمي: -32700 لخطأ التحليل و-32600 للطلب غير الصالح و-32601 للطريقة غير المعروفة و-32602 للمعاملات أو الأداة غير الصالحة و-32603 للخطأ الداخلي. تُترجم الرسالة الآمنة من الرمز الرقمي، ولا تُعاد تشخيصات SDK أو التحقق أو المزود الخام. لا يصدر MCP ملفات CSV. يشرح دليل API العامة عقد CSV المتطابق البايتات.

اختر عميلك

يمكن لأي عميل آخر الاتصال إذا كان يدعم Streamable HTTP البعيد وترويسة Authorization مخصصة. لا يوفّر RankMeFast خادم stdio محليًا ولا خادم SSE قديمًا.

Claude Code

أضف خادمًا على مستوى المستخدم. تحافظ علامتا الاقتباس المفردتان على مرجع متغير البيئة من دون توسيعه:

claude mcp add-json --scope user rankmefast \
  '{"type":"http","url":"https://rankme.fast/api/mcp","headers":{"Authorization":"Bearer ${RANKMEFAST_API_KEY}"}}'

تحقّق من الاتصال باستخدام:

claude mcp get rankmefast

يمكنك أيضًا تشغيل /mcp داخل Claude Code. تستخدم واجهة Claude Code في تطبيق سطح المكتب التهيئة نفسها. راجع دليل MCP الرسمي لـ Claude Code.

يختلف موصّل المحادثة في Claude.ai وClaude Desktop: يصف مسار الموصّلات البعيدة فيه OAuth، ولا يدعم ترويسة Bearer ثابتة اعتباطية. لذلك لا يمكنه الاتصال مباشرة إلى أن يوفّر RankMeFast دعم OAuth؛ استخدم Claude Code بدلًا منه. راجع موصّلات Claude المخصصة.

Cursor IDE وCursor Agent CLI

أنشئ ~/.cursor/mcp.json للإعداد على مستوى المستخدم. استبدل القيمتين النائبتين وحافظ على خصوصية الملف:

{
  "mcpServers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

يقرأ Cursor IDE وCursor Agent CLI التهيئة نفسها. تحقّق منها باستخدام:

cursor-agent mcp list
cursor-agent mcp list-tools rankmefast

لتهيئة الفريق، استخدم .cursor/mcp.json، لكن لا تضع مفتاحًا حرفيًا في ملف سيُرفع إلى المستودع. راجع دليل MCP الرسمي لـ Cursor.

VS Code وGitHub Copilot

شغّل MCP: Open User Configuration من لوحة الأوامر، ثم استخدم إدخال كلمة مرور حتى لا يُكتب السر في الملف:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "rankmefast-key",
      "description": "RankMeFast API key",
      "password": true
    }
  ],
  "servers": {
    "rankmefast": {
      "type": "http",
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:rankmefast-key}"
      }
    }
  }
}

شغّل MCP: List Servers لبدء الخادم أو فحصه. يمكن حفظ تهيئة مساحة العمل في .vscode/mcp.json، ويمكن مشاركة نموذج إدخال كلمة المرور بأمان. راجع مرجع تهيئة MCP الرسمي لـ VS Code.

GitHub Copilot CLI

بعد تعيين RANKMEFAST_API_KEY في الصدفة:

copilot mcp add \
  rankmefast \
  --type http \
  --url https://rankme.fast/api/mcp \
  --header "Authorization=Bearer $RANKMEFAST_API_KEY" \
  --tools "*"

توسّع الصدفة قيمة المفتاح قبل أن يحفظ Copilot تهيئة المستخدم، لذا احمِ الملف ~/.copilot/mcp-config.json. راجع إضافة خوادم MCP إلى Copilot CLI.

Windsurf / Cascade

أضف ما يلي إلى ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "rankmefast": {
      "serverUrl": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:RANKMEFAST_API_KEY}"
      }
    }
  }
}

أعد تحميله من Windsurf Settings → Cascade → MCP Servers. راجع دليل MCP الرسمي لـ Windsurf.

Codex CLI وإضافة IDE وChatGPT لسطح المكتب

يشترك Codex CLI وإضافة Codex لبيئات التطوير وواجهة Codex في تطبيق ChatGPT لسطح المكتب في الملف ~/.codex/config.toml على الجهاز نفسه:

[mcp_servers.rankmefast]
url = "https://rankme.fast/api/mcp"
bearer_token_env_var = "RANKMEFAST_API_KEY"

أعد تشغيل بيئة التطوير أو تطبيق سطح المكتب بعد تعيين متغير البيئة. تحقّق منه في CLI باستخدام:

codex mcp list

يمكنك أيضًا تشغيل /mcp داخل جلسة Codex. راجع دليل MCP الرسمي لـ Codex.

لا يقرأ ChatGPT على الويب تهيئة Codex المحلية، لذا ينطبق هذا الإعداد فقط على واجهات Codex في الجهاز الذي هيّأته.

Gemini CLI

بعد تعيين RANKMEFAST_API_KEY في الصدفة:

gemini mcp add \
  --scope user \
  --transport http \
  --header "Authorization: Bearer $RANKMEFAST_API_KEY" \
  rankmefast https://rankme.fast/api/mcp

تحقّق منه باستخدام gemini mcp list أو /mcp داخل Gemini CLI. يحفظ الأمر الترويسة بعد توسيعها في ~/.gemini/settings.json، لذا حافظ على خصوصية هذا الملف. استخدم httpUrl في JSON؛ إذ يخصص Gemini الحقل url لبروتوكول SSE القديم. راجع دليل MCP الرسمي لـ Gemini CLI.

OpenCode

أضف ما يلي إلى الملف العام ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rankmefast": {
      "type": "remote",
      "url": "https://rankme.fast/api/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:RANKMEFAST_API_KEY}"
      }
    }
  }
}

تمنع oauth: false اكتشاف OAuth لأن RankMeFast يستخدم مفتاح Bearer. تحقّق من الإعداد باستخدام:

opencode mcp list
opencode mcp debug rankmefast

راجع دليل MCP الرسمي لـ OpenCode.

JetBrains AI Assistant وJunie

افتح Settings → Tools → AI Assistant → Model Context Protocol (MCP)، وأضف خادم HTTP، ثم الصق:

{
  "mcpServers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

احفظ هذا في إعدادات بيئة التطوير بدلًا من ملف المشروع. فعّل Pass custom MCP servers عندما تريد إتاحة الأدوات لـ Junie أو لوكيل مدمج آخر. راجع دليل MCP الرسمي لـ JetBrains.

Zed

افتح Settings → AI → MCP Servers → Add Remote Server، أو أضف ما يلي إلى إعدادات المستخدم:

{
  "context_servers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

ضع المفتاح الحرفي في إعدادات المستخدم، لا في إعدادات المشروع. يؤكد المؤشر الأخضر بجانب الخادم نجاح الاتصال. راجع دليل MCP الرسمي لـ Zed.

Cline

افتح إعدادات MCP في Cline وأضف خادم Streamable HTTP:

{
  "mcpServers": {
    "rankmefast": {
      "type": "streamableHttp",
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

اترك autoApprove فارغًا حتى يتطلب بدء التدقيق موافقتك. راجع دليل MCP الرسمي لـ Cline.

Roo Code

استخدم إعدادات MCP العامة أو .roo/mcp.json:

{
  "mcpServers": {
    "rankmefast": {
      "type": "streamable-http",
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

اترك alwaysAllow فارغًا حتى تتطلب الإجراءات التي تستهلك الرصيد موافقتك. راجع دليل MCP الرسمي لـ Roo Code.

Kiro IDE وCLI

استخدم ~/.kiro/settings/mcp.json للإعداد العام أو .kiro/settings/mcp.json للمشروع:

{
  "mcpServers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer ${RANKMEFAST_API_KEY}"
      }
    }
  }
}

يوسّع Kiro متغيرات البيئة في الترويسات. راجع تهيئة MCP الرسمية لـ Kiro.

Copilot في بيئات التطوير الأخرى

يستخدم GitHub Copilot في Visual Studio وبيئات JetBrains وXcode وEclipse بنية مختلفة عن VS Code:

{
  "servers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
        }
      }
    }
  }
}

احفظها كتهيئة على مستوى المستخدم ولا ترفع المفتاح إلى المستودع. اتبع دليل إعداد MCP لإضافات Copilot في بيئات التطوير لمعرفة موقع ملف التهيئة في بيئتك.

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

تقتصر القراءات والإجراءات دائمًا على الحساب الذي يملك المفتاح. إذا استخدمت معرّف موقع أو تحليل أو تشغيل من حساب آخر، فستظهر النتيجة على أنه غير موجود.

لا يكتشف عميلك إلا الأدوات التي تسمح بها صلاحيات الحساب والمفتاح الفعلية. غياب أداة مقيّدة أمر متوقع ولا يعني فشل الاتصال.

استكشاف الأخطاء وإصلاحها

• يتعذر على العميل اكتشاف الأدوات: تأكد من أن عنوان URL ينتهي بـ /api/mcp، واختر Streamable HTTP بدلًا من SSE أو stdio، ثم أعد تشغيل العميل.
• أداة متوقعة غير ظاهرة: تحقق من مفتاح الحساب ضمن الإعدادات ← MCP ومن نطاقات ذلك المفتاح ضمن الإعدادات ← مفاتيح API.
• يظهر الموقع على أنه غير موجود: تأكد من أن إعدادات الحساب ونطاقات المفتاح يسمحان به. تستخدم المواقع المحظورة وغير المملوكة الاستجابة نفسها عمدًا.
• الإنفاق غير مسموح: اسمح بـ start_audit وإجراءات الإنفاق في المستويين، أو اتركها معطلة لعميل قراءة فقط.
• 401 Unauthorized: استخدم الترويسة Authorization: Bearer rmf_… كما هي. قد يكون المفتاح مكتوبًا خطأ أو مُبطلاً أو مرتبطًا بحساب غير نشط.
• 402 Upgrade required: يتطلب MCP خطة Starter أو Pro أو Agency. راجع الخطط والحدود والرصيد.
• 405 Method not allowed في المتصفح: هذا متوقع لأن نقطة النهاية تقبل طلبات MCP من نوع POST، لا طلبات GET العادية من المتصفح.
• 429 Too many requests: انتظر مدة حد المعدل الموضحة في ترويسات الاستجابة، ثم أعد المحاولة.
• 503 Unavailable: تم تعطيل MCP أو أنه غير متاح مؤقتًا في نسخة RankMeFast هذه؛ تواصل مع مشغّلها.
• يعمل محليًا لا عبر وكيل: تأكد من أن الوكيل يمرر ترويسات Authorization وContent-Type وAccept إلى /api/mcp.

لاستبدال مفتاح، أنشئ مفتاحًا جديدًا، وحدّثه وتحقق منه في كل عميل، ثم أبطل المفتاح القديم من الإعدادات ← مفاتيح API. يسري الإبطال فورًا.

التوافق

يحتوي سجل هذا الإصدار على الأدوات العشر المذكورة أعلاه فقط. ثماني أدوات للقراءة فقط، وset_action_state تكتب دون أي تكلفة، وstart_audit هي الأداة الوحيدة التي تستهلك حصة من الخطة. لا تملك ميزات رادار العلامة التجارية أو ذكاء المراجعات أو ذكاء الروابط أو تحليلات الزيارات أو اتجاهات الكلمات المفتاحية أو مستشعر SERP أدوات MCP. لم يتغير اسم أي أداة حالية أو شكل معاملاتها.

<!-- mcp-tools: list_sites; get_latest_audit_report; list_keywords; get_rank_history; list_content_analyses; get_content_analysis; start_audit; get_audit_status; list_actions; set_action_state -->

أدلة ذات صلة

• مساعد الذكاء الاصطناعي, استخدم الأدوات المسموح بها نفسها داخل محادثة RankMeFast.
• واجهة API العامة, واجهة القراءة المتاحة لخطة Agency فقط.
• ذكاء المحتوى, تعرّف على بيانات التحليل التي يعيدها MCP.
• أمان الحساب, حافظ على أمان حسابك ومفاتيحك.