Nowość · v1.0 · open source

CLI do domen i serwer MCP stworzone dla agentów AI

dna to oficjalne narzędzie wiersza poleceń i serwer MCP od Domain Name API. Wklej gotowy prompt do Claude lub ChatGPT, a Twój asystent zainstaluje je, podłączy i zajmie się Twoimi domenami, DNS, SSL i hostingiem. Wszystko, co kosztuje, czeka na Twoje „tak”.

Skonfiguruj dna w Claude Code

Skonfiguruj dla mnie CLI dna (https://github.com/domainreseller/cli).
1. Zainstaluj je oficjalnym skryptem instalacyjnym dla mojego systemu operacyjnego, a potem uruchom `dna version` i `dna doctor`.
2. Zainstaluj umiejętność Claude Code poleceniem `dna agent skill --install` i dodaj serwer MCP poleceniem `claude mcp add dna -- dna mcp serve --env ote`.
3. Nie proś mnie o wklejenie klucza API do tego czatu. Powiedz mi, że `dna auth login --env ote` mam uruchomić samodzielnie, a potem sprawdź połączenie poleceniem `dna --ote account get`.
Pracuj tylko w środowisku testowym OTE i nigdy nie używaj `--yes` bez mojej zgody.

Skopiuj prompt, wklej go do swojego asystenta AI i pozwól mu działać. Każdy prompt zaczyna od środowiska testowego OTE, a przed każdą płatną operacją zatrzymuje się i czeka na Twoją zgodę.

  • 64operacje API
  • 65narzędzi MCP
  • 4klasy bezpieczeństwa
  • 6platform, jeden plik
  • Apache-2.0licencja open source
Zwykłymi słowami

Gotowe prompty dla Claude i ChatGPT

Zmień nazwy domen, wklej prompt do asystenta i patrz, jak pracuje. Każdy prompt mówi, gdzie się zatrzymać, więc nic płatnego nie dzieje się bez Ciebie.

Znajdź i zarejestruj domenę

Za pomocą dna sprawdź, czy brandname.com, brandname.net i brandname.io są wolne. Pokaż wyniki z cenami w tabeli, a potem przygotuj z `--dry-run` podgląd rejestracji najtańszej z wolnych domen. Nie rejestruj niczego, dopóki nie powiem „tak”.
domain bulk-search · domain registerbillable

Nadchodzące odnowienia

Za pomocą dna wypisz moje domeny wygasające w ciągu najbliższych 60 dni wraz z cenami odnowienia, posortowane według daty wygaśnięcia. Niczego nie odnawiaj.
domain list · domain renew-checkread

Skieruj domenę na serwer

Za pomocą dna skieruj example.com na 203.0.113.10: dodaj rekordy A dla `@` i `www`, a potem pokaż mi końcową strefę DNS. Zapytaj mnie, zanim zmienisz lub usuniesz jakikolwiek istniejący rekord.
dns add · dns listwrite

Przenieś domenę na swoje konto

Za pomocą dna sprawdź, czy example.org można przenieść na moje konto, powiedz mi, czego jeszcze potrzebuję (kod auth, odblokowanie), i pokaż z `--dry-run` podgląd transferu.
domain transfer-check · domain transferbillable

Zamów certyfikat SSL

Za pomocą dna znajdź najtańszy certyfikat DV SSL dla example.com, wygeneruj CSR i pokaż podgląd zamówienia. Przed zakupem poczekaj na moją zgodę.
product ssls · ssl generate-csr · ssl initializebillable

Powiedz, czego potrzebujesz. Twój agent znajdzie właściwe polecenie.

Każda operacja API to narzędzie z jasnym opisem i schematem JSON, więc asystent wybiera właściwe wywołanie i już za pierwszym razem poprawnie je wypełnia. Ty mówisz, a dna wykonuje dokładnie to, co trzeba.

Bramka bezpieczeństwa

Twój agent nie wyda ani grosza bez Ciebie

Każde polecenie ma klasę bezpieczeństwa i to ona decyduje, co się stanie. Przeglądanie oraz bezpłatne, odwracalne zmiany wykonują się od razu. Wszystko, co obciąża Twoje saldo albo jest nieodwracalne, zatrzymuje się i najpierw pyta.

  • read

    Odczyt

    Wyszukiwanie, listy, informacje o domenie, ceny i reguły rozszerzeń.

    Działa od razu
  • write

    Zapis

    Rekordy DNS, blokada transferu, ochrona WHOIS i kontakty. Bezpłatne i odwracalne.

    Działa od razu
  • destructive

    Destrukcyjne

    Usunięcie rekordu, unieważnienie SSL, wyłączenie DNSSEC.

    Czeka na Twoje „tak”
  • billable

    Płatne

    Rejestracja, odnowienie, transfer, przywrócenie, zamówienia SSL i hostingu.

    Czeka na Twoje „tak”

Jak działa Twoje „tak”

Narzędzia objęte bramką mają dodatkowe pole confirm. Większość klientów MCP i tak pyta Cię przed każdym wywołaniem narzędzia, a adnotacje bezpieczeństwa pomagają im oznaczyć te ryzykowne.

  1. Agent najpierw pyta

    Wywołuje narzędzie bez confirm. Nic nie zostaje wysłane. W odpowiedzi dostaje podgląd dokładnego żądania.

  2. Ty decydujesz

    Agent pokazuje Ci domenę, okres i operację. Mówisz „tak” albo „nie”.

  3. Wykonuje się raz

    Dopiero po Twoim „tak” powtarza wywołanie z confirm=true. Płatne wywołanie nigdy nie jest wysyłane ponownie po błędzie sieci.

Zdecyduj, jak daleko może sięgnąć

--env ote
Środowisko testowe: prawdziwe API, bez prawdziwych pieniędzy
--read-only
Patrz, nie dotykaj. Każda zmiana jest blokowana.
--no-billable
Wszystko oprócz zakupów
--groups domain,dns
Tylko wymienione przez Ciebie grupy poleceń
--dry-run
Wyświetla dokładne żądanie HTTP z zamaskowanym kluczem API
Pierwsze kroki

Od promptu do pierwszej domeny w czterech krokach, wszystko w środowisku testowym

OTE to nasze środowisko testowe: to samo API z osobnym kluczem API i osobnym saldem. Poćwicz tam, a potem przejdź na produkcję jedną flagą.

  1. Skopiuj prompt

    Wybierz na górze tej strony Claude Code, ChatGPT Codex albo zwykły czat i skopiuj prompt.

  2. Wklej go do asystenta

    Asystent instaluje dna, dodaje serwer MCP i uruchamia dna doctor, żeby sprawdzić konfigurację.

    dna doctor
  3. Zaloguj się do OTE samodzielnie

    Uruchom polecenie logowania we własnym terminalu i tam wpisz swój Reseller ID oraz klucz API dla OTE, nigdy na czacie.

    dna auth login --env ote
  4. Poproś zwykłymi słowami

    Wyszukaj, zrób podgląd z --dry-run, zarejestruj. Wszystko, co obciąża saldo testowe, czeka na Twoje „tak”.

    --dry-run
Ręczna konfiguracja

Wolisz terminal? Dwa polecenia i masz połączenie

Zainstaluj plik binarny, a potem dodaj dna mcp serve do swojego klienta MCP. Każda operacja API staje się narzędziem dla Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI lub Gemini CLI.

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

Jeden plik binarny bez żadnych zależności. Każde wydanie ma sumy kontrolne SHA-256.

  • Jedno narzędzie na każdą operację API, każde ze schematem JSON zbudowanym na podstawie specyfikacji API
  • dna_context mówi modelowi, czy pracuje na produkcji, czy w środowisku testowym, zanim czegokolwiek dotknie
  • Udostępnij tylko to, czego potrzebujesz, za pomocą --groups lub --read-only. Krótsza lista narzędzi oszczędza też tokeny kontekstu.
  • Agenci, którzy mają tylko powłokę, dostają jednym wywołaniem umiejętność Claude Code i przewodnik użycia
# najpierw połącz się ze środowiskiem testowym
$ claude mcp add dna -- dna mcp serve --env ote

# tylko do odczytu, współdzielone z zespołem przez .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

Uruchom dna mcp config, a dostaniesz gotowy fragment konfiguracji dla każdego klienta.

Zakres

Wszystkie 64 operacje API, pogrupowane tak, jak myślisz

Jeśli API dla resellerów coś potrafi, dna też to potrafi. --help każdego polecenia pokazuje jego klasę bezpieczeństwa, ścieżkę API i przykłady.

  • dna domain

    Wyszukiwanie pojedyncze i zbiorcze, rejestracja, odnowienie, transfer i przywracanie. Blokada transferu, ochrona WHOIS, kod auth, serwery nazw, hosty podrzędne i przekierowania.

  • dna dns · dna dnssec

    Rekordy strefy na serwerach nazw platformy oraz rekordy DS w rejestrze.

  • dna ssl

    Generowanie CSR, zakup, konfiguracja, sprawdzanie statusu, pobieranie, ponowne wystawianie i unieważnianie certyfikatów.

  • dna hosting

    Plany i pakiety hostingowe, nowe zamówienia i ich status.

  • dna contact

    Kontakty wielokrotnego użytku oraz ich weryfikacja e-mailowa i telefoniczna.

  • dna account · product · order

    Saldo i transakcje, katalog rozszerzeń z cenami oraz status zamówień.

  • dna api

    Uwierzytelnione surowe żądanie do dowolnego endpointu, z tymi samymi zasadami bezpieczeństwa.

  • dna schema · enums · agent

    Czytelne dla maszyn opisy każdej operacji, parametru i wartości kodowanej, dla agentów i twórców narzędzi.

Zobacz pełną dokumentację poleceń

Skrypty i CI

Do potoków, zadań cron i pipeline'ów CI

W terminalu dostajesz czytelne tabele, w potoku – JSON. Błędy też są w JSON, z kodami wyjścia, które nigdy nie zmieniają znaczenia, więc skrypt zawsze wie, co poszło nie tak.

  • JSON w potoku, JSON Lines dla strumieni i wbudowany --jq, żeby wynik był krótki
  • W CI dane dostępowe z DNA_RESELLER_ID i DNA_API_KEY, na własnym komputerze z profilu
  • Bez ukrytych pytań poza terminalem: polecenie objęte bramką kończy się kodem 9 i nic nie wysyła
  • Dane wejściowe są sprawdzane przed wysłaniem, a żądania zatrzymane przez limit zapytań są ponawiane za Ciebie
# domeny wygasające w ciągu najbliższych 30 dni, jako CSV
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# sprawdź wiele nazw naraz
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# w skrypcie zakup bez --yes zatrzymuje się tutaj
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
Kody wyjścia
0sukces6limit zapytań
2błędne dane, nic nie wysłano7błąd serwera
3uwierzytelnianie8sieć
4nie znaleziono9wymagane potwierdzenie
5odrzucone przez API10tryb tylko do odczytu
Wybór narzędzia

CLI, SDK, REST API czy gotowy moduł?

Wszystkie łączą się z tym samym API dla resellerów przy użyciu tych samych danych dostępowych. Wybierz to, co pasuje do miejsca, w którym odbywa się praca.

Najczęstsze pytania

O co ludzie pytają, zanim podłączą agenta

Krótkie, konkretne odpowiedzi. Wszystkie szczegóły znajdziesz w README na GitHubie.

Przeczytaj pełną dokumentację
Czym jest Domain Name API CLI?

dna to oficjalny klient wiersza poleceń i serwer MCP platformy resellerskiej Domain Name API. Obejmuje wszystkie 64 operacje REST API dla resellerów, od wyszukiwania, rejestracji, odnawiania i transferu domen po DNS, DNSSEC, kontakty, SSL i hosting, w jednym pliku binarnym open source dla systemów macOS, Linux i Windows, na licencji Apache-2.0.

Czy bezpiecznie jest pozwolić agentowi AI rejestrować domeny?

Tak, bo agent nie może niczego kupić sam. Zamiast się wykonać, operacje płatne i destrukcyjne zwracają podgląd. Wykonują się dopiero wtedy, gdy je zatwierdzisz, a wywołanie zawiera confirm=true (w CLI: --yes). Uruchamiaj agentów najpierw w środowisku testowym OTE i dodatkowo ograniczaj ich przez --read-only lub --no-billable.

Czy mogę to wypróbować bez wydawania pieniędzy?

Tak. Z --env ote dna łączy się z OTE, naszym środowiskiem testowym. Ma ono własny klucz API i własne saldo, a nic, co tam zrobisz, nie dotyka domen produkcyjnych ani Twojego prawdziwego konta.

Z jakimi asystentami AI działa dna?

Z każdym klientem MCP: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI i innymi. Agenci, którzy mają tylko powłokę, mogą wywoływać CLI bezpośrednio; dna agent guide i umiejętność Claude Code uczą ich, jak to robić.

Czy potrzebuję konta w Domain Name API?

Tak. dna działa z kontem resellera i jego danymi dostępowymi API: Twoim Reseller ID i kluczem API; oba znajdziesz w panelu resellera w sekcji Ustawienia API. Produkcja i OTE mają różne klucze, a e-mail i hasło do panelu tutaj nie zadziałają.

Czy dna jest bezpłatne?

Tak. Narzędzie jest bezpłatne i open source na licencji Apache-2.0. Płacisz tylko za to, co przez nie kupujesz, np. domeny, odnowienia, SSL i hosting, po swoich cenach resellerskich i z salda konta.

Gdzie są przechowywane moje dane dostępowe?

dna auth login zapisuje je w pliku profilu w folderze konfiguracyjnym Twojego użytkownika; w systemach Linux i macOS tylko Ty możesz ten plik odczytać, a dna config path pokazuje, gdzie się znajduje. Zmienne środowiskowe zawsze mają pierwszeństwo, a klucz API jest maskowany w każdym wyjściu, także w --dry-run.

Czy mogę używać dna w skryptach i CI?

Tak. W potoku wynik jest w JSON, błędy są w JSON ze stałymi kodami wyjścia, a poza interaktywnym terminalem nie ma żadnych pytań. Przekaż dane dostępowe jako DNA_RESELLER_ID i DNA_API_KEY. Płatne polecenie bez --yes kończy się kodem 9 i nic nie wysyła.

CLI czy SDK – co wybrać?

Używaj dna, gdy pracę wykonuje człowiek, skrypt lub agent AI. Gdy wbudowujesz funkcje domenowe we własną aplikację, użyj SDK dla języków PHP, Node.js, Python, Ruby lub Go albo bezpośrednio REST API. Wszystkie korzystają z tego samego API i tych samych danych dostępowych.

Czy muszę używać terminala?

Nie. Wklej gotowy prompt do Claude Code, który działa też w aplikacji desktopowej Claude, albo do ChatGPT Codex, a asystent zainstaluje i podłączy dna za Ciebie. Jedyne polecenie, które wpisujesz samodzielnie, to dna auth login, więc Twój klucz API nigdy nie trafia na czat. Jeśli w ogóle nie masz terminala, prompt do czatu przeprowadzi Cię przez każdy krok.