La CLI per domini e il server MCP pensati per gli agenti AI
dna è lo strumento da riga di comando e il server MCP ufficiale di Domain Name API. Copia un prompt pronto in Claude o ChatGPT: il tuo assistente lo installa, lo collega e si mette al lavoro su domini, DNS, SSL e hosting. Tutto ciò che costa denaro aspetta il tuo sì.
Configura dna in Claude Code
Configurami la CLI dna (https://github.com/domainreseller/cli). 1. Installala con lo script di installazione ufficiale per il mio sistema operativo, poi esegui `dna version` e `dna doctor`. 2. Installa la skill di Claude Code con `dna agent skill --install` e aggiungi il server MCP con `claude mcp add dna -- dna mcp serve --env ote`. 3. Non chiedermi di incollare la mia chiave API in questa chat. Dimmi di eseguire personalmente `dna auth login --env ote`, poi verifica la connessione con `dna --ote account get`. Lavora solo nell'ambiente di test OTE e non usare mai `--yes` senza la mia approvazione.
Configura dna in ChatGPT Codex
Configurami la CLI dna (https://github.com/domainreseller/cli). 1. Installala con lo script di installazione ufficiale per il mio sistema operativo, poi esegui `dna version` e `dna doctor`. 2. Aggiungila alla mia configurazione di Codex (`~/.codex/config.toml`) come server MCP chiamato `dna`, con il comando `dna` e gli argomenti `mcp serve --env ote`. 3. Non chiedermi di incollare la mia chiave API in questa chat. Dimmi di eseguire personalmente `dna auth login --env ote`, poi verifica la connessione con `dna --ote account get`. Lavora solo nell'ambiente di test OTE e non usare mai `--yes` senza la mia approvazione.
Niente terminale? Chiedi a ChatGPT o a Claude in chat
Leggi https://raw.githubusercontent.com/domainreseller/cli/main/llms.txt e la documentazione di dna a cui rimanda. Poi dammi i comandi dna esatti, passo dopo passo, per registrare un dominio nell'ambiente di test OTE: installazione, accesso, ricerca, anteprima con `--dry-run` e registrazione. Spiega cosa fa ogni comando.
Copia un prompt, incollalo nel tuo assistente IA e lascia che faccia il lavoro. Ogni prompt inizia nell'ambiente di test OTE e si ferma in attesa della tua approvazione prima di qualsiasi operazione a pagamento.
- 64operazioni API
- 65strumenti MCP
- 4classi di sicurezza
- 6piattaforme, un solo binario
- Apache-2.0licenza open source
Prompt pronti all'uso per Claude e ChatGPT
Cambia i nomi di dominio, incolla un prompt nel tuo assistente e guardalo lavorare. Ogni prompt indica dove fermarsi, così nulla a pagamento parte senza di te.
Trova e registra un dominio
Con dna, controlla se brandname.com, brandname.net e brandname.io sono disponibili. Mostra i risultati con i prezzi in una tabella, poi fai l'anteprima della registrazione del più economico tra quelli disponibili con `--dry-run`. Non registrare nulla finché non ti dico di sì.
domain bulk-search · domain registerbillableProssimi rinnovi
Con dna, elenca i miei domini che scadono nei prossimi 60 giorni con i prezzi di rinnovo, ordinati per data di scadenza. Non rinnovare nulla.
domain list · domain renew-checkreadFai puntare un dominio a un server
Con dna, fai puntare example.com a 203.0.113.10: aggiungi record A per `@` e `www`, poi mostrami la zona DNS finale. Chiedimi prima di modificare o eliminare qualsiasi record esistente.
dns add · dns listwriteTrasferisci un dominio sul tuo account
Con dna, controlla se example.org può essere trasferito sul mio account, dimmi cosa mi serve ancora (codice di autorizzazione, sblocco) e fai l'anteprima del trasferimento con `--dry-run`.
domain transfer-check · domain transferbillableOrdina un certificato SSL
Con dna, trova il certificato DV SSL più economico per example.com, crea una CSR e fai l'anteprima dell'ordine. Aspetta la mia approvazione prima di acquistare.
product ssls · ssl generate-csr · ssl initializebillableDi' cosa ti serve. Il comando giusto lo trova il tuo agente.
Ogni operazione dell'API è uno strumento con una descrizione chiara e uno schema JSON, così gli assistenti scelgono la chiamata giusta e la compilano correttamente al primo colpo. Tu parli, dna esegue con precisione.
Il tuo agente non può spendere un centesimo senza di te
Ogni comando ha una classe di sicurezza, ed è la classe a decidere cosa succede. Le consultazioni e le modifiche gratuite e reversibili partono subito. Tutto ciò che viene addebitato sul tuo saldo o non si può annullare si ferma e prima ti chiede conferma.
- read
Lettura
Ricerca, elenchi, informazioni sui domini, prezzi e regole delle estensioni.
Parte subito - write
Scrittura
Record DNS, blocco di trasferimento, privacy WHOIS e contatti. Gratuiti e reversibili.
Parte subito - destructive
Distruttivo
Eliminare un record, revocare un certificato SSL, disattivare DNSSEC.
Aspetta il tuo sì - billable
A pagamento
Registrazione, rinnovo, trasferimento, ripristino, ordini SSL e hosting.
Aspetta il tuo sì
Come funziona la conferma
Gli strumenti protetti accettano un campo confirm in più. La maggior parte dei client MCP ti chiede anche conferma prima di ogni chiamata a uno strumento; le annotazioni di sicurezza li aiutano a segnalare quelle rischiose.
L'agente chiede prima
Chiama lo strumento senza confirm. Non viene inviato nulla. Riceve un'anteprima della richiesta esatta.
Decidi tu
L'agente ti mostra il dominio, la durata e l'operazione. Tu dici sì o no.
Parte una volta sola
Solo dopo il tuo sì ripete la chiamata con confirm=true. Una chiamata a pagamento non viene mai reinviata dopo un errore di rete.
Decidi fin dove può arrivare
--env ote- Ambiente di test: la vera API, niente soldi veri
--read-only- Guardare senza toccare. Ogni modifica è bloccata.
--no-billable- Tutto tranne gli acquisti
--groups domain,dns- Solo i gruppi di comandi che indichi
--dry-run- Stampa la richiesta HTTP esatta con la chiave API mascherata
Dal prompt al primo dominio in quattro passi, tutto nell'ambiente di test
OTE è il nostro ambiente di test: la stessa API, con una sua chiave API e un suo saldo. Fai pratica lì, poi passa in produzione con un solo flag.
Copia un prompt
Scegli Claude Code, ChatGPT Codex o la semplice chat in cima a questa pagina e copia il prompt.
Incollalo nel tuo assistente
L'assistente installa dna, aggiunge il server MCP ed esegue dna doctor per verificare la configurazione.
dna doctorAccedi a OTE personalmente
Esegui il comando di accesso nel tuo terminale e inserisci lì il tuo Reseller ID e la chiave API OTE, mai nella chat.
dna auth login --env oteChiedi con parole tue
Cerca, fai l'anteprima con --dry-run, registra. Tutto ciò che viene addebitato sul saldo di test aspetta il tuo sì.
--dry-run
Preferisci il terminale? Bastano due comandi per collegarti
Installa il binario, poi aggiungi dna mcp serve al tuo client MCP. Ogni operazione dell'API diventa uno strumento per Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI o Gemini CLI.
$ curl -fsSL https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.sh | shPS> irm https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.ps1 | iex$ go install github.com/domainreseller/cli/cmd/dna@latestUn unico binario, senza dipendenze. Ogni release include i checksum SHA-256.
- Uno strumento per ogni operazione dell'API, ciascuno con uno schema JSON generato dalla specifica dell'API
- dna_context dice al modello se è in produzione o nell'ambiente di test prima che tocchi qualsiasi cosa
- Esponi solo ciò che ti serve con --groups o --read-only. Un elenco di strumenti più corto fa risparmiare anche token di contesto.
- Gli agenti che hanno solo una shell ricevono una skill di Claude Code e una guida all'uso con una sola chiamata
# collegati prima all'ambiente di test
$ claude mcp add dna -- dna mcp serve --env ote
# sola lettura, condiviso con il tuo team tramite .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only {
"mcpServers": {
"dna": {
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} {
"servers": {
"dna": {
"type": "stdio",
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} [mcp_servers.dna]
command = "dna"
args = ["mcp", "serve", "--env", "ote"] # skill di Claude Code: ~/.claude/skills/dna/SKILL.md
$ dna agent skill --install
# una guida compatta per le istruzioni di qualsiasi agente
$ dna agent guide Esegui dna mcp config per stampare uno snippet pronto per ogni client.
Tutte le 64 operazioni dell'API, raggruppate come le pensi tu
Se l'API reseller può farlo, può farlo anche dna. Il --help di ogni comando mostra la sua classe di sicurezza, la route dell'API ed esempi.
dna domain
Ricerca singola e multipla, registrazione, rinnovo, trasferimento e ripristino. Blocco di trasferimento, privacy WHOIS, codice di trasferimento (auth), nameserver, host figli e reindirizzamento.
dna dns · dna dnssec
Record di zona sui nameserver della piattaforma e record DS presso il registry.
dna ssl
Genera un CSR, acquista, configura, controlla lo stato, scarica, riemetti e revoca certificati.
dna hosting
Piani e pacchetti di hosting, nuovi ordini e relativo stato.
dna contact
Contatti riutilizzabili e verifica della loro email e del loro telefono.
dna account · product · order
Saldo e movimenti, catalogo delle estensioni con i prezzi e stato degli ordini.
dna api
Una richiesta grezza e autenticata a qualsiasi endpoint, con le stesse regole di sicurezza.
dna schema · enums · agent
Descrizioni leggibili dalle macchine di ogni operazione, input e valore codificato, per gli agenti e per chi sviluppa strumenti.
Pensato per pipe, cron job e pipeline
In un terminale ottieni tabelle leggibili. In una pipe ottieni JSON. Anche gli errori sono JSON, con codici di uscita che non cambiano mai significato, così uno script sa sempre cosa è andato storto.
- JSON quando l'output va in pipe, JSON Lines per gli stream e un --jq integrato per tenere l'output snello
- Credenziali da DNA_RESELLER_ID e DNA_API_KEY in CI, da un profilo sulla tua macchina
- Nessuna domanda nascosta fuori da un terminale: un comando protetto esce con codice 9 e non invia nulla
- Gli input vengono controllati prima di inviare qualsiasi cosa, e quando scatta un rate limit i tentativi vengono ripetuti per te
# domini in scadenza nei prossimi 30 giorni, in CSV
$ dna domain list --all \
--jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'
# controlla molti nomi in una volta
$ dna domain bulk-search brand.com brand.net brand.io \
--jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'
# in uno script, un acquisto senza --yes si ferma qui
$ dna domain renew example.com --period 1
exit 9 confirmation required · nothing sent | 0 | successo | 6 | limite di richieste |
|---|---|---|---|
| 2 | input non valido, nulla inviato | 7 | errore del server |
| 3 | autenticazione | 8 | rete |
| 4 | non trovato | 9 | conferma richiesta |
| 5 | rifiutato dall'API | 10 | modalità sola lettura |
CLI, SDK, REST API o un modulo pronto?
Parlano tutti con la stessa API reseller, con le stesse credenziali. Scegli quello che si adatta a dove si svolge il lavoro.
CLI e server MCP
Quando il lavoro lo fa una persona, uno script o un agente AI: operazioni quotidiane, automazione, CI e assistenti come Claude o Cursor.
SDK
Quando integri funzioni per i domini nella tua applicazione. PHP, Node.js, Python, Ruby e Go.
Scopri gli SDKREST API
Quando vuoi il pieno controllo su ogni richiesta, in qualsiasi linguaggio. JSON su HTTPS con due header.
Leggi la guida all'APIModuli di fatturazione
Quando vendi tramite WHMCS, Blesta, HostBill, WiseCP o Clientexec e vuoi che tutto vada avanti da solo.
Scopri le integrazioniCosa ci chiedono prima di collegare un agente
Risposte brevi e dirette. Il README su GitHub copre ogni dettaglio.
Leggi la documentazione completaChe cos'è la CLI di Domain Name API?
dna è il client da riga di comando e server MCP ufficiale della piattaforma per rivenditori di Domain Name API. Copre tutte le 64 operazioni della REST API reseller, dalla ricerca, registrazione, rinnovo e trasferimento dei domini fino a DNS, DNSSEC, contatti, SSL e hosting, in un unico binario open source per macOS, Linux e Windows con licenza Apache-2.0.
È sicuro lasciare che un agente AI registri domini?
Sì, perché l'agente non può acquistare nulla da solo. Le operazioni a pagamento e distruttive restituiscono un'anteprima invece di essere eseguite. Partono solo dopo la tua approvazione, quando la chiamata contiene confirm=true, o --yes nella CLI. Fai partire gli agenti nell'ambiente di test OTE e limitali ulteriormente con --read-only o --no-billable.
Posso provarlo senza spendere soldi?
Sì. Con --env ote, dna si collega a OTE, il nostro ambiente di test. Ha una sua chiave API e un suo saldo, e niente di ciò che fai lì tocca i domini reali o il tuo account vero.
Quali assistenti AI funzionano con dna?
Qualsiasi client MCP: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI e altri. Gli agenti che hanno solo una shell possono chiamare direttamente la CLI; dna agent guide e la skill di Claude Code insegnano loro come fare.
Mi serve un account Domain Name API?
Sì. dna funziona con un account rivenditore e le sue credenziali API: il tuo Reseller ID e una chiave API, entrambi in Impostazioni API nel pannello reseller. Produzione e OTE hanno chiavi diverse, e l'email e la password del pannello qui non funzionano.
dna è gratuito?
Sì. Lo strumento è gratuito e open source con licenza Apache-2.0. Paghi solo ciò che acquisti tramite dna, come domini, rinnovi, SSL e hosting, ai tuoi prezzi da rivenditore e con il saldo del tuo account.
Dove vengono salvate le mie credenziali?
dna auth login le salva in un file di profilo nella cartella di configurazione del tuo utente, leggibile solo da te su Linux e macOS; dna config path ti mostra dove. Le variabili d'ambiente hanno sempre la precedenza, e la chiave API viene mascherata in ogni output, --dry-run compreso.
Posso usare dna in script e CI?
Sì. L'output è JSON quando va in pipe, gli errori sono JSON con codici di uscita stabili e fuori da un terminale interattivo non c'è nessuna domanda. Passa le credenziali come DNA_RESELLER_ID e DNA_API_KEY. Un comando a pagamento senza --yes esce con codice 9 e non invia nulla.
Meglio la CLI o un SDK?
Usa dna quando il lavoro lo fa una persona, uno script o un agente AI. Usa un SDK per PHP, Node.js, Python, Ruby o Go, oppure direttamente la REST API, quando integri funzioni per i domini nella tua applicazione. Tutti usano la stessa API e le stesse credenziali.
Devo per forza usare il terminale?
No. Incolla un prompt pronto in Claude Code, che funziona anche nell'app desktop di Claude, o in ChatGPT Codex, e l'assistente installa e collega dna per te. L'unico comando che digiti tu è dna auth login, così la tua chiave API non finisce mai nella chat. Se non hai alcun terminale, il prompt per la chat ti guida passo dopo passo.

