Доменный CLI и MCP-сервер, созданные для ИИ-агентов
dna — официальный инструмент командной строки и MCP-сервер Domain Name API. Скопируйте готовый промпт в Claude или ChatGPT — ассистент сам установит и подключит dna, а затем возьмётся за ваши домены, 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
- 65MCP-инструментов
- 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-код, снятие блокировки), и сделай предпросмотр трансфера с `--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 сами
Выполните команду входа в своём терминале и введите там Reseller ID и 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-код, NS-серверы, дочерние хосты и переадресация.
dna dns · dna dnssec
Записи зоны на NS-серверах платформы и DS-записи в реестре.
dna ssl
Создание CSR, покупка, настройка, проверка статуса, скачивание, перевыпуск и отзыв сертификатов.
dna hosting
Тарифы и пакеты хостинга, новые заказы и их статус.
dna contact
Контакты для повторного использования и подтверждение их e-mail и телефона.
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. Он охватывает все 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, нашей тестовой средой. У неё свой 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: вашим Reseller ID и API-ключом — оба находятся в разделе «Настройки API» панели реселлера. У боевой среды и OTE разные ключи, а e-mail и пароль от панели здесь не подойдут.
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-ключ никогда не попадает в чат. А если терминала нет вовсе, промпт для чата проведёт вас через каждый шаг.

