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

يوفّر 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 العامة للقراءة فقط.

اختر عميلك

يمكن لأي عميل آخر الاتصال إذا كان يدعم 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، ثم أعد تشغيل العميل.
• 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. يسري الإبطال فورًا.

التوافق

يحتوي سجل هذا الإصدار على الأدوات الثماني المذكورة أعلاه فقط. سبع أدوات للقراءة فقط، و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 -->

أدلة ذات صلة

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