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

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

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

MCP أم REST API؟

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

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

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

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

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

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

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

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

لا تتضمن هذه الروابط والأوامر مفتاح API الخاص بك أبدًا. الأدوات التي تدعم تسجيل الدخول تتصل بحساب DomScan الخاص بك مباشرة. لاستخدام مفتاح بدلًا من ذلك، استبدل YOUR_API_KEY بمفتاح من مفاتيح API الخاصة بك.

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

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

## 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: [الصق الأسماء]. قدّر أولًا تكلفة النقاط واعرضها عليّ قبل تشغيل أي شيء. ثم اعرض النتائج المتاحة والمحجوزة والمجهولة في قوائم منفصلة، ولا تعامل النتائج المجهولة على أنها متاحة.

   فتح في Claudeفتح في ChatGPTفتح في Cursor

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

   فتح في Claudeفتح في ChatGPTفتح في Cursor

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

   فتح في Claudeفتح في ChatGPTفتح في Cursor

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

   فتح في Claudeفتح في ChatGPTفتح في Cursor

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

   فتح في Claudeفتح في ChatGPTفتح في Cursor

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

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

• /AGENTS.md دليل الوكلاء العام
• /llms.txt ملخص الموقع لنماذج LLM
• /v1/openapi.json OpenAPI 3.0
• /mcp/tool-mapping.json أسماء أدوات MCP القديمة والجديدة