جدید · 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 متصل کن: برای ‎`@`‎ و ‎`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 هم پیش از هر فراخوانی ابزار از شما می‌پرسند؛ برچسب‌های ایمنی به آن‌ها کمک می‌کند موارد پرخطر را مشخص کنند.

  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 را اجرا کنید تا برای هر کلاینت یک قطعه پیکربندی آماده چاپ شود.

پوشش

همه 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

    توصیف‌های ماشین‌خوان از هر عملیات، ورودی و مقدار کدشده، برای عامل‌ها و سازندگان ابزار.

مرجع کامل دستورها را ببینید

اسکریپت‌ها و CI

ساخته‌شده برای پایپ‌ها، کرون‌جاب‌ها و پایپ‌لاین‌ها

در ترمینال جدول‌های خوانا می‌گیرید و در پایپ 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ردشده توسط API10حالت فقط‌خواندنی
انتخاب ابزار

CLI، SDK، REST API یا ماژول آماده؟

همه با همان اطلاعات API به همان API نمایندگی وصل می‌شوند. هرکدام را انتخاب کنید که با جای انجام کار جور است.

پرسش‌های متداول

پرسش‌هایی که پیش از اتصال یک عامل مطرح می‌شود

پاسخ‌های کوتاه و صریح. 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 شما هرگز وارد چت نمی‌شود. اگر اصلاً ترمینال ندارید، پرامپت چت شما را گام‌به‌گام راهنمایی می‌کند.