Жаңа · v1.0 · ашық бастапқы код

AI агенттеріне арналған домен CLI және MCP сервері

dna — Domain Name API ұсынатын ресми командалық жол құралы және MCP сервері. Дайын промптты көшіріп, 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` қолданба.

Промптты көшіріп, 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 адресіне бағытта: `@` және `www` үшін A жазбаларын қос, содан кейін маған соңғы DNS зонасын көрсет. Бар жазбаны өзгертпес не жоймас бұрын менен сұра.
dns add · dns listwrite

Доменді тіркелгіңізге трансфер етіңіз

dna арқылы example.org доменін менің тіркелгіме трансфер етуге бола ма, тексер; маған әлі не керек екенін айт (auth коды, құлыпты алып тастау) және трансферді `--dry-run` арқылы алдын ала көрсет.
domain transfer-check · domain transferbillable

SSL сертификатына тапсырыс беріңіз

dna арқылы example.com үшін ең арзан DV SSL сертификатын тап, 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
API кілті жасырылған нақты HTTP сұранысын шығарады
Бастау

Промпттан алғашқы доменге дейін төрт қадам, бәрі тест ортасында

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 операциясына бір құрал, әрқайсысында API спецификациясынан құрылған JSON схемасы бар
  • 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 коды, NS серверлер, child хосттар және қайта бағыттау.

  • 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 тапсырмаларына және пайплайндарға арналған

Терминалда оқуға ыңғайлы кестелер, пайпта JSON аласыз. Қателер де JSON түрінде келеді, ал шығу кодтарының мағынасы ешқашан өзгермейді, сондықтан скрипт не дұрыс болмағанын әрқашан біледі.

  • Пайпта JSON, ағындар үшін JSON Lines және шығысты қысқа ұстау үшін кірістірілген --jq
  • Кіру деректері 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растау қажет
5API қабылдамады10тек оқу режимі
Құрал таңдау

CLI, SDK, REST API әлде дайын модуль бе?

Бәрі бір ғана реселлер API-ге бірдей кіру деректерімен қосылады. Жұмыс қай жерде атқарылатынына қарай таңдаңыз.

ЖҚС

Агентті қоспас бұрын жиі қойылатын сұрақтар

Қысқа әрі нақты жауаптар. Барлық егжей-тегжейі GitHub-тағы README-де.

Толық құжаттаманы оқу
Domain Name API CLI дегеніміз не?

dna — Domain Name API реселлер платформасының ресми командалық жол клиенті және MCP сервері. Ол реселлер REST API-дің барлық 64 операциясын қамтиды: домен іздеу, тіркеу, ұзарту және трансферден бастап DNS, DNSSEC, контактілер, SSL және хостингке дейін. Мұның бәрі macOS, Linux және Windows үшін Apache-2.0 лицензиясымен таратылатын бір ашық бастапқы кодты файлда.

AI агентіне домен тіркетуге рұқсат беру қауіпсіз бе?

Иә, өйткені агент өз бетінше ештеңе сатып ала алмайды. Ақылы және деструктивті операциялар орындалудың орнына алдын ала көріністі қайтарады. Олар тек сіз мақұлдағаннан кейін және шақыруда confirm=true (CLI-да --yes) болғанда ғана орындалады. Агенттерді OTE тест ортасында бастаңыз, ал --read-only немесе --no-billable арқылы олардың аясын одан әрі тарылтыңыз.

Ақша жұмсамай сынап көруге бола ма?

Иә. --env ote арқылы dna біздің тест ортамыз OTE-мен жұмыс істейді. Оның өз API кілті мен өз балансы бар, сол жерде істегеніңіздің ешқайсысы нақты домендерге не шынайы тіркелгіңізге әсер етпейді.

dna қандай AI ассистенттерімен жұмыс істейді?

Кез келген 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 кілттері әртүрлі, ал панельге кіретін 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 ме?

Жұмысты адам, скрипт немесе AI агенті атқарса, dna қолданыңыз. Домен функцияларын өз қосымшаңызға енгізсеңіз, PHP, Node.js, Python, Ruby не Go үшін SDK-ны немесе тікелей REST API-ді қолданыңыз. Олардың бәрі бірдей API мен бірдей кіру деректерін пайдаланады.

Терминалды міндетті түрде қолдану керек пе?

Жоқ. Дайын промптты Claude жұмыс үстелі қолданбасында да жұмыс істейтін Claude Code-қа немесе ChatGPT Codex-ке қойыңыз, сонда ассистент dna-ны сіз үшін орнатып, қосады. Өзіңіз теретін жалғыз команда — dna auth login, сондықтан API кілтіңіз ешқашан чатқа түспейді. Терминал мүлде болмаса, чат промпты әр қадамды сізге бір-бірлеп түсіндіреді.