أداة 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` أبدًا دون موافقتي.
إعداد dna في ChatGPT Codex
قم بإعداد أداة dna CLI لي (https://github.com/domainreseller/cli). 1. ثبّتها باستخدام سكربت التثبيت الرسمي الخاص بنظام التشغيل لديّ، ثم شغّل `dna version` و`dna doctor`. 2. أضفها إلى ملف إعدادات Codex لديّ (`~/.codex/config.toml`) كخادم MCP باسم `dna`، على أن يكون الأمر `dna` والوسائط `mcp serve --env ote`. 3. لا تطلب مني لصق مفتاح API الخاص بي في هذه المحادثة. اطلب مني تشغيل `dna auth login --env ote` بنفسي، ثم تحقّق من الاتصال باستخدام `dna --ote account get`. اعمل في بيئة الاختبار OTE فقط، ولا تستخدم `--yes` أبدًا دون موافقتي.
لا تتوفر لديك طرفية؟ اسأل ChatGPT أو Claude عبر الدردشة
اقرأ الملف https://raw.githubusercontent.com/domainreseller/cli/main/llms.txt وصفحات توثيق dna التي يحيل إليها. ثم أعطني أوامر dna الدقيقة، خطوةً بخطوة، لتسجيل نطاق في بيئة الاختبار OTE: التثبيت، وتسجيل الدخول، والبحث، والمعاينة باستخدام `--dry-run`، والتسجيل. واشرح ما يفعله كل أمر.
انسخ موجّهًا، والصقه في مساعد الذكاء الاصطناعي لديك، واتركه ينجز العمل. يبدأ كل موجّه في بيئة الاختبار 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 يسألونك أيضًا قبل كل استدعاء أداة؛ وتساعدهم وسوم الأمان على تمييز الاستدعاءات الخطرة.
الوكيل يسأل أولًا
يستدعي الأداة دون confirm. لا يُرسل أي شيء، ويعود إليه عرض مسبق للطلب كما هو بالضبط.
القرار لك
يعرض عليك الوكيل النطاق والمدة والعملية. وأنت تقول نعم أو لا.
يُنفَّذ مرة واحدة
لا يكرر الاستدعاء مع confirm=true إلا بعد موافقتك. ولا يُعاد إرسال أي استدعاء مدفوع أبدًا بعد خطأ في الشبكة.
حدّد إلى أي مدى يمكنه الوصول
--env ote- بيئة الاختبار: API حقيقية، بلا أموال حقيقية
--read-only- يطّلع ولا يلمس. كل تغيير محظور.
--no-billable- كل شيء ما عدا المشتريات
--groups domain,dns- مجموعات الأوامر التي تحددها فقط
--dry-run- يطبع طلب HTTP كما هو بالضبط مع إخفاء مفتاح API
من الموجّه إلى أول نطاق في أربع خطوات، كلها في بيئة الاختبار
OTE هي بيئة الاختبار لدينا: API نفسها بمفتاح API خاص ورصيد خاص. تدرّب هناك، ثم انتقل إلى بيئة الإنتاج بخيار واحد.
انسخ موجّهًا
اختر Claude Code أو ChatGPT Codex أو الدردشة العادية أعلى هذه الصفحة، وانسخ الموجّه.
الصقه في مساعدك
يثبّت dna، ويضيف خادم MCP، ويشغّل dna doctor للتحقق من الإعداد.
dna doctorسجّل الدخول إلى OTE بنفسك
شغّل أمر تسجيل الدخول في طرفيتك أنت، وأدخل هناك معرّف الموزّع ومفتاح API الخاص ببيئة OTE، لا في المحادثة أبدًا.
dna auth login --env oteاطلب بكلام بسيط
ابحث، وعاين باستخدام --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 | shPS> irm https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.ps1 | iex$ go install github.com/domainreseller/cli/cmd/dna@latestملف تنفيذي واحد بلا أي تبعيات. كل إصدار يأتي مع مجاميع تحقق 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 {
"mcpServers": {
"dna": {
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} {
"servers": {
"dna": {
"type": "stdio",
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} [mcp_servers.dna]
command = "dna"
args = ["mcp", "serve", "--env", "ote"] # مهارة Claude Code: ~/.claude/skills/dna/SKILL.md
$ dna agent skill --install
# دليل مختصر لتعليمات أي وكيل
$ dna agent guide شغّل 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
أوصاف قابلة للقراءة آليًا لكل عملية ومُدخل وقيمة مرمّزة، للوكلاء ومطوري الأدوات.
مصمَّم للأنابيب ومهام 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 | رفضته API | 10 | وضع القراءة فقط |
CLI أم SDK أم REST API أم وحدة جاهزة؟
كلها تتصل بـ API الموزّعين نفسها وببيانات الاعتماد نفسها. اختر ما يناسب المكان الذي يجري فيه العمل.
CLI وخادم MCP
عندما يتولى العمل شخص أو سكربت أو وكيل ذكاء اصطناعي: العمليات اليومية والأتمتة وCI والمساعدون الأذكياء مثل Claude أو Cursor.
حزم SDK
عندما تبني ميزات النطاقات داخل تطبيقك. PHP وNode.js وPython وRuby وGo.
اطّلع على حزم SDKREST API
عندما تريد تحكمًا كاملًا في كل طلب، وبأي لغة. JSON عبر HTTPS مع ترويستين فقط.
اقرأ دليل APIوحدات الفوترة
عندما تبيع عبر WHMCS أو Blesta أو HostBill أو WiseCP أو Clientexec وتريد أن يعمل كل شيء تلقائيًا.
اطّلع على التكاملاتما يسأل عنه الناس قبل ربط وكيل
إجابات قصيرة ومباشرة. ملف 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 الخاص بك إلى المحادثة أبدًا. وإن لم تكن لديك طرفية على الإطلاق، فإن موجّه الدردشة يرشدك في كل خطوة.

