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

> استخدم Yes SEO من الكود أو من وكلاء الذكاء الاصطناعي: واجهة JSON API مجانية لكل أداة، وخادم MCP لـ Claude وChatGPT وCursor، ومواصفات OpenAPI وllms.txt.

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-compare | url, url2 | صفحتك مقابل صفحة منافس، جنبا إلى جنب مع تعليم الفجوات. |
| /api/v1/ai-crawler-checker | url | اعرف أي بوتات الذكاء الاصطناعي يسمح لها robots.txt وجدار الحماية. |
| /api/v1/llms-txt-generator | url | افحص ملف llms.txt الحالي أو أنشئ مسودة جديدة في ثوانٍ. |
| /api/v1/meta-tags-checker | url | شاهد كل وسوم الميتا في الصفحة وما يجب إصلاحه. |
| /api/v1/heading-checker | url | شاهد بنية H1–H6 كشجرة واكتشف مشكلات الهيكل. |
| /api/v1/keyword-density-checker | url \| text | أكثر الكلمات والعبارات تكرارا في الصفحة مع العدد والكثافة. |
| /api/v1/image-alt-checker | url | كل صورة في الصفحة: النص البديل والحجم والصيغة والتحميل. |
| /api/v1/link-analyzer | url | كل رابط داخلي وخارجي مع نصه وقيم rel. |
| /api/v1/readability-checker | url \| text | مقياس Flesch والجمل الطويلة والمبني للمجهول لأي نص. |
| /api/v1/open-graph-checker | url | عاين رابطك على فيسبوك وX ولينكدإن وواتساب وSlack. |
| /api/v1/robots-txt-tester | url | اختبر أي رابط لـ Googlebot وBingbot وبوتات الذكاء الاصطناعي. |
| /api/v1/sitemap-validator | url | اعثر على sitemap موقعك وتحقق منه واختبر عينة من روابطه. |
| /api/v1/sitemap-generator | url | ازحف حتى 300 صفحة ونزّل ملف sitemap.xml نظيفًا. |
| /api/v1/redirect-checker | url | تتبع كل خطوة في سلسلة التحويلات مع الحالة والزمن. |
| /api/v1/http-header-checker | url | اعرض رؤوس الاستجابة الخام وأثر كل رأس على السيو. |
| /api/v1/http-status-checker | urls | افحص أكواد الحالة ووجهات التحويل لما يصل إلى 50 رابطًا. |
| /api/v1/broken-link-checker | url | اختبر حتى 200 رابط في صفحة بحثًا عن 404 والنطاقات الميتة. |
| /api/v1/canonical-checker | url | افحص rel=canonical ووجهته ونسخ نطاقك المختلفة. |
| /api/v1/hreflang-checker | url | تحقق من رموز hreflang وx-default والروابط المتبادلة. |
| /api/v1/schema-validator | url | افحص JSON-LD وmicrodata وRDFa وفق قواعد جوجل. |
| /api/v1/page-speed-test | url | TTFB ووزن الصفحة وعوائق العرض وCore Web Vitals. |
| /api/v1/mobile-friendly-test | url | افحص viewport وCSS المتجاوب وحجم الخط وأهداف اللمس. |
| /api/v1/indexability-checker | url | هل يمكن لجوجل أرشفة الصفحة؟ اعرف سبب المنع بدقة. |
| /api/v1/website-technology-checker | url | اكتشف CMS والإطار وCDN وأدوات التحليل خلف أي موقع. |
| /api/v1/indexnow-submitter | urls | أبلغ Bing وYandex وغيرهما بالروابط المتغيرة بنقرة واحدة. |
| /api/v1/ssl-checker | domain | افحص انتهاء الشهادة وجهة الإصدار والنطاقات وإصدار TLS. |
| /api/v1/security-headers-checker | url | تقييم من A+ إلى F مع إصلاحات لـ Apache وNginx وCloudflare. |
| /api/v1/dns-lookup | domain | اعرض سجلات A وMX وTXT وCAA مع فحص SPF وDMARC. |
| /api/v1/domain-age-checker | domain | تاريخ التسجيل والعمر والانتهاء والمسجّل عبر RDAP. |

    وصف قابل للقراءة آليًا: [openapi.json](https://yes-seo.com/openapi.json) · [/api/v1](https://yes-seo.com/api/v1) · [/.well-known/api-catalog](https://yes-seo.com/.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نسخ

```
[](https://yes-seo.com/report/REPORT_ID)
```

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

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

- دقّق فقط المواقع المسموح لك بتحليلها. زاحفنا للقراءة فقط ويعرّف بنفسه.

- تحتاج حدودًا أعلى أو تدقيقًا جماعيًا؟ تواصل معنا. [اتصل بنا](https://yes-seo.com/ar/contact)