أدوات AI Rank Lab، داخل وكيل الذكاء الاصطناعي الخاص بك
يوفر خادم AI Rank Lab MCP نفس الأدوات المتاحة في واجهة برمجة تطبيقات المطورين — المدقق الشامل لتحسين محركات البحث (SEO) وتحسين وكلاء الذكاء الاصطناعي (AEO) والتحسين الجغرافي (GEO)، وبحث جوجل المباشر، ونظرة عامة الذكاء الاصطناعي ووضع الذكاء الاصطناعي لأي بلد وجهاز، وبحث الكلمات المفتاحية، ومؤشرات الويب الأساسية (Core Web Vitals)، وفحوصات رؤية العلامة التجارية بالذكاء الاصطناعي، وتوليد الأسئلة الشائعة (FAQ) وملف llms.txt، بالإضافة إلى بيانات Google Analytics 4، و Search Console، وزيارات الروبوتات وبيانات الاستشهاد الخاصة بك — عبر بروتوكول سياق النموذج (Model Context Protocol). أضفه إلى Claude Code أو Claude Desktop أو Cursor وسيمكن لوكيلك تشغيلها مباشرةً.
مقدمة
The بروتوكول سياق النموذج (MCP) is an open standard that lets AI assistants call external tools. Our MCP server is a thin layer over the /api/v1 REST API: same tools, same credit billing, same account — but callable by Claude, Cursor, or any other MCP-compatible client as part of a conversation.
The server uses the HTTP قابل للتدفق transport in stateless mode, so there is nothing to install or host — you point your client at the endpoint with your API credentials.
نقطة النهاية والمصادقة
يتواجد الخادم على نقطة نهاية واحدة:
POST https://www.airanklab.com/api/v1/mcpEvery request must carry the same two headers as the REST API: x-api-key and x-api-secret. Generate both from لوحة التحكم ← واجهة برمجة التطبيقات (API) وعمليات الدمج.
يحتفظ تكوين عميل MCP الخاص بك بالسر في نص عادي على جهازك. أبقِ ملف التكوين خارج نظام التحكم في الإصدارات، وقم بتغيير زوج المفاتيح من لوحة التحكم إذا تسرب في أي وقت.
Claude.ai (تطبيق الويب)
To connect the MCP server directly in the Claude.ai web interface, open the أضف موصلاً مخصصاً dialog. Claude.ai does not support custom headers, so your credentials go in the URL query string instead.
Paste the following URL into the عنوان URL لخادم MCP البعيد field, replacing the placeholders with your actual API key and secret. Leave the Advanced OAuth fields blank.
https://www.airanklab.com/api/v1/mcp?x-api-key=YOUR_API_KEY&x-api-secret=YOUR_API_SECRETنظراً لأن Claude.ai لا يدعم الرؤوس المخصصة، يجب عليك تضمين بيانات الاعتماد الخاصة بك في معلمات استعلام URL. اعلم أن هذا قد يتسبب في ظهورها في سجلات الوصول إلى الخادم الخاص بنا.
Use the URL exactly as shown — the www. host and no /sse suffix. Claude.ai connects over Streamable HTTP and posts to the exact URL you paste; a different host or path returns an error, and Claude then falls back to an OAuth sign-in flow that this server does not offer.
Claude Code
أمر واحد يضيف الخادم إلى Claude Code (CLI v1.x أو أحدث):
claude mcp add --transport http airanklab https://www.airanklab.com/api/v1/mcp \
--header "x-api-key: YOUR_API_KEY" \
--header "x-api-secret: YOUR_API_SECRET"Then ask Claude Code things like “قم بتشغيل فحص SEO + AEO + GEO على
example.com ولخص المشكلات الحرجة” or “من الذي تستشهد به
نظرة عامة الذكاء الاصطناعي من Google لـ 'أفضل CRM للشركات الناشئة' في الهند على
الجوال؟” — it will call the تدقيق-SEO-AEO-GEO and google-ai-overview tools for you.
Claude Desktop
Add this to your Claude Desktop configuration (الإعدادات ← المطور ← تعديل
التهيئة, file claude_desktop_config.json), then restart the app:
{
"mcpServers": {
"airanklab": {
"url": "https://www.airanklab.com/api/v1/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY",
"x-api-secret": "YOUR_API_SECRET"
}
}
}
}Cursor
Add the same block to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:
{
"mcpServers": {
"airanklab": {
"url": "https://www.airanklab.com/api/v1/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY",
"x-api-secret": "YOUR_API_SECRET"
}
}
}
}الأدوات المتاحة والأسعار
أدوات MCP تعكس نقاط نهاية أداة REST بنسبة واحد إلى واحد وتستخدم نفس رصيد الائتمان — تكلفة الأداة هي نفسها سواء استدعيتها من لوحة التحكم، أو واجهة برمجة تطبيقات REST، أو MCP. قراءات البيانات مجانية؛ يتم استرداد مكالمات الأدوات الفاشلة تلقائيًا.
The three Google tools (google-search, google-ai-overview, google-ai-mode) take a البلد and a الجهاز— name the country (“India”), its ISO code (“IN”) or its numeric location code (2356), and pick سطح المكتب or الجوال. Results differ markedly between the two, so measure the one your buyers actually use. The مواقع-البحث tool lists every supported market. The GA4 and Search Console tools are free because they read your own Google data — connect those accounts in the dashboard first.
فحص-استشهادات-الذكاء-الاصطناعي asks ChatGPT, Perplexity, Claude and Gemini the same question in one call and reports which of them cite you — it is billed per engine, so naming fewer engines costs less. The backlink tools (نظرة-عامة-على-الروابط-الخلفية, سجل-الروابط-الخلفية, قائمة-الروابط-الخلفية, النطاقات المحيلة, نص الارتساء, سلطة النطاق بالجملة) work on أيdomain, not just the ones registered on your account, so an agent can research a competitor’s link profile directly. The free مرشحات الروابط الخلفية tool lists the presets, modes and fields the filtered backlink queries accept.
| أداة | الوصف | الرصيد لكل استدعاء |
|---|---|---|
ai-citation-check | Ask ChatGPT, Perplexity, Claude and Gemini one question and see who cites you | 100 per engine |
backlinks-list | Every individual backlink, with anchors, authority and spam signals | 150 |
seo-aeo-geo-audit | Full SEO + AEO + GEO checker — the same three-pillar report as the dashboard | 50 |
audits | Technical + AEO audit of a single URL | 50 |
google-search | Live Google SERP for one query, by country and device | 100 |
google-ai-overview | Google's AI Overview answer and the sources it cites | 100 |
google-ai-mode | Google's AI Mode conversational answer and its sources | 100 |
brand-visibility | Ask a live AI engine about a brand | 100 per engine |
keyword-research | Keyword volume, difficulty, intent and live SERP | 50 typical; billed per lookup |
core-web-vitals | Core Web Vitals / PageSpeed scan | 25 |
referring-domains | Domains linking to any site, ranked by authority | 25 |
anchor-text | Anchor text distribution and over-optimization signals | 25 |
bulk-domain-authority | Authority rank for up to 100 domains in one call | 25 |
faq-generator | Generate an FAQ plus FAQPage schema for a page | 20 |
llms-txt | Generate an llms.txt manifest | 20 |
backlinks-overview | Backlink profile summary for any domain: rank, referring domains, spam score | 15 |
backlinks-history | Month-by-month backlink trend with new and lost links | 15 |
backlink-filters | Filter presets, modes and fields the backlink tools accept | Free |
gsc-performance | Search Console clicks, impressions, CTR and position | Free |
gsc-sites | Your verified Search Console properties | Free |
ga4-report | Any GA4 metrics and dimensions over your property | Free |
ga4-realtime | GA4 activity in the last 30 minutes | Free |
ga4-properties | Your connected GA4 properties | Free |
tracking-stats | AI bot visit stats for your domain | Free |
citations | Where AI engines cite your site | Free |
search-locations | Countries, languages and devices the search tools accept | Free |
keyword-research-estimate | Preview a keyword-research cost before running it | Free |
credits | Current credit balance | Free |
أدوات تستغرق وقتاً طويلاً
Heavier tools (audits, brand visibility) normally finish within the request. Each call has a ميزانية 120 ثانية: if the work isn't done in time, the tool returns a معرف المهمة with polling instructions instead of the result.
Poll GET /api/v1/jobs/{jobId} (REST, same headers) until the status is مكتمل — see المهام غير المتزامنة in the API reference.
حدود المعدل
MCP requests count against the same per-key limit as the REST API: 60 طلبًا في الدقيقة by default. A 429 response includes أعد المحاولة بعد. Need a higher limit? اتصل بنا.
اربط وكيلك
أنشئ مفتاح API الخاص بك وسرّه، الصق كتلة تهيئة واحدة، وسيتمكن وكيل الذكاء الاصطناعي الخاص بك من تشغيل أدوات تسويقية حقيقية.
Get your API key