Baru · v1.0 · open source

CLI domain dan server MCP yang dibuat untuk agen AI

dna adalah alat command line dan server MCP resmi Domain Name API. Salin prompt siap pakai ke Claude atau ChatGPT, lalu asisten Anda akan menginstalnya, menghubungkannya, dan mulai mengerjakan domain, DNS, SSL, serta hosting Anda. Apa pun yang memakan biaya menunggu persetujuan Anda.

Siapkan dna di Claude Code

Siapkan dna CLI untuk saya (https://github.com/domainreseller/cli).
1. Instal dengan skrip instalasi resmi untuk sistem operasi saya, lalu jalankan `dna version` dan `dna doctor`.
2. Instal skill Claude Code dengan `dna agent skill --install` dan tambahkan server MCP dengan `claude mcp add dna -- dna mcp serve --env ote`.
3. Jangan minta saya menempelkan kunci API saya ke chat ini. Beri tahu saya untuk menjalankan sendiri `dna auth login --env ote`, lalu periksa koneksinya dengan `dna --ote account get`.
Bekerjalah hanya di lingkungan uji OTE dan jangan pernah memakai `--yes` tanpa persetujuan saya.

Salin prompt, tempel ke asisten AI Anda, dan biarkan ia yang bekerja. Setiap prompt dimulai di lingkungan uji OTE dan berhenti untuk meminta persetujuan Anda sebelum ada yang berbayar.

  • 64operasi API
  • 65tool MCP
  • 4kelas keamanan
  • 6platform, satu binary
  • Apache-2.0lisensi open source
Dengan bahasa sehari-hari

Prompt siap pakai untuk Claude dan ChatGPT

Ganti nama domainnya, tempel prompt ke asisten Anda, dan lihat ia bekerja. Setiap prompt menyebutkan kapan harus berhenti, jadi tidak ada yang berbayar terjadi tanpa Anda.

Cari dan daftarkan domain

Dengan dna, cek apakah brandname.com, brandname.net, dan brandname.io tersedia. Tampilkan hasilnya beserta harga dalam tabel, lalu buat pratinjau registrasi untuk yang termurah di antara yang tersedia dengan `--dry-run`. Jangan daftarkan apa pun sampai saya bilang ya.
domain bulk-search · domain registerbillable

Perpanjangan yang akan datang

Dengan dna, tampilkan domain saya yang kedaluwarsa dalam 60 hari ke depan beserta harga perpanjangannya, diurutkan berdasarkan tanggal kedaluwarsa. Jangan perpanjang apa pun.
domain list · domain renew-checkread

Arahkan domain ke server

Dengan dna, arahkan example.com ke 203.0.113.10: tambahkan record A untuk `@` dan `www`, lalu tampilkan zona DNS akhirnya kepada saya. Tanya saya dulu sebelum mengubah atau menghapus record yang sudah ada.
dns add · dns listwrite

Transfer domain ke akun Anda

Dengan dna, cek apakah example.org bisa ditransfer ke akun saya, beri tahu apa yang masih saya perlukan (kode auth, buka kunci), dan buat pratinjau transfernya dengan `--dry-run`.
domain transfer-check · domain transferbillable

Pesan sertifikat SSL

Dengan dna, cari sertifikat DV SSL termurah untuk example.com, buat CSR, dan tampilkan pratinjau pesanannya. Tunggu persetujuan saya sebelum membeli.
product ssls · ssl generate-csr · ssl initializebillable

Sebutkan kebutuhan Anda. Agen Anda yang mencari perintah yang tepat.

Setiap operasi API adalah tool dengan deskripsi yang jelas dan JSON Schema, sehingga asisten memilih panggilan yang tepat dan mengisinya dengan benar sejak percobaan pertama. Anda cukup bicara, dna yang mengerjakan tugasnya dengan presisi.

Gerbang keamanan

Agen Anda tak bisa membelanjakan sepeser pun tanpa Anda

Setiap perintah punya kelas keamanan, dan kelas itulah yang menentukan apa yang terjadi. Melihat-lihat serta perubahan gratis yang bisa dibatalkan langsung berjalan. Apa pun yang memotong saldo Anda atau tidak bisa dibatalkan akan berhenti dan bertanya dulu.

  • read

    Baca

    Pencarian, daftar, info domain, harga, dan aturan TLD.

    Langsung berjalan
  • write

    Tulis

    Record DNS, kunci transfer, privasi, dan kontak. Gratis dan bisa dibatalkan.

    Langsung berjalan
  • destructive

    Destruktif

    Menghapus record, mencabut SSL, menonaktifkan DNSSEC.

    Menunggu persetujuan Anda
  • billable

    Berbayar

    Pesanan registrasi, perpanjangan, transfer, restore, SSL, dan hosting.

    Menunggu persetujuan Anda

Cara kerja persetujuan

Tool yang dijaga gerbang punya satu field tambahan, confirm. Sebagian besar klien MCP juga bertanya kepada Anda sebelum setiap panggilan tool; anotasi keamanan membantu mereka menandai yang berisiko.

  1. Agen bertanya dulu

    Agen memanggil tool tanpa confirm. Tidak ada yang dikirim. Yang kembali adalah pratinjau request persisnya.

  2. Anda yang memutuskan

    Agen menunjukkan domain, periode, dan operasinya kepada Anda. Anda menjawab ya atau tidak.

  3. Dijalankan sekali

    Baru setelah Anda setuju, agen mengulang panggilan dengan confirm=true. Panggilan berbayar tidak pernah dikirim ulang setelah error jaringan.

Tentukan sejauh mana jangkauannya

--env ote
Lingkungan uji: API sungguhan, tanpa uang sungguhan
--read-only
Boleh lihat, jangan sentuh. Setiap perubahan diblokir.
--no-billable
Semuanya kecuali pembelian
--groups domain,dns
Hanya grup perintah yang Anda sebutkan
--dry-run
Mencetak request HTTP persisnya dengan kunci API disamarkan
Memulai

Dari prompt ke domain pertama dalam empat langkah, semuanya di lingkungan uji

OTE adalah lingkungan uji kami: API yang sama dengan kunci API dan saldo tersendiri. Berlatihlah di sana, lalu pindah ke produksi dengan satu flag.

  1. Salin prompt

    Pilih Claude Code, ChatGPT Codex, atau chat biasa di bagian atas halaman ini, lalu salin prompt-nya.

  2. Tempel ke asisten Anda

    Asisten menginstal dna, menambahkan server MCP, dan menjalankan dna doctor untuk memeriksa penyiapannya.

    dna doctor
  3. Login ke OTE sendiri

    Jalankan perintah login di terminal Anda sendiri dan masukkan Reseller ID serta kunci API OTE Anda di sana, jangan pernah di chat.

    dna auth login --env ote
  4. Minta dengan bahasa sehari-hari

    Cari, buat pratinjau dengan --dry-run, daftarkan. Apa pun yang memotong saldo uji menunggu persetujuan Anda.

    --dry-run
Penyiapan manual

Lebih suka terminal? Dua perintah dan Anda terhubung

Instal binary-nya, lalu tambahkan dna mcp serve ke klien MCP Anda. Setiap operasi API menjadi tool untuk Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI, atau Gemini CLI.

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

Satu binary tanpa dependensi. Setiap rilis disertai checksum SHA-256.

  • Satu tool per operasi API, masing-masing dengan JSON Schema yang dibangun dari spesifikasi API
  • dna_context memberi tahu model apakah ia berada di produksi atau di lingkungan uji sebelum menyentuh apa pun
  • Buka hanya yang Anda perlukan dengan --groups atau --read-only. Daftar tool yang lebih pendek juga menghemat token konteks.
  • Agen yang hanya punya shell mendapat skill Claude Code dan panduan penggunaan dalam satu panggilan
# hubungkan ke lingkungan uji terlebih dahulu
$ claude mcp add dna -- dna mcp serve --env ote

# hanya-baca, dibagikan ke tim Anda melalui .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

Jalankan dna mcp config untuk mencetak snippet siap pakai bagi setiap klien.

Cakupan

Semua 64 operasi API, dikelompokkan sesuai cara Anda berpikir

Apa pun yang bisa dilakukan API reseller, bisa juga dilakukan dna. --help pada setiap perintah menampilkan kelas keamanan, rute API, dan contohnya.

  • dna domain

    Pencarian tunggal dan massal, registrasi, perpanjangan, transfer, dan restore. Kunci transfer, privasi, kode auth, nameserver, child host, dan forwarding.

  • dna dns · dna dnssec

    Record zona di nameserver platform, dan record DS di registry.

  • dna ssl

    Buat CSR, beli, konfigurasi, cek status, unduh, terbitkan ulang, dan cabut sertifikat.

  • dna hosting

    Paket dan plan hosting, pesanan baru, beserta statusnya.

  • dna contact

    Handle kontak yang bisa dipakai ulang, beserta verifikasi email dan teleponnya.

  • dna account · product · order

    Saldo dan transaksi, katalog TLD beserta harganya, dan status pesanan.

  • dna api

    Request mentah yang terautentikasi ke endpoint mana pun, dengan aturan keamanan yang sama.

  • dna schema · enums · agent

    Deskripsi yang bisa dibaca mesin untuk setiap operasi, input, dan nilai berkode, bagi agen dan pembuat tool.

Lihat referensi perintah lengkap

Skrip & CI

Dibuat untuk pipe, cron job, dan pipeline

Di terminal Anda mendapat tabel yang mudah dibaca. Di pipe Anda mendapat JSON. Error juga berupa JSON, dengan exit code yang maknanya tidak pernah berubah, jadi skrip selalu tahu apa yang salah.

  • JSON saat di-pipe, JSON Lines untuk stream, dan --jq bawaan agar output tetap ringkas
  • Kredensial dari DNA_RESELLER_ID dan DNA_API_KEY di CI, dari profil di mesin Anda sendiri
  • Tidak ada prompt tersembunyi di luar terminal: perintah yang dijaga gerbang keluar dengan kode 9 dan tidak mengirim apa pun
  • Input diperiksa sebelum apa pun dikirim, dan request yang kena rate limit dicoba ulang secara otomatis
# domain yang kedaluwarsa dalam 30 hari ke depan, sebagai CSV
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# cek banyak nama sekaligus
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# di dalam skrip, pembelian tanpa --yes berhenti di sini
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
Exit code
0berhasil6kena rate limit
2input tidak valid, tidak ada yang dikirim7error server
3autentikasi8jaringan
4tidak ditemukan9perlu konfirmasi
5ditolak oleh API10mode hanya-baca
Memilih alat

CLI, SDK, REST API, atau modul siap pakai?

Semuanya terhubung ke API reseller yang sama dengan kredensial yang sama. Pilih yang paling cocok dengan tempat pekerjaan itu dilakukan.

Tanya Jawab

Yang ditanyakan orang sebelum menghubungkan agen

Jawaban singkat dan lugas. README di GitHub membahas setiap detailnya.

Baca dokumentasi lengkap
Apa itu Domain Name API CLI?

dna adalah klien command line dan server MCP resmi untuk platform reseller Domain Name API. Alat ini mencakup seluruh 64 operasi REST API reseller, mulai dari pencarian, registrasi, perpanjangan, dan transfer domain hingga DNS, DNSSEC, kontak, SSL, dan hosting, dalam satu binary open source untuk macOS, Linux, dan Windows di bawah lisensi Apache-2.0.

Apakah aman membiarkan agen AI mendaftarkan domain?

Ya, karena agen tidak bisa membeli apa pun sendiri. Operasi berbayar dan destruktif mengembalikan pratinjau alih-alih langsung dijalankan. Operasi itu baru berjalan setelah Anda menyetujuinya dan panggilannya membawa confirm=true, atau --yes di CLI. Mulailah agen di lingkungan uji OTE dan persempit lagi aksesnya dengan --read-only atau --no-billable.

Bisakah saya mencobanya tanpa mengeluarkan uang?

Bisa. Dengan --env ote, dna terhubung ke OTE, lingkungan uji kami. OTE punya kunci API dan saldo tersendiri, dan apa pun yang Anda lakukan di sana tidak menyentuh domain live atau akun Anda yang sebenarnya.

Asisten AI apa saja yang bisa dipakai dengan dna?

Klien MCP mana pun: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI, dan lainnya. Agen yang hanya punya shell bisa memanggil CLI secara langsung; dna agent guide dan skill Claude Code mengajari mereka caranya.

Apakah saya perlu akun Domain Name API?

Ya. dna bekerja dengan akun reseller dan kredensial API-nya: Reseller ID Anda dan kunci API, keduanya ada di Pengaturan API pada panel reseller. Produksi dan OTE memakai kunci yang berbeda, dan email serta kata sandi panel Anda tidak berlaku di sini.

Apakah dna gratis?

Ya. Alat ini gratis dan open source di bawah lisensi Apache-2.0. Anda hanya membayar apa yang Anda beli melaluinya, seperti domain, perpanjangan, SSL, dan hosting, dengan harga reseller Anda dan dari saldo akun Anda.

Di mana kredensial saya disimpan?

dna auth login menyimpannya di file profil dalam folder konfigurasi pengguna Anda, yang di Linux dan macOS hanya bisa dibaca oleh Anda; dna config path menunjukkan lokasinya. Variabel lingkungan selalu didahulukan, dan kunci API disamarkan di setiap output, termasuk --dry-run.

Bisakah saya memakai dna di skrip dan CI?

Bisa. Output berupa JSON saat di-pipe, error berupa JSON dengan exit code yang stabil, dan tidak ada prompt di luar terminal interaktif. Berikan kredensial sebagai DNA_RESELLER_ID dan DNA_API_KEY. Perintah berbayar tanpa --yes keluar dengan kode 9 dan tidak mengirim apa pun.

Sebaiknya saya pakai CLI atau SDK?

Pakai dna saat pekerjaan dilakukan oleh orang, skrip, atau agen AI. Pakai SDK untuk PHP, Node.js, Python, Ruby, atau Go, atau REST API itu sendiri, saat Anda membangun fitur domain ke dalam aplikasi sendiri. Semuanya memakai API yang sama dan kredensial yang sama.

Apakah saya harus memakai terminal?

Tidak. Tempel prompt siap pakai ke Claude Code, yang juga berjalan di aplikasi desktop Claude, atau ke ChatGPT Codex, dan asisten akan menginstal serta menghubungkan dna untuk Anda. Satu-satunya perintah yang Anda ketik sendiri adalah dna auth login, sehingga kunci API Anda tidak pernah masuk ke chat. Kalau Anda sama sekali tidak punya terminal, prompt chat akan memandu Anda di setiap langkah.