> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/ar/docs/ai-agents

# استخدام DomScan مع وكلاء الذكاء الاصطناعي

اربط DomScan بـ Claude وChatGPT وCursor وVS Code وCodex وWindsurf عبر MCP، وزوّد وكلاء البرمجة بقواعد API التي يحتاجونها، وابدأ من موجّهات جاهزة.

### MCP أم REST API؟

#### استخدم MCP عندما يقرر المساعد

اربط خادم MCP عندما يختار المساعد أي الفحوصات يشغّلها أثناء المحادثة. يعثر المساعد بنفسه على أدوات DomScan، ويسجّل الدخول بحسابك أو بمفتاح API، ويحصل على نتائج منظَّمة بنفس التصنيف وتكاليف الأرصدة ورموز الأخطاء الموجودة في API.

#### استخدم REST عندما يقرر الكود

استدعِ REST API من كود يعمل دون مساعد: المهام المجدولة، وخطوط المعالجة الجماعية، والخوادم الخلفية، وفحوصات CI. وعندما يكتب وكيل برمجة كودًا سيُشحن ضمن منتجك، اجعله يستدعي REST API اعتمادًا على وصف OpenAPI.

تستخدم فرق كثيرة الاثنين معًا: MCP للاستكشاف وبناء النماذج الأولية في محادثة أو محرر، وREST API في الكود الذي يكتبه الوكيل. يستخدم الاثنان مفتاح API نفسه ورصيد النقاط نفسه.

### اربط DomScan بأداة الذكاء الاصطناعي لديك

ثبّت خادم DomScan MCP بنقرة واحدة، أو شغّل أمرًا واحدًا في الطرفية. ستطلب منك أداتك تسجيل الدخول إلى DomScan عند تشغيل أول فحص.

[إضافة إلى Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=domscan&config=eyJ1cmwiOiJodHRwczovL2RvbXNjYW4ubmV0L21jcCJ9)[إضافة إلى VS Code](vscode:mcp/install?%7B%22name%22%3A%22domscan%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdomscan.net%2Fmcp%22%7D)[إضافة إلى VS Code Insiders](vscode-insiders:mcp/install?%7B%22name%22%3A%22domscan%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdomscan.net%2Fmcp%22%7D)

Claude Code

Claude Code بمفتاح API

Codex

تسجيل الدخول في Codex

`codex mcp login domscan`

### الإعداد حسب الأداة

تتصل كل الأدوات بخادم MCP نفسه على `https://domscan.net/mcp`. الأدوات التي تدعم تسجيل الدخول تفتح صفحة تسجيل دخول DomScan عند تشغيل أول فحص. أما الأدوات الأخرى فترسل مفتاح API في الترويسة X-API-Key.

#### Claude Code

شغّل هذا في الطرفية. يطلب منك Claude Code تسجيل الدخول عند أول استخدام لـ DomScan. أضف `--scope user` لإتاحة DomScan في كل المشاريع.

Claude Code

`claude mcp add --transport http domscan https://domscan.net/mcp`

Claude Code بمفتاح API

`claude mcp add --transport http domscan https://domscan.net/mcp --header "X-API-Key: YOUR_API_KEY"`

#### Cursor

استخدم زر Add to Cursor أعلاه، أو أضف هذا الإدخال إلى `~/.cursor/mcp.json` لكل المشاريع أو إلى `.cursor/mcp.json` لمشروع واحد.

mcp.json

```json
{
  "mcpServers": {
    "domscan": {
      "url": "https://domscan.net/mcp"
    }
  }
}
```

#### VS Code

استخدم زر Add to VS Code أعلاه، أو أضف هذا الإدخال إلى `.vscode/mcp.json` في مساحة العمل. سيطلب منك VS Code تسجيل الدخول عند بدء تشغيل الخادم.

.vscode/mcp.json

```json
{
  "servers": {
    "domscan": {
      "type": "http",
      "url": "https://domscan.net/mcp"
    }
  }
}
```

#### Codex

