Nou · v1.0 · open source

CLI-ul pentru domenii și serverul MCP gândite pentru agenții AI

dna este instrumentul oficial de linie de comandă și serverul MCP al Domain Name API. Copiază un prompt gata făcut în Claude sau ChatGPT, iar asistentul tău îl instalează, îl conectează și se apucă de lucru pe domeniile tale, DNS, SSL și hosting. Tot ce costă bani așteaptă acordul tău.

Configurează dna în Claude Code

Configurează-mi CLI-ul dna (https://github.com/domainreseller/cli).
1. Instalează-l cu scriptul oficial de instalare pentru sistemul meu de operare, apoi rulează `dna version` și `dna doctor`.
2. Instalează skill-ul Claude Code cu `dna agent skill --install` și adaugă serverul MCP cu `claude mcp add dna -- dna mcp serve --env ote`.
3. Nu-mi cere să lipesc cheia API în acest chat. Spune-mi să rulez eu `dna auth login --env ote`, apoi verifică conexiunea cu `dna --ote account get`.
Lucrează doar în mediul de testare OTE și nu folosi niciodată `--yes` fără acordul meu.

Copiază un prompt, lipește-l în asistentul tău AI și lasă-l să facă treaba. Fiecare prompt pornește în mediul de testare OTE și se oprește să aștepte acordul tău înainte de orice operațiune cu plată.

  • 64operațiuni API
  • 65instrumente MCP
  • 4clase de siguranță
  • 6platforme, un singur binar
  • Apache-2.0licență open source
Cu vorbele tale

Prompturi gata făcute pentru Claude și ChatGPT

Schimbă numele de domeniu, lipește un prompt în asistentul tău și urmărește-l cum lucrează. Fiecare prompt spune unde să se oprească, așa că nimic cu plată nu se întâmplă fără tine.

Găsește și înregistrează un domeniu

Cu dna, verifică dacă brandname.com, brandname.net și brandname.io sunt disponibile. Arată-mi rezultatele cu prețuri într-un tabel, apoi previzualizează cu `--dry-run` înregistrarea celui mai ieftin dintre cele disponibile. Nu înregistra nimic până nu spun da.
domain bulk-search · domain registerbillable

Reînnoiri care se apropie

Cu dna, listează-mi domeniile care expiră în următoarele 60 de zile, cu prețurile de reînnoire, sortate după data expirării. Nu reînnoi nimic.
domain list · domain renew-checkread

Direcționează un domeniu către un server

Cu dna, direcționează example.com către 203.0.113.10: adaugă înregistrări A pentru `@` și `www`, apoi arată-mi zona DNS finală. Întreabă-mă înainte să modifici sau să ștergi orice înregistrare existentă.
dns add · dns listwrite

Transferă un domeniu în contul tău

Cu dna, verifică dacă example.org poate fi transferat în contul meu, spune-mi ce îmi mai trebuie (cod de transfer, deblocare) și previzualizează transferul cu `--dry-run`.
domain transfer-check · domain transferbillable

Comandă un certificat SSL

Cu dna, găsește cel mai ieftin certificat SSL DV pentru example.com, creează un CSR și previzualizează comanda. Așteaptă acordul meu înainte să cumperi.
product ssls · ssl generate-csr · ssl initializebillable

Spune de ce ai nevoie. Agentul tău găsește comanda potrivită.

Fiecare operațiune API este un instrument cu o descriere clară și o schemă JSON, așa că asistenții aleg apelul potrivit și îl completează corect din prima. Tu vorbești, dna face exact ce trebuie.

Barieră de siguranță

Agentul tău nu poate cheltui niciun ban fără tine

Fiecare comandă are o clasă de siguranță, iar clasa decide ce se întâmplă. Consultarea și modificările gratuite și reversibile rulează imediat. Tot ce se plătește din soldul tău sau nu poate fi anulat se oprește și te întreabă mai întâi.

  • read

    Citire

    Căutare, listări, informații despre domenii, prețuri și reguli pentru extensii.

    Rulează imediat
  • write

    Scriere

    Înregistrări DNS, blocare de transfer, protecție WHOIS și contacte. Gratuit și reversibil.

    Rulează imediat
  • destructive

    Distructiv

    Ștergerea unei înregistrări, revocarea unui certificat SSL, dezactivarea DNSSEC.

    Așteaptă acordul tău
  • billable

    Cu plată

    Înregistrare, reînnoire, transfer, restaurare, comenzi SSL și hosting.

    Așteaptă acordul tău

Cum funcționează confirmarea

Instrumentele protejate primesc un câmp confirm în plus. Majoritatea clienților MCP te întreabă și ei înainte de fiecare apel de instrument; adnotările de siguranță îi ajută să le semnaleze pe cele riscante.

  1. Agentul întreabă mai întâi

    Apelează instrumentul fără confirm. Nu se trimite nimic. Primește înapoi o previzualizare a cererii exacte.

  2. Tu decizi

    Agentul îți arată domeniul, perioada și operațiunea. Tu spui da sau nu.

  3. Rulează o singură dată

    Abia după ce spui da repetă apelul cu confirm=true. Un apel cu plată nu este retrimis niciodată după o eroare de rețea.

Decide cât de departe poate ajunge

--env ote
Mediu de testare: API-ul real, fără bani reali
--read-only
Se uită, dar nu atinge. Orice modificare e blocată.
--no-billable
Totul, în afară de achiziții
--groups domain,dns
Doar grupurile de comenzi pe care le enumeri
--dry-run
Afișează cererea HTTP exactă, cu cheia API mascată
Primii pași

De la prompt la primul domeniu în patru pași, totul în mediul de testare

OTE este mediul nostru de testare: același API, cu cheie API și sold proprii. Exersează acolo, apoi treci în producție cu un singur flag.

  1. Copiază un prompt

    În partea de sus a paginii, alege Claude Code, ChatGPT Codex sau un chat obișnuit și copiază promptul.

  2. Lipește-l în asistentul tău

    Asistentul instalează dna, adaugă serverul MCP și rulează dna doctor ca să verifice configurarea.

    dna doctor
  3. Autentifică-te tu în OTE

    Rulează comanda de autentificare în propriul terminal și introdu acolo ID-ul tău de revânzător și cheia API OTE, niciodată în chat.

    dna auth login --env ote
  4. Cere cu vorbele tale

    Caută, previzualizează cu --dry-run, înregistrează. Tot ce se plătește din soldul de test așteaptă acordul tău.

    --dry-run
Configurare manuală

Preferi terminalul? Te conectezi din două comenzi

Instalează binarul, apoi adaugă dna mcp serve în clientul tău MCP. Fiecare operațiune API devine un instrument pentru Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI sau Gemini CLI.

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

Un singur binar, fără dependențe. Fiecare versiune vine cu sume de control SHA-256.

  • Câte un instrument pentru fiecare operațiune API, fiecare cu o schemă JSON generată din specificația API
  • dna_context îi spune modelului dacă e în producție sau în mediul de testare înainte să atingă ceva
  • Expune doar ce îți trebuie cu --groups sau --read-only. O listă mai scurtă de instrumente economisește și tokeni de context.
  • Agenții care au doar un shell primesc un skill Claude Code și un ghid de utilizare dintr-un singur apel
# conectează-te mai întâi la mediul de testare
$ claude mcp add dna -- dna mcp serve --env ote

# doar citire, partajat cu echipa prin .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

Rulează dna mcp config ca să afișezi un fragment gata făcut pentru fiecare client.

Acoperire

Toate cele 64 de operațiuni API, grupate așa cum gândești

Dacă API-ul de revânzare poate face ceva, poate și dna. La fiecare comandă, --help arată clasa de siguranță, ruta API și exemple.

  • dna domain

    Căutare simplă și în bloc, înregistrare, reînnoire, transfer și restaurare. Blocare de transfer, protecție WHOIS, cod de transfer (auth), nameservere, hosturi copil și redirecționare.

  • dna dns · dna dnssec

    Înregistrări de zonă pe nameserverele platformei și înregistrări DS la registry.

  • dna ssl

    Generează un CSR, cumpără, configurează, verifică starea, descarcă, reemite și revocă certificate.

  • dna hosting

    Planuri și pachete de hosting, comenzi noi și starea lor.

  • dna contact

    Contacte reutilizabile și verificarea e-mailului și a telefonului lor.

  • dna account · product · order

    Sold și tranzacții, catalogul extensiilor cu prețuri și starea comenzilor.

  • dna api

    O cerere brută, autentificată, către orice endpoint, cu aceleași reguli de siguranță.

  • dna schema · enums · agent

    Descrieri citibile de mașină pentru fiecare operațiune, intrare și valoare codificată, pentru agenți și creatori de instrumente.

Vezi referința completă a comenzilor

Scripturi și CI

Făcut pentru pipe-uri, joburi cron și pipeline-uri

În terminal primești tabele ușor de citit. Într-un pipe primești JSON. Și erorile sunt JSON, cu coduri de ieșire care nu își schimbă niciodată sensul, așa că un script știe mereu ce a mers prost.

  • JSON când ieșirea merge într-un pipe, JSON Lines pentru fluxuri și un --jq integrat care păstrează ieșirea scurtă
  • Date de acces din DNA_RESELLER_ID și DNA_API_KEY în CI, dintr-un profil pe propriul calculator
  • Fără întrebări ascunse în afara unui terminal: o comandă protejată iese cu codul 9 și nu trimite nimic
  • Intrările sunt verificate înainte să se trimită ceva, iar la limitele de rată reîncercările se fac automat
# domenii care expiră în următoarele 30 de zile, în CSV
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# verifică mai multe nume deodată
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# într-un script, o achiziție fără --yes se oprește aici
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
Coduri de ieșire
0succes6limită de rată depășită
2date de intrare invalide, nu s-a trimis nimic7eroare de server
3autentificare8rețea
4negăsit9confirmare necesară
5respins de API10mod doar citire
Alegerea instrumentului

CLI, SDK, REST API sau un modul gata făcut?

Toate vorbesc cu același API de revânzare, cu aceleași date de acces. Alege-l pe cel care se potrivește locului în care se face treaba.

Întrebări frecvente

Ce ne întreabă lumea înainte să conecteze un agent

Răspunsuri scurte și directe. README-ul de pe GitHub acoperă fiecare detaliu.

Citește documentația completă
Ce este CLI-ul Domain Name API?

dna este clientul oficial de linie de comandă și serverul MCP al platformei de revânzare Domain Name API. Acoperă toate cele 64 de operațiuni ale REST API-ului de revânzare, de la căutarea, înregistrarea, reînnoirea și transferul domeniilor până la DNS, DNSSEC, contacte, SSL și hosting, într-un singur binar open source pentru macOS, Linux și Windows, sub licența Apache-2.0.

Este sigur să las un agent AI să înregistreze domenii?

Da, pentru că agentul nu poate cumpăra nimic de unul singur. Operațiunile cu plată și cele distructive returnează o previzualizare în loc să ruleze. Rulează doar după ce aprobi și apelul conține confirm=true, sau --yes în CLI. Pornește agenții în mediul de testare OTE și restrânge-le și mai mult accesul cu --read-only sau --no-billable.

Pot să-l încerc fără să cheltui bani?

Da. Cu --env ote, dna comunică cu OTE, mediul nostru de testare. Are propria cheie API și propriul sold, iar nimic din ce faci acolo nu atinge domeniile live sau contul tău real.

Ce asistenți AI funcționează cu dna?

Orice client MCP: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI și alții. Agenții care au doar un shell pot apela direct CLI-ul; dna agent guide și skill-ul Claude Code îi învață cum.

Am nevoie de un cont Domain Name API?

Da. dna funcționează cu un cont de revânzător și cu datele lui de acces API: ID-ul tău de revânzător și o cheie API, ambele în secțiunea Setări API din panoul de revânzător. Producția și OTE au chei diferite, iar e-mailul și parola de la panou nu funcționează aici.

Este dna gratuit?

Da. Instrumentul este gratuit și open source, sub licența Apache-2.0. Plătești doar ce cumperi prin el, cum ar fi domenii, reînnoiri, SSL și hosting, la prețurile tale de revânzător și din soldul contului.

Unde sunt stocate datele mele de acces?

dna auth login le salvează într-un fișier de profil din folderul de configurare al utilizatorului tău, pe care pe Linux și macOS doar tu îl poți citi; dna config path îți arată unde e. Variabilele de mediu au întotdeauna prioritate, iar cheia API este mascată în orice ieșire, inclusiv la --dry-run.

Pot folosi dna în scripturi și în CI?

Da. Ieșirea este JSON când merge într-un pipe, erorile sunt JSON cu coduri de ieșire stabile și nu apar întrebări în afara unui terminal interactiv. Transmite datele de acces prin DNA_RESELLER_ID și DNA_API_KEY. O comandă cu plată fără --yes iese cu codul 9 și nu trimite nimic.

Ar trebui să folosesc CLI-ul sau un SDK?

Folosește dna când munca o face o persoană, un script sau un agent AI. Folosește un SDK pentru PHP, Node.js, Python, Ruby sau Go, ori direct REST API-ul, când integrezi funcții pentru domenii în propria aplicație. Toate folosesc același API și aceleași date de acces.

Trebuie neapărat să folosesc terminalul?

Nu. Lipește un prompt gata făcut în Claude Code, care rulează și în aplicația desktop Claude, sau în ChatGPT Codex, iar asistentul instalează și conectează dna pentru tine. Singura comandă pe care o tastezi tu este dna auth login, așa că cheia ta API nu ajunge niciodată în chat. Dacă nu ai deloc terminal, promptul pentru chat te ghidează prin fiecare pas.