Nyhet · v1.0 · öppen källkod

Domän-CLI och MCP-server byggda för AI-agenter

dna är Domain Name API:s officiella kommandoradsverktyg och MCP-server. Kopiera en färdig prompt till Claude eller ChatGPT, så installerar din assistent dna, kopplar in det och börjar arbeta med dina domäner, DNS, SSL och hosting. Allt som kostar pengar väntar på ditt ja.

Sätt upp dna i Claude Code

Sätt upp dna CLI åt mig (https://github.com/domainreseller/cli).
1. Installera den med det officiella installationsskriptet för mitt operativsystem och kör sedan `dna version` och `dna doctor`.
2. Installera skillen för Claude Code med `dna agent skill --install` och lägg till MCP-servern med `claude mcp add dna -- dna mcp serve --env ote`.
3. Be mig inte klistra in min API-nyckel i den här chatten. Säg åt mig att köra `dna auth login --env ote` själv och kontrollera sedan anslutningen med `dna --ote account get`.
Arbeta bara i OTE-testmiljön och använd aldrig `--yes` utan mitt godkännande.

Kopiera en prompt, klistra in den i din AI-assistent och låt den göra jobbet. Varje prompt börjar i OTE-testmiljön och väntar på ditt godkännande innan något avgiftsbelagt händer.

  • 64API-operationer
  • 65MCP-verktyg
  • 4säkerhetsklasser
  • 6plattformar, en binärfil
  • Apache-2.0licens för öppen källkod
Med vanliga ord

Färdiga promptar för Claude och ChatGPT

Byt ut domännamnen, klistra in en prompt i din assistent och se den arbeta. Varje prompt säger var den ska stanna, så inget avgiftsbelagt händer utan dig.

Hitta och registrera en domän

Kontrollera med dna om brandname.com, brandname.net och brandname.io är lediga. Visa resultaten med priser i en tabell och förhandsgranska sedan registreringen av den billigaste lediga domänen med `--dry-run`. Registrera ingenting förrän jag säger ja.
domain bulk-search · domain registerbillable

Kommande förnyelser

Använd dna för att lista mina domäner som går ut inom de kommande 60 dagarna, med deras förnyelsepriser, sorterade efter utgångsdatum. Förnya ingenting.
domain list · domain renew-checkread

Peka en domän mot en server

Peka example.com mot 203.0.113.10 med dna: lägg till A-poster för `@` och `www` och visa mig sedan den slutliga DNS-zonen. Fråga mig innan du ändrar eller raderar en befintlig post.
dns add · dns listwrite

Överför en domän till ditt konto

Kontrollera med dna om example.org kan överföras till mitt konto, berätta vad jag fortfarande behöver (auth-kod, upplåsning) och förhandsgranska överföringen med `--dry-run`.
domain transfer-check · domain transferbillable

Beställ ett SSL-certifikat

Hitta det billigaste DV-SSL-certifikatet för example.com med dna, skapa en CSR och förhandsgranska beställningen. Vänta på mitt godkännande innan du köper.
product ssls · ssl generate-csr · ssl initializebillable

Säg vad du behöver. Din agent hittar rätt kommando.

Varje API-operation är ett verktyg med en tydlig beskrivning och ett JSON-schema, så att assistenter väljer rätt anrop och fyller i det korrekt på första försöket. Du pratar, dna gör det exakta jobbet.

Säkerhetsspärr

Din agent kan inte spendera en krona utan dig

Varje kommando har en säkerhetsklass, och klassen avgör vad som händer. Att titta runt och kostnadsfria ändringar som går att ångra körs direkt. Allt som belastar ditt saldo eller inte går att ångra stannar och frågar först.

  • read

    Läsa

    Sökning, listor, domäninfo, priser och regler för ändelser.

    Körs direkt
  • write

    Skriva

    DNS-poster, överföringslås, WHOIS-integritet och kontakter. Kostnadsfritt och går att ångra.

    Körs direkt
  • destructive

    Destruktiv

    Radera en post, återkalla SSL, stänga av DNSSEC.

    Väntar på ditt ja
  • billable

    Avgiftsbelagd

    Registrering, förnyelse, överföring, återställning, SSL- och hostingbeställningar.

    Väntar på ditt ja

Så fungerar ditt ja

Spärrade verktyg har ett extra confirm-fält. De flesta MCP-klienter frågar dig också före varje verktygsanrop; säkerhetsannoteringarna hjälper dem att flagga de riskfyllda.

  1. Agenten frågar först

    Den anropar verktyget utan confirm. Ingenting skickas. Den får tillbaka en förhandsvisning av den exakta förfrågan.

  2. Du bestämmer

    Agenten visar dig domänen, perioden och åtgärden. Du säger ja eller nej.

  3. Det körs en gång

    Först efter ditt ja upprepar den anropet med confirm=true. Ett avgiftsbelagt anrop skickas aldrig om efter ett nätverksfel.

Bestäm hur långt den når

--env ote
Testmiljö: det riktiga API:et, inga riktiga pengar
--read-only
Titta, men rör inte. Alla ändringar blockeras.
--no-billable
Allt utom köp
--groups domain,dns
Bara de kommandogrupper du anger
--dry-run
Skriver ut den exakta HTTP-förfrågan med API-nyckeln maskerad
Kom igång

Från prompt till första domän i fyra steg, helt i testmiljön

OTE är vår testmiljö: samma API med en egen API-nyckel och ett eget saldo. Öva där och byt sedan till produktion med en enda flagga.

  1. Kopiera en prompt

    Välj Claude Code, ChatGPT Codex eller vanlig chatt högst upp på sidan och kopiera prompten.

  2. Klistra in den i din assistent

    Den installerar dna, lägger till MCP-servern och kör dna doctor för att kontrollera installationen.

    dna doctor
  3. Logga in i OTE själv

    Kör inloggningskommandot i din egen terminal och ange ditt återförsäljar-ID och din OTE-API-nyckel där, aldrig i chatten.

    dna auth login --env ote
  4. Fråga med vanliga ord

    Sök, förhandsgranska med --dry-run, registrera. Allt som belastar testsaldot väntar på ditt ja.

    --dry-run
Manuell installation

Föredrar du terminalen? Två kommandon, sedan är du ansluten

Installera binärfilen och lägg sedan till dna mcp serve i din MCP-klient. Varje API-operation blir ett verktyg för 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

En enda binärfil utan beroenden. Varje version levereras med SHA-256-kontrollsummor.

  • Ett verktyg per API-operation, vart och ett med ett JSON-schema byggt från API-specifikationen
  • dna_context talar om för modellen om den är i produktion eller i testmiljön innan den rör något
  • Exponera bara det du behöver med --groups eller --read-only. En kortare verktygslista sparar också kontext-tokens.
  • Agenter som bara har ett shell får en skill för Claude Code och en användarguide i ett enda anrop
# anslut till testmiljön först
$ claude mcp add dna -- dna mcp serve --env ote

# skrivskyddat, delat med ditt team via .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

Kör dna mcp config för att skriva ut ett färdigt kodstycke för varje klient.

Täckning

Alla 64 API-operationer, grupperade som du tänker

Kan återförsäljar-API:et göra det, så kan dna det också. Varje kommandos --help visar dess säkerhetsklass, API-väg och exempel.

  • dna domain

    Sökning och bulksökning, registrering, förnyelse, överföring och återställning. Överföringslås, WHOIS-integritet, auth-kod, namnservrar, child hosts och vidarebefordran.

  • dna dns · dna dnssec

    Zonposter på plattformens namnservrar och DS-poster hos registryt.

  • dna ssl

    Generera en CSR, köp, konfigurera, kontrollera status, ladda ner, utfärda på nytt och återkalla certifikat.

  • dna hosting

    Hostingplaner och paket, nya beställningar och deras status.

  • dna contact

    Återanvändbara kontakt-handles och verifiering av deras e-post och telefon.

  • dna account · product · order

    Saldo och transaktioner, katalogen över ändelser med priser och orderstatus.

  • dna api

    Ett autentiserat rått anrop till valfri endpoint, med samma säkerhetsregler.

  • dna schema · enums · agent

    Maskinläsbara beskrivningar av varje operation, indata och kodat värde, för agenter och verktygsbyggare.

Se hela kommandoreferensen

Skript och CI

Byggt för pipes, cron-jobb och pipelines

I en terminal får du läsbara tabeller. I en pipe får du JSON. Även fel är JSON, med exit-koder som aldrig byter betydelse, så att ett skript alltid vet vad som gick fel.

  • JSON i pipes, JSON Lines för strömmar och en inbyggd --jq som håller utdata liten
  • API-uppgifter från DNA_RESELLER_ID och DNA_API_KEY i CI, från en profil på din egen dator
  • Inga dolda frågor utanför en terminal: ett spärrat kommando avslutas med kod 9 och skickar ingenting
  • Indata kontrolleras innan något skickas, och vid rate limits görs nya försök åt dig
# domäner som går ut under de kommande 30 dagarna, som CSV
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# kontrollera många namn på en gång
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# i ett skript stannar ett köp utan --yes här
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
Exit-koder
0lyckades6rate limit nådd
2ogiltig indata, inget skickat7serverfel
3autentisering8nätverk
4hittades inte9bekräftelse krävs
5avvisat av API:et10skrivskyddat läge
Välj verktyg

CLI, SDK, REST API eller en färdig modul?

Alla pratar med samma återförsäljar-API med samma API-uppgifter. Välj det som passar där jobbet görs.

Vanliga frågor

Det här frågar folk innan de kopplar in en agent

Korta, raka svar. README-filen på GitHub täcker varje detalj.

Läs hela dokumentationen
Vad är Domain Name API CLI?

dna är den officiella kommandoradsklienten och MCP-servern för återförsäljarplattformen Domain Name API. Den täcker alla 64 operationer i återförsäljarnas REST API, från domänsökning, registrering, förnyelse och överföring till DNS, DNSSEC, kontakter, SSL och hosting, i en enda binärfil med öppen källkod för macOS, Linux och Windows under Apache-2.0-licensen.

Är det säkert att låta en AI-agent registrera domäner?

Ja, eftersom agenten inte kan köpa något på egen hand. Avgiftsbelagda och destruktiva operationer returnerar en förhandsvisning i stället för att köras. De körs först när du har godkänt och anropet innehåller confirm=true, eller --yes i CLI:n. Låt agenter börja i OTE-testmiljön och begränsa dem ytterligare med --read-only eller --no-billable.

Kan jag prova utan att spendera pengar?

Ja. Med --env ote pratar dna med OTE, vår testmiljö. Den har en egen API-nyckel och ett eget saldo, och inget du gör där påverkar livedomäner eller ditt riktiga konto.

Vilka AI-assistenter fungerar med dna?

Alla MCP-klienter: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI med flera. Agenter som bara har ett shell kan anropa CLI:n direkt; dna agent guide och skillen för Claude Code lär dem hur.

Behöver jag ett konto hos Domain Name API?

Ja. dna arbetar med ett återförsäljarkonto och dess API-uppgifter: ditt återförsäljar-ID och en API-nyckel, båda under API-inställningar i återförsäljarpanelen. Produktion och OTE har olika nycklar, och din e-post och ditt lösenord till panelen fungerar inte här.

Är dna kostnadsfritt?

Ja. Verktyget är kostnadsfritt och öppen källkod under Apache-2.0-licensen. Du betalar bara för det du köper via det, som domäner, förnyelser, SSL och hosting, till dina återförsäljarpriser och från ditt kontosaldo.

Var lagras mina API-uppgifter?

dna auth login sparar dem i en profilfil i din användares konfigurationsmapp, som på Linux och macOS bara kan läsas av dig; dna config path visar var. Miljövariabler har alltid företräde, och API-nyckeln maskeras i all utdata, även med --dry-run.

Kan jag använda dna i skript och CI?

Ja. Utdata är JSON i en pipe, fel är JSON med stabila exit-koder, och utanför en interaktiv terminal ställs inga frågor. Ange API-uppgifterna som DNA_RESELLER_ID och DNA_API_KEY. Ett avgiftsbelagt kommando utan --yes avslutas med kod 9 och skickar ingenting.

Ska jag använda CLI:n eller ett SDK?

Använd dna när en människa, ett skript eller en AI-agent gör jobbet. Använd ett SDK för PHP, Node.js, Python, Ruby eller Go, eller själva REST API:et, när du bygger in domänfunktioner i din egen applikation. Alla använder samma API och samma API-uppgifter.

Måste jag använda terminalen?

Nej. Klistra in en färdig prompt i Claude Code, som även körs i Claudes skrivbordsapp, eller i ChatGPT Codex, så installerar assistenten dna och kopplar in det åt dig. Det enda kommando du skriver själv är dna auth login, så din API-nyckel hamnar aldrig i chatten. Har du ingen terminal alls guidar chattprompten dig genom varje steg.