Новинка · v1.0 · открытый код

Доменный 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` без моего подтверждения.

Скопируйте промпт, вставьте его в ИИ-ассистента — остальное он сделает сам. Каждый промпт начинает работу в тестовой среде 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-клиентов к тому же спрашивают вас перед каждым вызовом инструмента, а аннотации безопасности помогают им выделять рискованные.

  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 сами

    Выполните команду входа в своём терминале и введите там Reseller ID и 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-код, 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

    Машиночитаемые описания всех операций, входных параметров и кодированных значений — для агентов и разработчиков инструментов.

Полный справочник команд

Скрипты и 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. Он охватывает все 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-ключ никогда не попадает в чат. А если терминала нет вовсе, промпт для чата проведёт вас через каждый шаг.