Nuovo · v1.0 · open source

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.

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
Con parole tue

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 registerbillable

Prossimi 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-checkread

Fai 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 listwrite

Trasferisci 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 transferbillable

Ordina 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 initializebillable

Di' 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.

Controllo di sicurezza

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.

  1. L'agente chiede prima

    Chiama lo strumento senza confirm. Non viene inviato nulla. Riceve un'anteprima della richiesta esatta.

  2. Decidi tu

    L'agente ti mostra il dominio, la durata e l'operazione. Tu dici sì o no.

  3. 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
Per iniziare

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.

  1. Copia un prompt

    Scegli Claude Code, ChatGPT Codex o la semplice chat in cima a questa pagina e copia il prompt.

  2. Incollalo nel tuo assistente

    L'assistente installa dna, aggiunge il server MCP ed esegue dna doctor per verificare la configurazione.

    dna doctor
  3. Accedi 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 ote
  4. Chiedi 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
Configurazione manuale

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 | sh

Un 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

Esegui dna mcp config per stampare uno snippet pronto per ogni client.

Copertura

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.

Vedi il riferimento completo dei comandi

Script e CI

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
Codici di uscita
0successo6limite di richieste
2input non valido, nulla inviato7errore del server
3autenticazione8rete
4non trovato9conferma richiesta
5rifiutato dall'API10modalità sola lettura
Scegliere lo strumento

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.

Domande frequenti

Cosa ci chiedono prima di collegare un agente

Risposte brevi e dirette. Il README su GitHub copre ogni dettaglio.

Leggi la documentazione completa
Che 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.