Novinka · v1.0 · open source

Doménové CLI a MCP server vytvorené pre AI agentov

dna je oficiálny nástroj príkazového riadka a MCP server Domain Name API. Vložte hotový prompt do Claude alebo ChatGPT a váš asistent ho nainštaluje, pripojí a pustí sa do práce s vašimi doménami, DNS, SSL a hostingom. Všetko, čo stojí peniaze, čaká na váš súhlas.

Nastavte dna v Claude Code

Nastav mi CLI dna (https://github.com/domainreseller/cli).
1. Nainštaluj ho oficiálnym inštalačným skriptom pre môj operačný systém a potom spusti `dna version` a `dna doctor`.
2. Nainštaluj skill pre Claude Code príkazom `dna agent skill --install` a pridaj MCP server príkazom `claude mcp add dna -- dna mcp serve --env ote`.
3. Nežiadaj ma o vloženie API kľúča do tohto chatu. Povedz mi, že `dna auth login --env ote` mám spustiť ja, a potom over pripojenie príkazom `dna --ote account get`.
Pracuj len v testovacom prostredí OTE a nikdy nepoužívaj `--yes` bez môjho súhlasu.

Skopírujte prompt, vložte ho do svojho AI asistenta a nechajte prácu na ňom. Každý prompt začína v testovacom prostredí OTE a pred čímkoľvek spoplatneným sa zastaví a počká na váš súhlas.

  • 64operácií API
  • 65nástrojov MCP
  • 4bezpečnostné triedy
  • 6platforiem, jeden súbor
  • Apache-2.0open source licencia
Obyčajnými slovami

Hotové prompty pre Claude a ChatGPT

Zmeňte názvy domén, vložte prompt do asistenta a sledujte, ako pracuje. Každý prompt určuje, kde sa má zastaviť, takže bez vás sa nič spoplatnené nestane.

Nájdite a zaregistrujte doménu

Pomocou dna over, či sú brandname.com, brandname.net a brandname.io voľné. Výsledky s cenami zobraz v tabuľke a potom s `--dry-run` urob náhľad registrácie najlacnejšej voľnej domény. Nič neregistruj, kým nepoviem áno.
domain bulk-search · domain registerbillable

Nadchádzajúce obnovy

Pomocou dna vypíš moje domény, ktorým v najbližších 60 dňoch vyprší platnosť, s cenami obnovy a zoradené podľa dátumu vypršania platnosti. Nič neobnovuj.
domain list · domain renew-checkread

Nasmerujte doménu na server

Pomocou dna nasmeruj example.com na 203.0.113.10: pridaj A záznamy pre `@` a `www` a potom mi ukáž výslednú DNS zónu. Pred zmenou alebo zmazaním akéhokoľvek existujúceho záznamu sa ma opýtaj.
dns add · dns listwrite

Preveďte doménu na svoj účet

Pomocou dna over, či sa dá example.org previesť na môj účet, povedz mi, čo ešte potrebujem (auth kód, odomknutie), a s `--dry-run` urob náhľad prevodu.
domain transfer-check · domain transferbillable

Objednajte SSL certifikát

Pomocou dna nájdi najlacnejší DV SSL certifikát pre example.com, vygeneruj CSR a ukáž náhľad objednávky. Pred nákupom počkaj na môj súhlas.
product ssls · ssl generate-csr · ssl initializebillable

Povedzte, čo potrebujete. Správny príkaz nájde agent.

Každá operácia API je nástroj s jasným popisom a JSON schémou, takže asistent vyberie správne volanie a hneď na prvý raz ho správne vyplní. Vy hovoríte, dna urobí presne tú prácu.

Bezpečnostná brána

Váš agent bez vás neminie ani cent

Každý príkaz má bezpečnostnú triedu a tá rozhoduje, čo sa stane. Prezeranie a bezplatné, vratné zmeny sa spustia hneď. Všetko, čo sa platí z vášho zostatku alebo sa nedá vrátiť, sa zastaví a najprv sa opýta.

  • read

    Čítanie

    Vyhľadávanie, zoznamy, informácie o doméne, ceny a pravidlá koncoviek.

    Spustí sa hneď
  • write

    Zápis

    DNS záznamy, zámok prevodu, ochrana WHOIS a kontakty. Bezplatné a vratné.

    Spustí sa hneď
  • destructive

    Deštruktívne

    Zmazanie záznamu, odvolanie SSL, vypnutie DNSSEC.

    Čaká na váš súhlas
  • billable

    Spoplatnené

    Registrácia, obnova, prevod, obnovenie zmazanej domény, objednávky SSL a hostingu.

    Čaká na váš súhlas

Ako funguje súhlas

Chránené nástroje majú navyše pole confirm. Väčšina MCP klientov sa vás aj tak pred každým volaním nástroja opýta; bezpečnostné anotácie im pomáhajú označiť tie rizikové.

  1. Agent sa najprv pýta

    Zavolá nástroj bez confirm. Nič sa neodošle. Späť dostane náhľad presnej požiadavky.

  2. Rozhodnete vy

    Agent vám ukáže doménu, obdobie a operáciu. Poviete áno, alebo nie.

  3. Spustí sa raz

    Volanie zopakuje s confirm=true až po vašom súhlase. Spoplatnené volanie sa po chybe siete nikdy neodošle znova.

Určte, kam až môže siahnuť

--env ote
Testovacie prostredie: skutočné API, žiadne skutočné peniaze
--read-only
Pozerať áno, dotýkať sa nie. Každá zmena je zablokovaná.
--no-billable
Všetko okrem nákupov
--groups domain,dns
Len skupiny príkazov, ktoré uvediete
--dry-run
Vypíše presnú HTTP požiadavku s maskovaným API kľúčom
Začíname

Od promptu k prvej doméne v štyroch krokoch, celé v testovacom prostredí

OTE je naše testovacie prostredie: rovnaké API s vlastným API kľúčom a vlastným zostatkom. Vyskúšajte si všetko tam a potom jedným prepínačom prejdite do produkcie.

  1. Skopírujte prompt

    Hore na tejto stránke vyberte Claude Code, ChatGPT Codex alebo obyčajný chat a prompt skopírujte.

  2. Vložte ho do asistenta

    Asistent nainštaluje dna, pridá MCP server a príkazom dna doctor skontroluje nastavenie.

    dna doctor
  3. Do OTE sa prihláste sami

    Príkaz na prihlásenie spustite vo vlastnom termináli a Reseller ID aj API kľúč pre OTE zadajte tam, nikdy nie do chatu.

    dna auth login --env ote
  4. Požiadajte obyčajnými slovami

    Vyhľadajte, urobte náhľad s --dry-run, zaregistrujte. Všetko, čo sa platí z testovacieho zostatku, čaká na váš súhlas.

    --dry-run
Ručné nastavenie

Uprednostňujete terminál? Dva príkazy a ste pripojení

Nainštalujte binárny súbor a potom pridajte dna mcp serve do svojho MCP klienta. Každá operácia API sa stane nástrojom pre Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI alebo Gemini CLI.

$ curl -fsSL https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.sh | sh

Jeden binárny súbor bez závislostí. Každé vydanie má kontrolné súčty SHA-256.

  • Jeden nástroj na každú operáciu API, každý s JSON schémou zostavenou zo špecifikácie API
  • dna_context modelu povie, či je v produkčnom, alebo testovacom prostredí, ešte predtým, než sa niečoho dotkne
  • Sprístupnite len to, čo potrebujete, pomocou --groups alebo --read-only. Kratší zoznam nástrojov navyše šetrí tokeny kontextu.
  • Agenti, ktorí majú len shell, dostanú jedným volaním skill pre Claude Code aj návod na použitie
# najprv sa pripojte k testovaciemu prostrediu
$ claude mcp add dna -- dna mcp serve --env ote

# iba na čítanie, zdieľané s tímom cez .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

Spustite dna mcp config a vypíše sa hotový úryvok konfigurácie pre každého klienta.

Pokrytie

Všetkých 64 operácií API, zoskupených tak, ako uvažujete

Čo dokáže API pre predajcov, dokáže aj dna. --help každého príkazu ukazuje jeho bezpečnostnú triedu, cestu v API a príklady.

  • dna domain

    Jednotlivé aj hromadné vyhľadávanie, registrácia, obnova, prevod a obnovenie zmazaných domén. Zámok prevodu, ochrana WHOIS, auth kód, menné servery, child hosty a presmerovanie.

  • dna dns · dna dnssec

    Záznamy zóny na menných serveroch platformy a DS záznamy v registri.

  • dna ssl

    Vygenerovanie CSR, nákup, konfigurácia, kontrola stavu, stiahnutie, opätovné vydanie a odvolanie certifikátov.

  • dna hosting

    Hostingové plány a balíky, nové objednávky a ich stav.

  • dna contact

    Opakovane použiteľné kontakty a ich overenie e-mailom a telefónom.

  • dna account · product · order

    Zostatok a transakcie, katalóg koncoviek s cenami a stav objednávok.

  • dna api

    Autentifikovaná surová požiadavka na ľubovoľný endpoint s rovnakými bezpečnostnými pravidlami.

  • dna schema · enums · agent

    Strojovo čitateľné popisy každej operácie, vstupu a kódovanej hodnoty pre agentov a tvorcov nástrojov.

Pozrite si kompletnú referenciu príkazov

Skripty a CI

Vytvorené pre rúry, cron úlohy a CI

V termináli dostanete prehľadné tabuľky, v rúre JSON. Aj chyby sú v JSON, s návratovými kódmi, ktoré nikdy nemenia význam, takže skript vždy vie, čo sa pokazilo.

  • JSON pri presmerovaní do rúry, JSON Lines pre prúdy a vstavaný --jq na skrátenie výstupu
  • Prístupové údaje v CI z DNA_RESELLER_ID a DNA_API_KEY, na vlastnom počítači z profilu
  • Mimo terminálu žiadne skryté otázky: chránený príkaz skončí s kódom 9 a nič neodošle
  • Vstupy sa skontrolujú ešte pred odoslaním a pri prekročení limitu požiadaviek sa volanie zopakuje automaticky
# domény, ktorým vyprší platnosť v najbližších 30 dňoch, ako CSV
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# skontrolujte veľa názvov naraz
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# v skripte sa nákup bez --yes zastaví tu
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
Návratové kódy
0úspech6limit požiadaviek
2neplatný vstup, nič neodoslané7chyba servera
3autentifikácia8sieť
4nenájdené9vyžaduje sa potvrdenie
5zamietnuté API10režim iba na čítanie
Výber nástroja

CLI, SDK, REST API, alebo hotový modul?

Všetky komunikujú s rovnakým API pre predajcov a s rovnakými prístupovými údajmi. Vyberte to, čo sa hodí k miestu, kde práca prebieha.

Časté otázky

Na čo sa ľudia pýtajú pred pripojením agenta

Krátke a priame odpovede. Všetky podrobnosti nájdete v README na GitHube.

Prečítajte si celú dokumentáciu
Čo je Domain Name API CLI?

dna je oficiálny klient príkazového riadka a MCP server platformy Domain Name API pre predajcov. Pokrýva všetkých 64 operácií REST API pre predajcov, od vyhľadávania, registrácie, obnovy a prevodu domén až po DNS, DNSSEC, kontakty, SSL a hosting, v jedinom open source binárnom súbore pre macOS, Linux a Windows pod licenciou Apache-2.0.

Je bezpečné nechať AI agenta registrovať domény?

Áno, pretože agent si sám nič kúpiť nemôže. Spoplatnené a deštruktívne operácie namiesto spustenia vrátia náhľad. Spustia sa až po vašom schválení a keď volanie obsahuje confirm=true, v CLI --yes. Agentov spúšťajte najprv v testovacom prostredí OTE a ďalej ich obmedzte pomocou --read-only alebo --no-billable.

Môžem si to vyskúšať bez míňania peňazí?

Áno. S --env ote komunikuje dna s OTE, naším testovacím prostredím. Má vlastný API kľúč a vlastný zostatok a nič, čo tam urobíte, sa nedotkne ostrých domén ani vášho skutočného účtu.

S akými AI asistentmi dna funguje?

S každým MCP klientom: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI a ďalšími. Agenti, ktorí majú len shell, môžu volať CLI priamo; dna agent guide a skill pre Claude Code ich naučia ako.

Potrebujem účet v Domain Name API?

Áno. dna funguje s účtom predajcu a jeho prístupovými údajmi k API: vaším Reseller ID a API kľúčom, oboje nájdete v paneli predajcu v časti Nastavenia API. Produkčné prostredie a OTE majú rôzne kľúče a váš e-mail a heslo do panela tu nefungujú.

Je dna zadarmo?

Áno. Nástroj je bezplatný a open source pod licenciou Apache-2.0. Platíte len za to, čo cez neho kúpite, napríklad domény, obnovy, SSL a hosting, za svoje ceny predajcu a zo zostatku na účte.

Kde sú uložené moje prístupové údaje?

dna auth login ich uloží do súboru profilu vo vašom používateľskom priečinku s konfiguráciou; v systémoch Linux a macOS ho môžete čítať len vy a dna config path ukáže, kde je. Premenné prostredia majú vždy prednosť a API kľúč je maskovaný v každom výstupe vrátane --dry-run.

Môžem dna používať v skriptoch a CI?

Áno. Pri presmerovaní do rúry je výstup v JSON, chyby sú v JSON so stabilnými návratovými kódmi a mimo interaktívneho terminálu sa nič nepýta. Prístupové údaje zadajte ako DNA_RESELLER_ID a DNA_API_KEY. Spoplatnený príkaz bez --yes skončí s kódom 9 a nič neodošle.

Mám použiť CLI, alebo SDK?

dna použite, keď prácu robí človek, skript alebo AI agent. Keď zabudovávate doménové funkcie do vlastnej aplikácie, použite SDK pre PHP, Node.js, Python, Ruby alebo Go, prípadne priamo REST API. Všetky používajú rovnaké API a rovnaké prístupové údaje.

Musím používať terminál?

Nie. Vložte hotový prompt do Claude Code, ktorý beží aj v desktopovej aplikácii Claude, alebo do ChatGPT Codex a asistent za vás dna nainštaluje a pripojí. Jediný príkaz, ktorý napíšete sami, je dna auth login, takže váš API kľúč sa nikdy nedostane do chatu. Ak terminál vôbec nemáte, prompt pre chat vás prevedie každým krokom.