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 متصل کن: برای `@` و `www` رکورد A اضافه کن، سپس زون DNS نهایی را نشانم بده. پیش از تغییر یا حذف هر رکورد موجود، از من بپرس.
dns add · dns listwriteانتقال دامنه به حساب شما
با dna بررسی کن که آیا example.org را میشود به حساب من منتقل کرد، بگو هنوز چه چیزهایی لازم دارم (کد انتقال auth، برداشتن قفل) و انتقال را با `--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 را اجرا کنید تا برای هر کلاینت یک قطعه پیکربندی آماده چاپ شود.
همه 64 عملیات API، دستهبندیشده همانطور که فکر میکنید
هر کاری که 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
توصیفهای ماشینخوان از هر عملیات، ورودی و مقدار کدشده، برای عاملها و سازندگان ابزار.
ساختهشده برای پایپها، کرونجابها و پایپلاینها
در ترمینال جدولهای خوانا میگیرید و در پایپ JSON. خطاها هم JSON هستند، با کدهای خروجی که معنایشان هرگز عوض نمیشود، پس اسکریپت همیشه میداند چه چیزی خراب شده است.
- JSON در پایپ، JSON Lines برای استریمها و --jq داخلی برای کوتاه نگهداشتن خروجی
- اطلاعات API در CI از DNA_RESELLER_ID و DNA_API_KEY، و روی دستگاه خودتان از یک پروفایل
- خارج از ترمینال هیچ پرسش پنهانی در کار نیست: دستور محافظتشده با کد 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 به همان API نمایندگی وصل میشوند. هرکدام را انتخاب کنید که با جای انجام کار جور است.
CLI و سرور MCP
وقتی کار را یک نفر، یک اسکریپت یا یک عامل هوش مصنوعی انجام میدهد: کارهای روزمره، خودکارسازی، CI و دستیارهایی مثل Claude یا Cursor.
SDKها
وقتی قابلیتهای دامنه را در اپلیکیشن خودتان میسازید. PHP، Node.js، Python، Ruby و Go.
SDKها را ببینیدREST API
وقتی کنترل کامل روی هر درخواست را، به هر زبانی، میخواهید. JSON روی HTTPS با دو هدر.
راهنمای API را بخوانیدماژولهای صورتحساب
وقتی از طریق WHMCS، Blesta، HostBill، WiseCP یا Clientexec میفروشید و میخواهید همهچیز خودکار پیش برود.
یکپارچهسازیها را ببینیدپرسشهایی که پیش از اتصال یک عامل مطرح میشود
پاسخهای کوتاه و صریح. README در GitHub همه جزئیات را پوشش میدهد.
مستندات کامل را بخوانیدDomain Name API CLI چیست؟
dna کلاینت خط فرمان و سرور MCP رسمی پلتفرم نمایندگی Domain Name API است. هر 64 عملیات REST API نمایندگی را پوشش میدهد، از جستجو، ثبت، تمدید و انتقال دامنه تا DNS، DNSSEC، مخاطبان، SSL و میزبانی، در قالب یک فایل اجرایی متنباز برای macOS، Linux و Windows با مجوز Apache-2.0.
آیا سپردن ثبت دامنه به یک عامل هوش مصنوعی امن است؟
بله، چون عامل نمیتواند خودسرانه چیزی بخرد. عملیات هزینهدار و مخرب بهجای اجرا، یک پیشنمایش برمیگردانند. این عملیات فقط پس از تأیید شما و وقتی فراخوانی confirm=true را همراه داشته باشد اجرا میشوند، یا در CLI با --yes. عاملها را روی محیط آزمایشی OTE شروع کنید و با --read-only یا --no-billable دسترسیشان را محدودتر کنید.
آیا میتوانم بدون خرجکردن پول امتحانش کنم؟
بله. با --env ote، dna به OTE، محیط آزمایشی ما، وصل میشود. 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 و میزبانی، با قیمتهای نمایندگی خودتان و از موجودی حسابتان پرداخت میکنید.
اطلاعات API من کجا ذخیره میشود؟
dna auth login آنها را در یک فایل پروفایل در پوشه پیکربندی کاربری شما ذخیره میکند که در Linux و macOS فقط خودتان میتوانید آن را بخوانید؛ dna config path محل آن را نشان میدهد. متغیرهای محیطی همیشه اولویت دارند و کلید API در همه خروجیها، از جمله --dry-run، پوشانده میشود.
آیا میتوانم dna را در اسکریپتها و CI استفاده کنم؟
بله. خروجی در پایپ JSON است، خطاها JSON با کدهای خروجی ثابت هستند و خارج از ترمینال تعاملی هیچ پرسشی مطرح نمیشود. اطلاعات API را با DNA_RESELLER_ID و DNA_API_KEY بدهید. دستور هزینهدار بدون --yes با کد 9 خارج میشود و چیزی نمیفرستد.
از CLI استفاده کنم یا SDK؟
وقتی کار را یک نفر، یک اسکریپت یا یک عامل هوش مصنوعی انجام میدهد، از dna استفاده کنید. وقتی قابلیتهای دامنه را در اپلیکیشن خودتان میسازید، از SDK برای PHP، Node.js، Python، Ruby یا Go، یا خود REST API استفاده کنید. همه آنها از همان API و همان اطلاعات API استفاده میکنند.
آیا حتماً باید از ترمینال استفاده کنم؟
خیر. یک پرامپت آماده را در Claude Code، که در اپلیکیشن دسکتاپ Claude هم اجرا میشود، یا در ChatGPT Codex بچسبانید تا دستیار dna را برایتان نصب و وصل کند. تنها دستوری که خودتان تایپ میکنید dna auth login است، پس کلید API شما هرگز وارد چت نمیشود. اگر اصلاً ترمینال ندارید، پرامپت چت شما را گامبهگام راهنمایی میکند.