أضف الخادم ثم سجّل الدخول. لاستخدام مفتاح API بدلًا من ذلك، أضف هذه الكتلة إلى `~/.codex/config.toml` واضبط `DOMSCAN_API_KEY` في بيئتك.

Codex

`codex mcp add domscan --url https://domscan.net/mcp`

تسجيل الدخول في Codex

`codex mcp login domscan`

~/.codex/config.toml

```json
[mcp_servers.domscan]
url = "https://domscan.net/mcp"
env_http_headers = { "X-API-Key" = "DOMSCAN_API_KEY" }
```

#### ChatGPT

فعّل وضع المطوّر في ChatGPT من الإعدادات ثم الموصّلات ثم متقدم. بعد ذلك أنشئ موصّلًا بهذا العنوان واختر OAuth. تجد التعليمات خطوة بخطوة في [صفحة إعداد MCP](https://domscan.net/ar/mcp-domain-checker).

عنوان URL لخادم MCP

`https://domscan.net/mcp`

#### Claude

في Claude على الويب أو في Claude Desktop، افتح الإعدادات ثم الموصّلات، وأضف موصّلًا مخصصًا باسم DomScan بهذا العنوان. يفتح Claude صفحة تسجيل دخول DomScan لإكمال الإعداد.

عنوان URL لخادم MCP

`https://domscan.net/mcp`

#### Windsurf

افتح إعدادات MCP في Windsurf، واعرض الإعداد الخام، وأضف هذا الإدخال إلى `mcp_config.json`. استبدل YOUR_API_KEY بمفتاحك.

mcp_config.json

```json
{
  "mcpServers": {
    "domscan": {
      "serverUrl": "https://domscan.net/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
```

لا تتضمن هذه الروابط والأوامر مفتاح API الخاص بك أبدًا. الأدوات التي تدعم تسجيل الدخول تتصل بحساب DomScan الخاص بك مباشرة. لاستخدام مفتاح بدلًا من ذلك، استبدل `YOUR_API_KEY` بمفتاح من [مفاتيح API الخاصة بك](https://domscan.net/ar/api-keys).

### تعليمات لوكلاء البرمجة

الصق هذا في AGENTS.md أو CLAUDE.md أو ملف قواعد المحرر ليستدعي وكلاء البرمجة DomScan بالشكل الصحيح.

AGENTS.md

```text
## DomScan API

استخدم DomScan (https://domscan.net) لفحوصات توفر النطاقات وDNS وWHOIS وRDAP وSSL وأمان البريد الإلكتروني والتقييم.

- عنوان URL الأساسي: `https://domscan.net`. نقاط النهاية تحت `/v1`.
- المصادقة: أرسل `X-API-Key: $DOMSCAN_API_KEY` (أو `Authorization: Bearer $DOMSCAN_API_KEY`). اقرأ المفتاح من متغيرات البيئة. لا تكتبه داخل الكود ولا تسجّله في السجلات ولا تضعه في عنوان URL.
- العقد: اقرأ وصف OpenAPI على https://domscan.net/v1/openapi.json قبل اختيار نقطة نهاية أو معامل، ولا تخمّن أسماء المعاملات. ملخص الموقع لنماذج LLM على https://domscan.net/llms.txt.
- MCP: الخادم البعيد هو https://domscan.net/mcp (HTTP قابل للبث، تسجيل دخول أو ترويسات مفتاح API نفسها).
- النقاط: تستهلك معظم نقاط النهاية نقاطًا. قبل العمل الجماعي أو المتكرر، استدعِ `POST /v1/estimate` مع `method` و`path` و`query` و`body` الخاصة بالطلب، أو أضف `dry_run=true` إلى نقاط نهاية bulk وcompare وrecipe وpricing. كلاهما مجاني. تتبّع ترويستي الاستجابة `X-Credits-Charged` و`X-Credits-Remaining`.
- الدفعات: افحص حتى 50 اسم نطاق كاملًا بطلب `POST /v1/status/bulk` واحد بدل تكرار الفحوصات المفردة في حلقة.
- إعادة المحاولة: أرسل ترويسة `Idempotency-Key` (مثل UUID) مع طلبات POST التي تستهلك نقاطًا. إعادة إرسال الطلب نفسه بالمفتاح نفسه خلال 24 ساعة تُرجع الاستجابة المخزنة دون خصم جديد. أعد المحاولة فقط عندما تكون `error.retryable` تساوي true، وانتظر `Retry-After` عند الخطأ 429.
- الأخطاء: جسم كل خطأ بالشكل `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}`. اعتمد في التفرّع على `error.code` مثل `INVALID_PARAMETER` أو `INSUFFICIENT_CREDITS` أو `RATE_LIMITED`، لا على نص الرسالة.
- المجهول ليس غائبًا: تتضمن النتائج `classification.status` بقيمة `present` أو `absent` أو `unknown`. تعامل مع `unknown` على أنها "حاول مرة أخرى لاحقًا"، ولا تعتبرها متاحة ولا غير موجودة، ولا تعتبر الغياب دليلًا على أن الاسم يمكن تسجيله أو المطالبة به.
- الحداثة: نقاط النهاية التي يمكنها الإجابة من بيانات حديثة تقبل `max_age` بالثواني (`max_age=0` يطلب فحصًا جديدًا) وتُرجع `cache_age_s`. لا يغيّر ذلك التكلفة.
- استجابات أصغر: أضف `fields=a,b.c` أو `compact=true` إلى سلسلة الاستعلام. لا يغيّر أي منهما التكلفة.
- المزيد: https://domscan.net/AGENTS.md و https://domscan.net/docs.
```

### موجّهات للتجربة

انسخ موجّهًا أو افتحه في مساعدك. اربط DomScan أولًا ليتمكن المساعد من تشغيل الفحوصات.

1.

باستخدام DomScan، تحقق مما إذا كانت هذه الأسماء الخمسون متاحة كنطاقات .com: [الصق الأسماء]. قدّر أولًا تكلفة النقاط واعرضها عليّ قبل تشغيل أي شيء. ثم اعرض النتائج المتاحة والمحجوزة والمجهولة في قوائم منفصلة، ولا تعامل النتائج المجهولة على أنها متاحة.

2.

استخدم DomScan لتدقيق أمان البريد الإلكتروني للنطاق example.com: SPF وDKIM وDMARC وحالة القوائم السوداء. اشرح كل مشكلة بلغة بسيطة واقترح سجل DNS الذي يصلحها.

3.

أفكر في شراء example.com. استخدم DomScan لفحص WHOIS وتواريخ التسجيل وDNS وشهادة SSL والسمعة والقيمة التقديرية، ثم لخّص المخاطر وما ينبغي أن أتحقق منه قبل الدفع.

4.

استخدم DomScan للعثور على النطاقات المشابهة والمنتحلة (typosquatting) للنطاق example.com والمسجّلة بالفعل. رتّبها حسب المخاطر ونبّهني إلى أي منها له موقع ويب أو خادم بريد.

5.

أضف DomScan إلى هذا المشروع. اقرأ https://domscan.net/AGENTS.md و https://domscan.net/v1/openapi.json ، ثم اكتب عميلًا صغيرًا مكتوب الأنواع لـ POST /v1/status/bulk يقرأ DOMSCAN_API_KEY من البيئة، ويرسل ترويسة Idempotency-Key، ويبقي النتائج المجهولة منفصلة عن المتاحة. وأضف اختبارات.

### موارد قابلة للقراءة آليًا

وجّه الوكلاء إلى هذه الملفات العامة بدل نسخ الوثائق داخل الموجّهات.

- [`/AGENTS.md`](https://domscan.net/AGENTS.md) دليل الوكلاء العام
- [`/llms.txt`](https://domscan.net/llms.txt) ملخص الموقع لنماذج LLM
- [`/v1/openapi.json`](https://domscan.net/v1/openapi.json) OpenAPI 3.0
- [`/mcp/tool-mapping.json`](https://domscan.net/mcp/tool-mapping.json) أسماء أدوات MCP القديمة والجديدة