MCP وواجهة API

قِس الظهور في الذكاء الاصطناعي من Claude ووكلائك وخط عملك.

تشغّل AeoState خادم Model Context Protocol (MCP) على https://aeostate.com/mcp، وخلفه واجهة HTTP نفسها. اتصل مرة واحدة وستظهر النتيجة المجانية للظهور في الذكاء الاصطناعي كبطاقة تفاعلية في Claude Desktop وclaude.ai وClaude Code وCursor وكل مضيف MCP آخر — أو استدعِ الواجهة مباشرة من سكربت.

الأدوات

الأدوات المجانية تعمل للجميع — بلا حساب ولا مفتاح. أما الأدوات المعلَّمة بـ«مفتاح API» فتعمل نيابةً عن حساب مسجَّل: أنشئ حسابًا مجانيًا ثم مفتاحًا شخصيًا من الحساب ← الوصول عبر API.

اتصل بخطوة واحدة

انسخ أحد هذه المقاطع إلى مضيفك. أضف ترويسة Authorization عندما يكون لديك مفتاح.

نقطة نهاية MCP
https://aeostate.com/mcp
Claude Code
claude mcp add --transport http aeostate https://aeostate.com/mcp
Cursor وVS Code وموصّلات claude.ai ومضيفون آخرون (JSON)
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp"
    }
  }
}
الشيء نفسه، نيابةً عن حسابك
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

HTTP بسيط لخطوط العمل

الاستدعاءات الثلاثة نفسها التي يجريها خادم MCP. ابدأ فحصًا، تابعه، ثم اقرأ التقرير — من CI أو من سير عمل CRM أو من مهمة ليلية.

1 · ابدأ فحصًا
curl -s -X POST https://aeostate.com/api/analyze \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","industry":"family dental clinic","category":"family dental clinic","locale":"en"}'
# → {"mode":"async","jobId":"…"} (poll below) or the finished free summary
2 · تابع حتى يكتمل
curl -s https://aeostate.com/api/scan-jobs/<jobId>
# → {"status":"queued|running|completed|failed","stage":"crawling|scoring|completed","reportId":"…"}
3 · اقرأ التقرير
curl -s https://aeostate.com/api/reports/<reportId>
# → 402 + the free summary (score, grade, confidence, section teasers)

تخضع الفحوصات المجهولة لقواعد النتيجة المجانية في الموقع (حدود الاستخدام؛ وحيث تكون النتيجة المجانية مقيَّدة بالبريد الإلكتروني يُرسَل الرابط بالبريد). ومع مفتاح تعمل باسم حسابك: بلا بوابة، بحدود لكل مفتاح، ومع تقاريرك المدفوعة.

كيف يعثر وكلاء الذكاء الاصطناعي على AeoState

إلى جانب خادم MCP، تنشر AeoState أوصافًا قابلة للقراءة آليًا ليتمكن وكلاء الذكاء الاصطناعي وسجلات الوكلاء من اكتشافها بأنفسهم. يجيب كل عنوان أدناه بملف JSON يمكن لأي موقع قراءته.

بطاقة خادم MCP
https://aeostate.com/.well-known/mcp/server-card.json
كتالوج الذكاء الاصطناعي (ARD)
https://aeostate.com/.well-known/ai-catalog.json
كتالوج واجهات API (RFC 9727)
https://aeostate.com/.well-known/api-catalog

مهارات الوكلاء (Agent Skills)

يمكن للوكلاء الذين يدعمون Agent Skills تحميل المهارة التي تنشرها AeoState من هذا الفهرس. توضّح لهم المهارة كيفية تشغيل فحص مجاني للظهور في الذكاء الاصطناعي عبر خادم MCP أو واجهة HTTP API، وكيفية قراءة النتيجة. تُدرج كل مهارة مع بصمة SHA-256 ليتحقق الوكيل مما نزّله.

فهرس Agent Skills
https://aeostate.com/.well-known/agent-skills/index.json

الصفحات بصيغة markdown

اطلب أي صفحة عامة مع الترويسة Accept: text/markdown لتحصل على نصها بصيغة markdown بدلًا من HTML، مع العنوان والرابط واللغة في أعلاها. تبقى المتصفحات تتلقى الصفحة العادية.

مثال
curl -H "Accept: text/markdown" https://aeostate.com/ar/pricing

أدوات داخل المتصفح (WebMCP)

في متصفح يدعم WebMCP، يستطيع وكيل ذكاء اصطناعي يعمل على هذا الموقع فتح صفحاته، والاطلاع على الأسعار الحالية، ومتابعة فحص جارٍ، وملء نموذج التقييم المجاني. ويبقى الزائر هو من يؤكد النموذج ويرسله. ما زال WebMCP تجريبيًا ومتاحًا في بعض إصدارات المتصفحات فقط؛ ولا يتغير شيء في غيرها.

النتيجة المجانية مقابل تقرير Advanced

بدون حساب

النتيجة المجانية — كل أداة، كل زائر

  • درجة ظهورك الإجمالية وتقديرها ومدى ثقتنا بها
  • أي زواحف الذكاء الاصطناعي تستطيع الوصول إلى موقعك وأيها لا تستطيع
  • أول ما يعيق ظهورك

احصل على مفتاح API شخصي

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

احصل على مفتاحك