Ново · v1.0 · отворен код

Домейн CLI и MCP сървър, създадени за AI агенти

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` без моето одобрение.

Копирайте промпт, поставете го в своя AI асистент и го оставете да свърши работата. Всеки промпт започва в тестовата среда OTE и преди всяко платено действие спира и чака вашето одобрение.

  • 64API операции
  • 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 и OTE API ключ, никога в чата.

    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. По-краткият списък с инструменти пести и токени от контекста.
  • Агентите, които имат само shell, получават с едно извикване умение за 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 код, сървъри за имена, child хостове и пренасочване.

  • dna dns · dna dnssec

    Записи в зоната на сървърите за имена на платформата и DS записи в регистъра.

  • dna ssl

    Генериране на CSR, покупка, конфигуриране, проверка на статус, изтегляне, преиздаване и анулиране на сертификати.

  • dna hosting

    Хостинг планове и пакети, нови поръчки и техният статус.

  • dna contact

    Контакти за многократна употреба и тяхната проверка по имейл и телефон.

  • 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.

Безопасно ли е да оставя AI агент да регистрира домейни?

Да, защото агентът не може да купи нищо сам. Платените и деструктивните операции връщат преглед, вместо да се изпълнят. Изпълняват се само след като ги одобрите и извикването съдържа confirm=true, а в CLI – --yes. Започвайте с агентите в тестовата среда OTE и ги ограничете още повече с --read-only или --no-billable.

Мога ли да го пробвам, без да харча пари?

Да. С --env ote dna работи с OTE, нашата тестова среда. Тя има собствен API ключ и собствен баланс и нищо, което правите там, не засяга реалните домейни или истинския ви акаунт.

Кои AI асистенти работят с dna?

Всеки MCP клиент: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI и други. Агентите, които имат само shell, могат да извикват CLI директно; dna agent guide и умението за Claude Code ги учат как.

Нужен ли ми е акаунт в Domain Name API?

Да. dna работи с реселърски акаунт и неговите данни за достъп до API: вашия Reseller ID и API ключ, които са в раздел Настройки на API в реселърския панел. Продукционната среда и OTE имат различни ключове, а имейлът и паролата ви за панела тук не работят.

Безплатен ли е 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, когато работата я върши човек, скрипт или AI агент. Използвайте SDK за PHP, Node.js, Python, Ruby или Go или директно REST API, когато вграждате функции за домейни в собственото си приложение. Всички използват едно и също API и едни и същи данни за достъп.

Трябва ли да използвам терминала?

Не. Поставете готов промпт в Claude Code, който работи и в настолното приложение Claude, или в ChatGPT Codex и асистентът ще инсталира и свърже dna вместо вас. Единствената команда, която пишете сами, е dna auth login, така че API ключът ви никога не попада в чата. Ако изобщо нямате терминал, промптът за чат ще ви преведе през всяка стъпка.