API · MCP · llms.txt

واجهة API للسيو وخادم MCP للمطورين ووكلاء الذكاء الاصطناعي

كل أداة في Yes SEO هي نقطة نهاية JSON مجانية بلا مفتاح — وأداة MCP يمكن لمساعدك الذكي استدعاؤها. دقّق الصفحات، واختبر robots.txt، وتحقق من البيانات المنظمة (schema)، أو افحص وصول زواحف الذكاء الاصطناعي من الكود أو Claude أو ChatGPT أو Cursor أو أي وكيل.

GEThttps://yes-seo.com/api/v1/audit?url=example.com

بداية سريعة

بلا مفتاح API وبدون تسجيل. أرسل طلب GET مع رابط الصفحة؛ والاستجابة بصيغة JSON.

cURL
curl "https://yes-seo.com/api/v1/audit?url=https://example.com"
JavaScript
const r = await fetch('https://yes-seo.com/api/v1/ai-crawler-checker?url=' + encodeURIComponent('https://example.com'));
const { ok, data } = await r.json();
console.log(data);
Python
import requests
r = requests.get('https://yes-seo.com/api/v1/robots-txt-tester', params={'url': 'https://example.com/blog/'})
print(r.json()['data'])

نقطة نهاية التدقيق الكامل

يجري GET /api/v1/audit?url=… التدقيق الكامل لصفحة واحدة ويعيد تقييم السيو وتقييم الظهور في الذكاء الاصطناعي ودرجات الفئات وكل فحص مع درجة خطورته ورسالته وسبب أهميته وطريقة إصلاحه، إضافةً إلى رابط التقرير القابل للمشاركة وتصديره بصيغة Markdown. ويُحتسب ضمن الحد المجاني البالغ 10 من عمليات التدقيق يوميًا لكل عنوان IP.

JSON
{
  "ok": true,
  "tool": "audit",
  "data": {
    "seo_score": 86,
    "ai_visibility_score": 71,
    "categories": { "Indexing": 100, "Content": 78, "AI": 71 },
    "checks": [ { "key": "meta_description", "severity": "warning", "message": "…", "why": "…", "how_to_fix": "…" } ],
    "report_url": "https://yes-seo.com/report/…"
  }
}

نقاط نهاية الأدوات

المعاملات: url (رابط الصفحة)، وdomain (لأدوات SSL وDNS والنطاقات)، وurls (مفصولة بفواصل أو بأسطر جديدة، للأدوات الجماعية)، وtext (لأدوات النصوص)، وlang (en وfr وes وar). الاستخدام العادل: 60 من الطلبات في الساعة لكل عنوان IP.

