Новинка · 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
  • 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-код, зняття блокування), і зроби попередній перегляд трансферу з `--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-ключ ніколи не потрапляє в чат. А якщо термінала немає взагалі, промпт для чату проведе вас через кожен крок.