جديد · v1.0 · مفتوح المصدر

أداة CLI وخادم MCP للنطاقات، مصمّمان لوكلاء الذكاء الاصطناعي

dna هي أداة سطر الأوامر الرسمية وخادم MCP من Domain Name API. انسخ موجّهًا جاهزًا والصقه في Claude أو ChatGPT، وسيتولى مساعدك تثبيتها وربطها ثم يبدأ العمل على نطاقاتك وDNS وSSL والاستضافة. وكل ما يكلّف مالًا ينتظر موافقتك.

إعداد dna في Claude Code

قم بإعداد أداة dna CLI لي (https://github.com/domainreseller/cli).
1. ثبّتها باستخدام سكربت التثبيت الرسمي الخاص بنظام التشغيل لديّ، ثم شغّل ‎`dna version`‎ و‎`dna doctor`‎.
2. ثبّت مهارة Claude Code باستخدام ‎`dna agent skill --install`‎، وأضف خادم MCP باستخدام ‎`claude mcp add dna -- dna mcp serve --env ote`‎.
3. لا تطلب مني لصق مفتاح API الخاص بي في هذه المحادثة. اطلب مني تشغيل ‎`dna auth login --env ote`‎ بنفسي، ثم تحقّق من الاتصال باستخدام ‎`dna --ote account get`‎.
اعمل في بيئة الاختبار OTE فقط، ولا تستخدم ‎`--yes`‎ أبدًا دون موافقتي.

انسخ موجّهًا، والصقه في مساعد الذكاء الاصطناعي لديك، واتركه ينجز العمل. يبدأ كل موجّه في بيئة الاختبار OTE، ويتوقف لانتظار موافقتك قبل أي عملية مدفوعة.

  • 64عملية API
  • 65أداة MCP
  • 4فئات أمان
  • 6منصات، ملف تنفيذي واحد
  • Apache-2.0ترخيص مفتوح المصدر
بكلام بسيط

موجّهات جاهزة لـ Claude وChatGPT

غيّر أسماء النطاقات، والصق الموجّه في مساعدك، وشاهده يعمل. كل موجّه يحدد أين يتوقف، فلا تُنفَّذ أي عملية مدفوعة من دونك.

البحث عن نطاق وتسجيله

باستخدام dna، تحقّق مما إذا كانت النطاقات brandname.com وbrandname.net وbrandname.io متاحة. اعرض النتائج مع أسعارها في جدول، ثم عاين تسجيل أرخص نطاق متاح منها باستخدام ‎`--dry-run`‎. لا تسجّل أي شيء حتى أقول نعم.
domain bulk-search · domain registerbillable

التجديدات القادمة

باستخدام dna، اعرض قائمة بنطاقاتي التي تنتهي صلاحيتها خلال الأيام الـ60 القادمة مع أسعار تجديدها، مرتبةً حسب تاريخ الانتهاء. لا تجدّد أي شيء.
domain list · domain renew-checkread

توجيه نطاق إلى خادم

باستخدام dna، وجّه example.com إلى 203.0.113.10: أضف سجلات A لـ ‎`@`‎ و‎`www`‎، ثم اعرض لي منطقة DNS النهائية. اسألني قبل تعديل أي سجل موجود أو حذفه.
dns add · dns listwrite

نقل نطاق إلى حسابك

باستخدام dna، تحقّق مما إذا كان يمكن نقل example.org إلى حسابي، وأخبرني بما لا يزال ينقصني (رمز التفويض auth code، وإلغاء القفل)، وعاين عملية النقل باستخدام ‎`--dry-run`‎.
domain transfer-check · domain transferbillable

طلب شهادة SSL

باستخدام dna، ابحث عن أرخص شهادة DV SSL لـ example.com، وأنشئ CSR، وعاين الطلب. انتظر موافقتي قبل الشراء.
product ssls · ssl generate-csr · ssl initializebillable

قل ما تحتاجه، ووكيلك يجد الأمر المناسب.

كل عملية في API أداةٌ لها وصف واضح ومخطط JSON، فيختار المساعد الاستدعاء الصحيح ويملأ حقوله بدقة من المرة الأولى. أنت تتكلم، وdna تتولى التنفيذ بدقة.

بوابة الأمان

وكيلك لا يستطيع إنفاق قرش واحد من دونك

لكل أمر فئة أمان، والفئة هي التي تحدد ما يحدث. الاستكشاف والتغييرات المجانية القابلة للتراجع تُنفَّذ فورًا. أما أي شيء يُخصم من رصيدك أو لا يمكن التراجع عنه، فيتوقف ويسألك أولًا.

  • read

    قراءة

    البحث والقوائم ومعلومات النطاق والأسعار وقواعد الامتدادات.

    يُنفَّذ فورًا
  • write

    كتابة

    سجلات DNS وقفل النقل وخصوصية WHOIS وجهات الاتصال. مجانية وقابلة للتراجع.

    يُنفَّذ فورًا
  • destructive

    تدميرية

    حذف سجل، وإلغاء شهادة SSL، وتعطيل DNSSEC.

    ينتظر موافقتك
  • billable

    مدفوعة

    طلبات التسجيل والتجديد والنقل والاستعادة وSSL والاستضافة.

    ينتظر موافقتك

كيف تعمل الموافقة

الأدوات المقيّدة تأخذ حقلًا إضافيًا اسمه confirm. ومعظم عملاء MCP يسألونك أيضًا قبل كل استدعاء أداة؛ وتساعدهم وسوم الأمان على تمييز الاستدعاءات الخطرة.

  1. الوكيل يسأل أولًا

    يستدعي الأداة دون confirm. لا يُرسل أي شيء، ويعود إليه عرض مسبق للطلب كما هو بالضبط.

  2. القرار لك

    يعرض عليك الوكيل النطاق والمدة والعملية. وأنت تقول نعم أو لا.

  3. يُنفَّذ مرة واحدة

    لا يكرر الاستدعاء مع confirm=true إلا بعد موافقتك. ولا يُعاد إرسال أي استدعاء مدفوع أبدًا بعد خطأ في الشبكة.

حدّد إلى أي مدى يمكنه الوصول

--env ote
بيئة الاختبار: API حقيقية، بلا أموال حقيقية
--read-only
يطّلع ولا يلمس. كل تغيير محظور.
--no-billable
كل شيء ما عدا المشتريات
--groups domain,dns
مجموعات الأوامر التي تحددها فقط
--dry-run
يطبع طلب HTTP كما هو بالضبط مع إخفاء مفتاح API
البدء

من الموجّه إلى أول نطاق في أربع خطوات، كلها في بيئة الاختبار

OTE هي بيئة الاختبار لدينا: API نفسها بمفتاح API خاص ورصيد خاص. تدرّب هناك، ثم انتقل إلى بيئة الإنتاج بخيار واحد.

  1. انسخ موجّهًا

    اختر Claude Code أو ChatGPT Codex أو الدردشة العادية أعلى هذه الصفحة، وانسخ الموجّه.

  2. الصقه في مساعدك

    يثبّت dna، ويضيف خادم MCP، ويشغّل dna doctor للتحقق من الإعداد.

    dna doctor
  3. سجّل الدخول إلى OTE بنفسك

    شغّل أمر تسجيل الدخول في طرفيتك أنت، وأدخل هناك معرّف الموزّع ومفتاح API الخاص ببيئة OTE، لا في المحادثة أبدًا.

    dna auth login --env ote
  4. اطلب بكلام بسيط

    ابحث، وعاين باستخدام --dry-run، ثم سجّل. وكل ما يُخصم من رصيد الاختبار ينتظر موافقتك.

    --dry-run
الإعداد اليدوي

تفضّل الطرفية؟ أمران فقط وتصبح متصلًا

ثبّت الملف التنفيذي، ثم أضف dna mcp serve إلى عميل MCP لديك. تصبح كل عملية في API أداةً لـ Claude Code أو Claude Desktop أو Cursor أو VS Code أو Windsurf أو Codex CLI أو Gemini CLI.

$ curl -fsSL https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.sh | sh

ملف تنفيذي واحد بلا أي تبعيات. كل إصدار يأتي مع مجاميع تحقق SHA-256.

  • أداة لكل عملية في API، ولكل منها مخطط JSON مبني من مواصفات API
  • تُخبر dna_context النموذج قبل أن يلمس أي شيء ما إذا كان يعمل على بيئة الإنتاج أم بيئة الاختبار
  • اعرض ما تحتاجه فقط باستخدام --groups أو --read-only. كما أن قائمة الأدوات الأقصر توفّر رموز السياق.
  • الوكلاء الذين لا يملكون سوى سطر الأوامر يحصلون على مهارة Claude Code ودليل استخدام باستدعاء واحد
# اتصل ببيئة الاختبار أولًا
$ claude mcp add dna -- dna mcp serve --env ote

# للقراءة فقط، ومشترك مع فريقك عبر .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

شغّل dna mcp config لطباعة مقتطف جاهز لكل عميل.

التغطية

جميع عمليات API البالغة 64، مجمّعة بالطريقة التي تفكر بها

كل ما تستطيع API الموزّعين فعله، تستطيعه dna أيضًا. يعرض --help لكل أمر فئة الأمان ومسار API وأمثلة.

  • dna domain

    البحث الفردي والجماعي، والتسجيل والتجديد والنقل والاستعادة. قفل النقل وخصوصية WHOIS ورمز النقل (auth) وخوادم الأسماء والمضيفات الفرعية وإعادة التوجيه.

  • dna dns · dna dnssec

    سجلات المنطقة على خوادم أسماء المنصة، وسجلات DS لدى السجل.

  • dna ssl

    إنشاء CSR والشراء والإعداد والتحقق من الحالة والتنزيل وإعادة الإصدار وإلغاء الشهادات.

  • dna hosting

    خطط الاستضافة وباقاتها، والطلبات الجديدة وحالتها.

  • dna contact

    جهات اتصال قابلة لإعادة الاستخدام، والتحقق من بريدها الإلكتروني وهاتفها.

  • dna account · product · order

    الرصيد والمعاملات، وكتالوج الامتدادات مع الأسعار، وحالة الطلبات.

  • dna api

    طلب خام موثَّق إلى أي نقطة نهاية، بقواعد الأمان نفسها.

  • dna schema · enums · agent

    أوصاف قابلة للقراءة آليًا لكل عملية ومُدخل وقيمة مرمّزة، للوكلاء ومطوري الأدوات.

اطّلع على مرجع الأوامر الكامل

السكربتات وCI

مصمَّم للأنابيب ومهام cron وخطوط CI

في الطرفية تحصل على جداول سهلة القراءة، وعبر الأنبوب تحصل على JSON. والأخطاء أيضًا بصيغة JSON، مع رموز خروج لا يتغير معناها أبدًا، فيعرف السكربت دائمًا أين الخلل.

  • JSON عند التمرير عبر أنبوب، وJSON Lines للتدفقات، وخيار --jq مدمج لتقليص المخرجات
  • بيانات الاعتماد من DNA_RESELLER_ID وDNA_API_KEY في CI، ومن ملف تعريف على جهازك الخاص
  • لا مطالبات خفية خارج الطرفية: الأمر المقيّد يخرج بالرمز 9 ولا يرسل شيئًا
  • يجري التحقق من المدخلات قبل إرسال أي شيء، وتُعاد المحاولة تلقائيًا عند تجاوز حد المعدل
# النطاقات التي تنتهي خلال الأيام الـ30 القادمة، بصيغة CSV
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# افحص أسماء كثيرة دفعة واحدة
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# في السكربت، تتوقف أي عملية شراء دون --yes هنا
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
رموز الخروج
0نجاح6تجاوز حد المعدل
2مدخلات غير صالحة، لم يُرسل شيء7خطأ في الخادم
3المصادقة8الشبكة
4غير موجود9يلزم التأكيد
5رفضته API10وضع القراءة فقط
اختيار الأداة

CLI أم SDK أم REST API أم وحدة جاهزة؟

كلها تتصل بـ API الموزّعين نفسها وببيانات الاعتماد نفسها. اختر ما يناسب المكان الذي يجري فيه العمل.

الأسئلة الشائعة

ما يسأل عنه الناس قبل ربط وكيل

إجابات قصيرة ومباشرة. ملف README على GitHub يغطي كل التفاصيل.

اقرأ الوثائق الكاملة
ما هي Domain Name API CLI؟

dna هي عميل سطر الأوامر الرسمي وخادم MCP لمنصة موزّعي Domain Name API. تغطي جميع عمليات REST API للموزّعين البالغة 64، من البحث عن النطاقات وتسجيلها وتجديدها ونقلها إلى DNS وDNSSEC وجهات الاتصال وSSL والاستضافة، في ملف تنفيذي واحد مفتوح المصدر لأنظمة macOS وLinux وWindows بترخيص Apache-2.0.

هل من الآمن أن أترك وكيل ذكاء اصطناعي يسجّل النطاقات؟

نعم، لأن الوكيل لا يستطيع شراء أي شيء بمفرده. العمليات المدفوعة والتدميرية تُرجع عرضًا مسبقًا بدلًا من أن تُنفَّذ. ولا تُنفَّذ إلا بعد موافقتك وعندما يحمل الاستدعاء confirm=true، أو --yes في CLI. ابدأ بتشغيل الوكلاء على بيئة الاختبار OTE، وضيّق صلاحياتهم أكثر باستخدام --read-only أو --no-billable.

هل يمكنني تجربتها دون إنفاق المال؟

نعم. مع --env ote تتصل dna ببيئة الاختبار لدينا OTE. لها مفتاح API خاص بها ورصيد خاص بها، ولا شيء مما تفعله هناك يمس النطاقات الحية أو حسابك الحقيقي.

أي مساعدي الذكاء الاصطناعي يعملون مع dna؟

أي عميل MCP: Claude Code وClaude Desktop وCursor وVS Code وWindsurf وOpenAI Codex CLI وGemini CLI وغيرها. أما الوكلاء الذين لا يملكون سوى سطر الأوامر فيمكنهم استدعاء CLI مباشرة؛ ويعلّمهم dna agent guide ومهارة Claude Code طريقة ذلك.

هل أحتاج إلى حساب في Domain Name API؟

نعم. تعمل dna مع حساب موزّع وبيانات اعتماد API الخاصة به: معرّف الموزّع ومفتاح API، وكلاهما في إعدادات API داخل لوحة الموزّع. لبيئة الإنتاج ولـ OTE مفاتيح مختلفة، ولن يعمل هنا البريد الإلكتروني وكلمة المرور الخاصان بلوحتك.

هل dna مجانية؟

نعم. الأداة مجانية ومفتوحة المصدر بترخيص Apache-2.0. أنت تدفع فقط مقابل ما تشتريه من خلالها، مثل النطاقات والتجديدات وSSL والاستضافة، بأسعار الموزّع الخاصة بك ومن رصيد حسابك.

أين تُخزَّن بيانات الاعتماد الخاصة بي؟

يحفظها dna auth login في ملف تعريف داخل مجلد إعدادات المستخدم، ولا يستطيع قراءته سواك على Linux وmacOS؛ ويُظهر dna config path مكانه. متغيرات البيئة لها الأولوية دائمًا، ومفتاح API مخفي في كل المخرجات، بما فيها --dry-run.

هل يمكنني استخدام dna في السكربتات وCI؟

نعم. المخرجات بصيغة JSON عند التمرير عبر أنبوب، والأخطاء بصيغة JSON مع رموز خروج ثابتة، ولا توجد مطالبات خارج الطرفية التفاعلية. مرّر بيانات الاعتماد عبر DNA_RESELLER_ID وDNA_API_KEY. وأي أمر مدفوع دون --yes يخرج بالرمز 9 ولا يرسل شيئًا.

هل أستخدم CLI أم SDK؟

استخدم dna عندما يتولى العمل شخص أو سكربت أو وكيل ذكاء اصطناعي. واستخدم SDK لـ PHP أو Node.js أو Python أو Ruby أو Go، أو REST API نفسها، عندما تبني ميزات النطاقات داخل تطبيقك. وكلها تستخدم API نفسها وبيانات الاعتماد نفسها.

هل عليّ استخدام الطرفية؟

لا. الصق موجّهًا جاهزًا في Claude Code، الذي يعمل أيضًا داخل تطبيق Claude لسطح المكتب، أو في ChatGPT Codex، وسيثبّت المساعد dna ويربطها لك. الأمر الوحيد الذي تكتبه بنفسك هو dna auth login، فلا يصل مفتاح API الخاص بك إلى المحادثة أبدًا. وإن لم تكن لديك طرفية على الإطلاق، فإن موجّه الدردشة يرشدك في كل خطوة.