نقطة النهاية (Endpoint)المدخلاتما الذي تفعله
/api/v1/seo-compareurl, url2صفحتك مقابل صفحة منافس، جنبا إلى جنب مع تعليم الفجوات.
/api/v1/ai-crawler-checkerurlاعرف أي بوتات الذكاء الاصطناعي يسمح لها robots.txt وجدار الحماية.
/api/v1/llms-txt-generatorurlافحص ملف llms.txt الحالي أو أنشئ مسودة جديدة في ثوانٍ.
/api/v1/meta-tags-checkerurlشاهد كل وسوم الميتا في الصفحة وما يجب إصلاحه.
/api/v1/heading-checkerurlشاهد بنية H1–H6 كشجرة واكتشف مشكلات الهيكل.
/api/v1/keyword-density-checkerurl | textأكثر الكلمات والعبارات تكرارا في الصفحة مع العدد والكثافة.
/api/v1/image-alt-checkerurlكل صورة في الصفحة: النص البديل والحجم والصيغة والتحميل.
/api/v1/link-analyzerurlكل رابط داخلي وخارجي مع نصه وقيم rel.
/api/v1/readability-checkerurl | textمقياس Flesch والجمل الطويلة والمبني للمجهول لأي نص.
/api/v1/open-graph-checkerurlعاين رابطك على فيسبوك وX ولينكدإن وواتساب وSlack.
/api/v1/robots-txt-testerurlاختبر أي رابط لـ Googlebot وBingbot وبوتات الذكاء الاصطناعي.
/api/v1/sitemap-validatorurlاعثر على sitemap موقعك وتحقق منه واختبر عينة من روابطه.
/api/v1/sitemap-generatorurlازحف حتى 300 صفحة ونزّل ملف sitemap.xml نظيفًا.
/api/v1/redirect-checkerurlتتبع كل خطوة في سلسلة التحويلات مع الحالة والزمن.
/api/v1/http-header-checkerurlاعرض رؤوس الاستجابة الخام وأثر كل رأس على السيو.
/api/v1/http-status-checkerurlsافحص أكواد الحالة ووجهات التحويل لما يصل إلى 50 رابطًا.
/api/v1/broken-link-checkerurlاختبر حتى 200 رابط في صفحة بحثًا عن 404 والنطاقات الميتة.
/api/v1/canonical-checkerurlافحص rel=canonical ووجهته ونسخ نطاقك المختلفة.
/api/v1/hreflang-checkerurlتحقق من رموز hreflang وx-default والروابط المتبادلة.
/api/v1/schema-validatorurlافحص JSON-LD وmicrodata وRDFa وفق قواعد جوجل.
/api/v1/page-speed-testurlTTFB ووزن الصفحة وعوائق العرض وCore Web Vitals.
/api/v1/mobile-friendly-testurlافحص viewport وCSS المتجاوب وحجم الخط وأهداف اللمس.
/api/v1/indexability-checkerurlهل يمكن لجوجل أرشفة الصفحة؟ اعرف سبب المنع بدقة.
/api/v1/website-technology-checkerurlاكتشف CMS والإطار وCDN وأدوات التحليل خلف أي موقع.
/api/v1/indexnow-submitterurlsأبلغ Bing وYandex وغيرهما بالروابط المتغيرة بنقرة واحدة.
/api/v1/ssl-checkerdomainافحص انتهاء الشهادة وجهة الإصدار والنطاقات وإصدار TLS.
/api/v1/security-headers-checkerurlتقييم من A+ إلى F مع إصلاحات لـ Apache وNginx وCloudflare.
/api/v1/dns-lookupdomainاعرض سجلات A وMX وTXT وCAA مع فحص SPF وDMARC.
/api/v1/domain-age-checkerdomainتاريخ التسجيل والعمر والانتهاء والمسجّل عبر RDAP.

وصف قابل للقراءة آليًا: openapi.json · /api/v1 · /.well-known/api-catalog

خادم MCP لمساعدات الذكاء الاصطناعي

يوفّر خادم Model Context Protocol لدينا الأداة seo_audit إلى جانب كل أدوات الخادم. ويستخدم نقل Streamable HTTP، ولا يتطلب مصادقة، ويعيد JSON منظمًا.

POSThttps://yes-seo.com/mcp

Claude Code

claude mcp add --transport http yes-seo https://yes-seo.com/mcp

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "yes-seo": { "url": "https://yes-seo.com/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "yes-seo": { "type": "http", "url": "https://yes-seo.com/mcp" }
  }
}

Claude وChatGPT وتطبيقات أخرى

في التطبيقات التي تدعم موصّلات MCP البعيدة المخصصة، أضف موصّلًا جديدًا والصق رابط الخادم أعلاه. ثم اطلب مثلًا: “استخدم Yes SEO لتدقيق https://example.com وأخبرني بأهم ثلاثة إصلاحات.”

JSON-RPC الخام

curl -X POST https://yes-seo.com/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ai_crawler_checker","arguments":{"url":"https://example.com"}}}'

صفحات Markdown وllms.txt

لكل صفحة في هذا الموقع نسخة Markdown نظيفة: أضف .md إلى الرابط أو أرسل Accept: text/markdown. يوجد فهرس منتقى في /llms.txt والنص الكامل في /llms-full.txt.

curl https://yes-seo.com/ai-crawler-checker.md
curl -H 'Accept: text/markdown' https://yes-seo.com/glossary
curl https://yes-seo.com/llms.txt

شارة التقييم

اعرض تقييماتك على موقعك أو في ملف README. لكل تقرير شارة SVG ترتبط بالتقرير المباشر:

HTML
<a href="https://yes-seo.com/report/REPORT_ID"><img src="https://yes-seo.com/badge/REPORT_ID.svg" alt="Yes SEO score" width="236" height="22"></a>

الاستخدام العادل

  • مجانية للاستخدام الشخصي والتجاري؛ يرجى تخزين النتائج مؤقتًا والحفاظ على حركة طلبات معقولة.
  • دقّق فقط المواقع المسموح لك بتحليلها. زاحفنا للقراءة فقط ويعرّف بنفسه.
  • تحتاج حدودًا أعلى أو تدقيقًا جماعيًا؟ تواصل معنا. اتصل بنا