Nyhed · v1.0 · open source

Domæne-CLI og MCP-server bygget til AI-agenter

dna er Domain Name API's officielle kommandolinjeværktøj og MCP-server. Kopiér en færdig prompt ind i Claude eller ChatGPT, så installerer og forbinder din assistent dna og går i gang med dine domæner, DNS, SSL og hosting. Alt, der koster penge, venter på dit ja.

Sæt dna op i Claude Code

Sæt dna CLI op for mig (https://github.com/domainreseller/cli).
1. Installér den med det officielle installationsscript til mit styresystem, og kør derefter `dna version` og `dna doctor`.
2. Installér skill'et til Claude Code med `dna agent skill --install`, og tilføj MCP-serveren med `claude mcp add dna -- dna mcp serve --env ote`.
3. Bed mig ikke om at indsætte min API-nøgle i denne chat. Sig, at jeg selv skal køre `dna auth login --env ote`, og tjek derefter forbindelsen med `dna --ote account get`.
Arbejd kun i OTE-testmiljøet, og brug aldrig `--yes` uden min godkendelse.

Kopiér en prompt, sæt den ind i din AI-assistent, og lad den klare arbejdet. Hver prompt starter i OTE-testmiljøet og venter på din godkendelse, før noget betalingspligtigt sker.

  • 64API-operationer
  • 65MCP-værktøjer
  • 4sikkerhedsklasser
  • 6platforme, én binær fil
  • Apache-2.0open source-licens
Med almindelige ord

Færdige prompts til Claude og ChatGPT

Skift domænenavnene ud, sæt en prompt ind i din assistent, og se den arbejde. Hver prompt siger, hvor den skal stoppe, så intet betalingspligtigt sker uden dig.

Find og registrer et domæne

Tjek med dna, om brandname.com, brandname.net og brandname.io er ledige. Vis resultaterne med priser i en tabel, og forhåndsvis derefter registreringen af det billigste ledige domæne med `--dry-run`. Registrer ikke noget, før jeg siger ja.
domain bulk-search · domain registerbillable

Kommende fornyelser

Brug dna til at vise mine domæner, der udløber inden for de næste 60 dage, med deres fornyelsespriser og sorteret efter udløbsdato. Forny ikke noget.
domain list · domain renew-checkread

Peg et domæne på en server

Peg example.com på 203.0.113.10 med dna: tilføj A-poster for `@` og `www`, og vis mig derefter den endelige DNS-zone. Spørg mig, før du ændrer eller sletter en eksisterende post.
dns add · dns listwrite

Overfør et domæne til din konto

Tjek med dna, om example.org kan overføres til min konto, fortæl mig, hvad jeg stadig mangler (auth-kode, oplåsning), og forhåndsvis overførslen med `--dry-run`.
domain transfer-check · domain transferbillable

Bestil et SSL-certifikat

Find det billigste DV-SSL-certifikat til example.com med dna, opret en CSR, og forhåndsvis ordren. Vent på min godkendelse, før du køber.
product ssls · ssl generate-csr · ssl initializebillable

Sig, hvad du har brug for. Din agent finder den rigtige kommando.

Hver API-operation er et værktøj med en klar beskrivelse og et JSON-skema, så assistenter vælger det rigtige kald og udfylder det korrekt første gang. Du taler, dna udfører det præcise arbejde.

Sikkerhedsspærre

Din agent kan ikke bruge en krone uden dig

Hver kommando har en sikkerhedsklasse, og klassen afgør, hvad der sker. Opslag og gratis ændringer, der kan fortrydes, kører med det samme. Alt, der trækker på din saldo eller ikke kan fortrydes, stopper og spørger først.

  • read

    Læse

    Søgning, lister, domæneinfo, priser og regler for endelser.

    Kører med det samme
  • write

    Skrive

    DNS-poster, overførselslås, WHOIS-beskyttelse og kontakter. Gratis og kan fortrydes.

    Kører med det samme
  • destructive

    Destruktiv

    Sletning af en post, tilbagekaldelse af SSL, deaktivering af DNSSEC.

    Venter på dit ja
  • billable

    Betalingspligtig

    Registrering, fornyelse, overførsel, gendannelse, SSL- og hostingordrer.

    Venter på dit ja

Sådan virker dit ja

Beskyttede værktøjer har et ekstra confirm-felt. De fleste MCP-klienter spørger dig også før hvert værktøjskald; sikkerhedsannotationerne hjælper dem med at markere de risikable.

  1. Agenten spørger først

    Den kalder værktøjet uden confirm. Intet bliver sendt. Den får en forhåndsvisning af den præcise forespørgsel tilbage.

  2. Du bestemmer

    Agenten viser dig domænet, perioden og handlingen. Du siger ja eller nej.

  3. Det kører én gang

    Først efter dit ja gentager den kaldet med confirm=true. Et betalingspligtigt kald sendes aldrig igen efter en netværksfejl.

Bestem, hvor langt den kan nå

--env ote
Testmiljø: det rigtige API, ingen rigtige penge
--read-only
Kig, men rør ikke. Alle ændringer blokeres.
--no-billable
Alt undtagen køb
--groups domain,dns
Kun de kommandogrupper, du angiver
--dry-run
Udskriver den præcise HTTP-forespørgsel med API-nøglen maskeret
Kom i gang

Fra prompt til første domæne i fire trin, helt i testmiljøet

OTE er vores testmiljø: det samme API med sin egen API-nøgle og sin egen saldo. Øv dig der, og skift så til produktion med ét flag.

  1. Kopiér en prompt

    Vælg Claude Code, ChatGPT Codex eller almindelig chat øverst på siden, og kopiér prompten.

  2. Sæt den ind i din assistent

    Den installerer dna, tilføjer MCP-serveren og kører dna doctor for at tjekke opsætningen.

    dna doctor
  3. Log selv ind på OTE

    Kør login-kommandoen i din egen terminal, og indtast dit forhandler-ID og din OTE-API-nøgle der, aldrig i chatten.

    dna auth login --env ote
  4. Spørg med almindelige ord

    Søg, forhåndsvis med --dry-run, registrer. Alt, der trækker på testsaldoen, venter på dit ja.

    --dry-run
Manuel opsætning

Foretrækker du terminalen? To kommandoer, så er du forbundet

Installér den binære fil, og tilføj derefter dna mcp serve til din MCP-klient. Hver API-operation bliver et værktøj til Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI eller Gemini CLI.

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

Én binær fil uden afhængigheder. Hver udgivelse leveres med SHA-256-kontrolsummer.

  • Ét værktøj pr. API-operation, hver med et JSON-skema bygget ud fra API-specifikationen
  • dna_context fortæller modellen, om den er i produktion eller i testmiljøet, før den rører noget
  • Eksponér kun det, du har brug for, med --groups eller --read-only. En kortere værktøjsliste sparer også kontekst-tokens.
  • Agenter, der kun har en shell, får et skill til Claude Code og en brugsvejledning i ét kald
# forbind til testmiljøet først
$ claude mcp add dna -- dna mcp serve --env ote

# skrivebeskyttet, delt med dit team via .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

Kør dna mcp config for at få et færdigt snippet til hver klient.

Dækning

Alle 64 API-operationer, grupperet som du tænker

Hvis forhandler-API'et kan det, kan dna også. Hver kommandos --help viser dens sikkerhedsklasse, dens API-rute og eksempler.

  • dna domain

    Søgning og bulksøgning, registrering, fornyelse, overførsel og gendannelse. Overførselslås, WHOIS-beskyttelse, auth-kode, navneservere, child hosts og videresendelse.

  • dna dns · dna dnssec

    Zoneposter på platformens navneservere og DS-poster hos registryet.

  • dna ssl

    Generering af CSR, køb, konfiguration, statustjek, download, genudstedelse og tilbagekaldelse af certifikater.

  • dna hosting

    Hostingplaner og -pakker, nye ordrer og deres status.

  • dna contact

    Genbrugelige kontakthandles og verificering af deres e-mail og telefon.

  • dna account · product · order

    Saldo og transaktioner, kataloget over endelser med priser og ordrestatus.

  • dna api

    En godkendt rå forespørgsel til et hvilket som helst endpoint med de samme sikkerhedsregler.

  • dna schema · enums · agent

    Maskinlæsbare beskrivelser af hver operation, hvert input og hver kodet værdi til agenter og værktøjsudviklere.

Se hele kommandoreferencen

Scripts og CI

Bygget til pipes, cronjobs og pipelines

I en terminal får du læsbare tabeller. I en pipe får du JSON. Fejl er også JSON, med exitkoder, der aldrig skifter betydning, så et script altid ved, hvad der gik galt.

  • JSON i pipes, JSON Lines til streams og et indbygget --jq, der holder outputtet småt
  • API-oplysninger fra DNA_RESELLER_ID og DNA_API_KEY i CI, fra en profil på din egen maskine
  • Ingen skjulte spørgsmål uden for en terminal: En beskyttet kommando afslutter med kode 9 og sender intet
  • Input tjekkes, før noget sendes, og ved rate limits prøver dna automatisk igen
# domæner, der udløber inden for de næste 30 dage, som CSV
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# tjek mange navne på én gang
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# i et script stopper et køb uden --yes her
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
Exitkoder
0succes6rate limit nået
2ugyldigt input, intet sendt7serverfejl
3godkendelse8netværk
4ikke fundet9bekræftelse påkrævet
5afvist af API'et10skrivebeskyttet tilstand
Valg af værktøj

CLI, SDK, REST API eller et færdigt modul?

De taler alle med det samme forhandler-API med de samme API-oplysninger. Vælg det, der passer til, hvor arbejdet foregår.

Spørgsmål og svar

Det spørger folk om, før de forbinder en agent

Korte, direkte svar. README'en på GitHub dækker alle detaljer.

Læs hele dokumentationen
Hvad er Domain Name API CLI?

dna er den officielle kommandolinjeklient og MCP-server til forhandlerplatformen Domain Name API. Den dækker alle 64 operationer i forhandlernes REST API, fra domænesøgning, registrering, fornyelse og overførsel til DNS, DNSSEC, kontakter, SSL og hosting, i én open source-binær fil til macOS, Linux og Windows under Apache-2.0-licensen.

Er det sikkert at lade en AI-agent registrere domæner?

Ja, for agenten kan ikke købe noget på egen hånd. Betalingspligtige og destruktive operationer returnerer en forhåndsvisning i stedet for at køre. De kører først, når du har godkendt, og kaldet indeholder confirm=true, eller --yes i CLI'en. Start agenter i OTE-testmiljøet, og begræns dem yderligere med --read-only eller --no-billable.

Kan jeg prøve det uden at bruge penge?

Ja. Med --env ote taler dna med OTE, vores testmiljø. Det har sin egen API-nøgle og sin egen saldo, og intet, du gør der, rører livedomæner eller din rigtige konto.

Hvilke AI-assistenter fungerer med dna?

Enhver MCP-klient: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI og andre. Agenter, der kun har en shell, kan kalde CLI'en direkte; dna agent guide og skill'et til Claude Code lærer dem hvordan.

Skal jeg have en konto hos Domain Name API?

Ja. dna arbejder med en forhandlerkonto og dens API-oplysninger: dit forhandler-ID og en API-nøgle, begge under API-indstillinger i forhandlerpanelet. Produktion og OTE har forskellige nøgler, og din e-mail og adgangskode til panelet virker ikke her.

Er dna gratis?

Ja. Værktøjet er gratis og open source under Apache-2.0-licensen. Du betaler kun for det, du køber gennem det, som domæner, fornyelser, SSL og hosting, til dine forhandlerpriser og fra din kontosaldo.

Hvor gemmes mine API-oplysninger?

dna auth login gemmer dem i en profilfil i din brugers konfigurationsmappe, som på Linux og macOS kun kan læses af dig; dna config path viser hvor. Miljøvariabler har altid forrang, og API-nøglen maskeres i alt output, også ved --dry-run.

Kan jeg bruge dna i scripts og CI?

Ja. Output er JSON, når det sendes gennem en pipe, fejl er JSON med stabile exitkoder, og der stilles ingen spørgsmål uden for en interaktiv terminal. Angiv API-oplysningerne som DNA_RESELLER_ID og DNA_API_KEY. En betalingspligtig kommando uden --yes afslutter med kode 9 og sender intet.

Skal jeg bruge CLI'en eller et SDK?

Brug dna, når et menneske, et script eller en AI-agent udfører arbejdet. Brug et SDK til PHP, Node.js, Python, Ruby eller Go, eller selve REST API'et, når du bygger domænefunktioner ind i din egen applikation. De bruger alle det samme API og de samme API-oplysninger.

Skal jeg bruge terminalen?

Nej. Sæt en færdig prompt ind i Claude Code, som også kører i Claudes desktopapp, eller i ChatGPT Codex, så installerer og forbinder assistenten dna for dig. Den eneste kommando, du selv skriver, er dna auth login, så din API-nøgle aldrig havner i chatten. Har du slet ingen terminal, guider chatprompten dig gennem hvert trin.