Mới · v1.0 · mã nguồn mở

CLI tên miền và máy chủ MCP dành cho AI agent

dna là công cụ dòng lệnh và máy chủ MCP chính thức của Domain Name API. Sao chép một prompt có sẵn vào Claude hoặc ChatGPT, trợ lý của bạn sẽ cài đặt, kết nối và bắt tay vào xử lý tên miền, DNS, SSL và hosting của bạn. Mọi thao tác tốn tiền đều chờ bạn đồng ý.

Thiết lập dna trong Claude Code

Hãy thiết lập dna CLI giúp tôi (https://github.com/domainreseller/cli).
1. Cài đặt bằng script cài đặt chính thức cho hệ điều hành của tôi, sau đó chạy `dna version` và `dna doctor`.
2. Cài skill Claude Code bằng `dna agent skill --install` và thêm máy chủ MCP bằng `claude mcp add dna -- dna mcp serve --env ote`.
3. Đừng yêu cầu tôi dán khóa API vào cuộc trò chuyện này. Hãy bảo tôi tự chạy `dna auth login --env ote`, sau đó kiểm tra kết nối bằng `dna --ote account get`.
Chỉ làm việc trong môi trường thử nghiệm OTE và không bao giờ dùng `--yes` khi chưa được tôi phê duyệt.

Sao chép một prompt, dán vào trợ lý AI của bạn và để nó làm phần việc còn lại. Mọi prompt đều bắt đầu trong môi trường thử nghiệm OTE và dừng lại chờ bạn phê duyệt trước bất kỳ thao tác tính phí nào.

  • 64thao tác API
  • 65công cụ MCP
  • 4cấp độ an toàn
  • 6nền tảng, một file thực thi
  • Apache-2.0giấy phép mã nguồn mở
Nói bằng lời thường

Prompt có sẵn cho Claude và ChatGPT

Đổi tên miền, dán prompt vào trợ lý của bạn và xem nó làm việc. Mỗi prompt đều nói rõ chỗ cần dừng, nên không có thao tác tính phí nào diễn ra nếu bạn chưa đồng ý.

Tìm và đăng ký tên miền

Dùng dna kiểm tra xem brandname.com, brandname.net và brandname.io còn trống không. Hiển thị kết quả kèm giá trong một bảng, sau đó xem trước việc đăng ký tên miền rẻ nhất còn trống bằng `--dry-run`. Không đăng ký gì cho đến khi tôi đồng ý.
domain bulk-search · domain registerbillable

Tên miền sắp đến hạn gia hạn

Dùng dna liệt kê các tên miền của tôi sẽ hết hạn trong 60 ngày tới kèm giá gia hạn, sắp xếp theo ngày hết hạn. Không gia hạn gì cả.
domain list · domain renew-checkread

Trỏ tên miền về máy chủ

Dùng dna trỏ example.com về 203.0.113.10: thêm bản ghi A cho `@` và `www`, sau đó cho tôi xem vùng DNS cuối cùng. Hỏi tôi trước khi thay đổi hoặc xóa bất kỳ bản ghi hiện có nào.
dns add · dns listwrite

Chuyển tên miền về tài khoản

Dùng dna kiểm tra xem example.org có thể chuyển về tài khoản của tôi không, cho tôi biết tôi còn thiếu gì (mã chuyển tên miền, gỡ khóa) và xem trước việc chuyển bằng `--dry-run`.
domain transfer-check · domain transferbillable

Đặt mua chứng chỉ SSL

Dùng dna tìm chứng chỉ DV SSL rẻ nhất cho example.com, tạo CSR và xem trước đơn hàng. Chờ tôi phê duyệt trước khi mua.
product ssls · ssl generate-csr · ssl initializebillable

Cứ nói bạn cần gì. Agent sẽ tìm đúng lệnh.

Mỗi thao tác API là một công cụ có mô tả rõ ràng và JSON Schema, nên trợ lý AI chọn đúng lệnh gọi và điền đúng tham số ngay từ lần đầu. Bạn chỉ cần nói, dna làm chính xác phần việc.

Chốt an toàn

Agent không thể tiêu một xu nào nếu bạn không đồng ý

Mỗi lệnh có một cấp độ an toàn, và cấp độ đó quyết định điều gì xảy ra. Xem thông tin và các thay đổi miễn phí, hoàn tác được sẽ chạy ngay. Mọi thao tác trừ vào số dư hoặc không thể hoàn tác đều dừng lại và hỏi bạn trước.

  • read

    Đọc

    Tìm kiếm, liệt kê, thông tin tên miền, giá và quy tắc đuôi tên miền.

    Chạy ngay
  • write

    Ghi

    Bản ghi DNS, khóa chuyển, bảo mật WHOIS và liên hệ. Miễn phí và hoàn tác được.

    Chạy ngay
  • destructive

    Phá hủy

    Xóa bản ghi, thu hồi SSL, tắt DNSSEC.

    Chờ bạn đồng ý
  • billable

    Tính phí

    Đơn đăng ký, gia hạn, chuyển, khôi phục, SSL và hosting.

    Chờ bạn đồng ý

Cơ chế đồng ý hoạt động thế nào

Các công cụ cần xác nhận có thêm trường confirm. Hầu hết MCP client cũng hỏi bạn trước mỗi lệnh gọi công cụ; các chú thích an toàn giúp chúng đánh dấu những lệnh gọi rủi ro.

  1. Agent hỏi trước

    Nó gọi công cụ mà không có confirm. Không có gì được gửi đi. Nó nhận lại bản xem trước của chính xác yêu cầu đó.

  2. Bạn quyết định

    Agent cho bạn xem tên miền, thời hạn và thao tác. Bạn trả lời có hoặc không.

  3. Chạy một lần duy nhất

    Chỉ sau khi bạn đồng ý, nó mới gọi lại với confirm=true. Lệnh gọi tính phí không bao giờ bị gửi lại sau lỗi mạng.

Quyết định agent được phép đi xa đến đâu

--env ote
Môi trường thử nghiệm: API thật, không tốn tiền thật
--read-only
Chỉ xem, không động vào. Mọi thay đổi đều bị chặn.
--no-billable
Mọi thứ trừ mua hàng
--groups domain,dns
Chỉ các nhóm lệnh bạn liệt kê
--dry-run
In chính xác yêu cầu HTTP, với khóa API được che đi
Bắt đầu

Bốn bước từ prompt đến tên miền đầu tiên, hoàn toàn trong môi trường thử nghiệm

OTE là môi trường thử nghiệm của chúng tôi: cùng một API, với khóa API riêng và số dư riêng. Hãy luyện tập ở đó, rồi chuyển sang môi trường thật chỉ bằng một flag.

  1. Sao chép một prompt

    Chọn Claude Code, ChatGPT Codex hoặc chat thông thường ở đầu trang này rồi sao chép prompt.

  2. Dán vào trợ lý của bạn

    Trợ lý sẽ cài đặt dna, thêm máy chủ MCP và chạy dna doctor để kiểm tra thiết lập.

    dna doctor
  3. Tự đăng nhập vào OTE

    Chạy lệnh đăng nhập trong terminal của chính bạn và nhập Reseller ID cùng khóa API OTE ngay tại đó, tuyệt đối không nhập vào chat.

    dna auth login --env ote
  4. Yêu cầu bằng lời thường

    Tìm kiếm, xem trước bằng --dry-run, đăng ký. Mọi thao tác trừ vào số dư thử nghiệm đều chờ bạn đồng ý.

    --dry-run
Thiết lập thủ công

Thích dùng terminal hơn? Hai lệnh là kết nối xong

Cài đặt file thực thi, rồi thêm dna mcp serve vào MCP client của bạn. Mỗi thao tác API sẽ trở thành một công cụ cho Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI hoặc Gemini CLI.

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

Một file thực thi duy nhất, không phụ thuộc gì thêm. Mỗi bản phát hành đều kèm checksum SHA-256.

  • Mỗi thao tác API là một công cụ, mỗi công cụ có JSON Schema được tạo từ đặc tả API
  • dna_context cho mô hình biết đang ở môi trường thật hay môi trường thử nghiệm trước khi đụng vào bất cứ thứ gì
  • Chỉ mở những gì bạn cần với --groups hoặc --read-only. Danh sách công cụ ngắn hơn cũng giúp tiết kiệm token ngữ cảnh.
  • Agent chỉ có shell nhận được skill Claude Code và hướng dẫn sử dụng chỉ với một lệnh gọi
# kết nối môi trường thử nghiệm trước
$ claude mcp add dna -- dna mcp serve --env ote

# chỉ đọc, chia sẻ với nhóm qua .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

Chạy dna mcp config để in sẵn đoạn cấu hình cho từng client.

Phạm vi

Đủ cả 64 thao tác API, nhóm theo cách bạn nghĩ

Việc gì API đại lý làm được, dna cũng làm được. --help của mỗi lệnh hiển thị cấp độ an toàn, đường dẫn API và ví dụ.

  • dna domain

    Tìm kiếm đơn lẻ và hàng loạt, đăng ký, gia hạn, chuyển và khôi phục. Khóa chuyển, bảo mật WHOIS, mã chuyển tên miền (auth code), nameserver, child host và chuyển tiếp.

  • dna dns · dna dnssec

    Bản ghi vùng trên nameserver của nền tảng và bản ghi DS tại registry.

  • dna ssl

    Tạo CSR, mua, cấu hình, kiểm tra trạng thái, tải xuống, cấp lại và thu hồi chứng chỉ.

  • dna hosting

    Plan và gói hosting, đơn hàng mới và trạng thái của chúng.

  • dna contact

    Hồ sơ liên hệ dùng lại được, kèm xác minh email và số điện thoại.

  • dna account · product · order

    Số dư và giao dịch, danh mục đuôi tên miền kèm giá, và trạng thái đơn hàng.

  • dna api

    Một yêu cầu thô đã xác thực tới bất kỳ endpoint nào, với cùng các quy tắc an toàn.

  • dna schema · enums · agent

    Mô tả máy đọc được cho mọi thao tác, đầu vào và giá trị mã hóa, dành cho agent và người xây dựng công cụ.

Xem toàn bộ tài liệu tham khảo lệnh

Script và CI

Sinh ra cho pipe, cron job và pipeline

Trong terminal, bạn nhận bảng dễ đọc. Qua pipe, bạn nhận JSON. Lỗi cũng là JSON, với mã thoát không bao giờ đổi nghĩa, nên script luôn biết điều gì đã sai.

  • JSON khi chạy qua pipe, JSON Lines cho luồng dữ liệu và --jq tích hợp sẵn để giữ đầu ra gọn nhẹ
  • Thông tin xác thực lấy từ DNA_RESELLER_ID và DNA_API_KEY trong CI, từ một profile trên máy của bạn
  • Không có lời nhắc ẩn ngoài terminal: lệnh cần xác nhận thoát với mã 9 và không gửi gì đi
  • Đầu vào được kiểm tra trước khi gửi, và các yêu cầu bị giới hạn tốc độ được tự động thử lại
# tên miền hết hạn trong 30 ngày tới, dạng CSV
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# kiểm tra nhiều tên cùng lúc
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# trong script, giao dịch mua không có --yes dừng tại đây
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
Mã thoát
0thành công6bị giới hạn tốc độ
2đầu vào không hợp lệ, chưa gửi gì7lỗi máy chủ
3xác thực8mạng
4không tìm thấy9cần xác nhận
5API từ chối10chế độ chỉ đọc
Chọn công cụ

CLI, SDK, REST API hay module có sẵn?

Tất cả đều kết nối với cùng một API đại lý bằng cùng thông tin xác thực. Hãy chọn cái phù hợp với nơi công việc diễn ra.

Câu hỏi thường gặp

Những điều mọi người hỏi trước khi kết nối agent

Câu trả lời ngắn gọn, thẳng thắn. README trên GitHub có đầy đủ mọi chi tiết.

Đọc toàn bộ tài liệu
Domain Name API CLI là gì?

dna là client dòng lệnh và máy chủ MCP chính thức cho nền tảng đại lý Domain Name API. Nó bao quát toàn bộ 64 thao tác của REST API dành cho đại lý, từ tìm kiếm, đăng ký, gia hạn và chuyển tên miền đến DNS, DNSSEC, liên hệ, SSL và hosting, trong một file thực thi mã nguồn mở duy nhất cho macOS, Linux và Windows, theo giấy phép Apache-2.0.

Để AI agent đăng ký tên miền có an toàn không?

Có, vì agent không thể tự mua bất cứ thứ gì. Các thao tác tính phí và phá hủy trả về bản xem trước thay vì chạy. Chúng chỉ chạy sau khi bạn phê duyệt và lệnh gọi mang confirm=true, hoặc --yes trong CLI. Hãy cho agent bắt đầu trên môi trường thử nghiệm OTE và thu hẹp phạm vi thêm bằng --read-only hoặc --no-billable.

Tôi có thể dùng thử mà không tốn tiền không?

Có. Với --env ote, dna kết nối tới OTE, môi trường thử nghiệm của chúng tôi. OTE có khóa API riêng và số dư riêng, và mọi thao tác bạn làm ở đó không ảnh hưởng đến tên miền đang hoạt động hay tài khoản thật của bạn.

Những trợ lý AI nào dùng được với dna?

Mọi MCP client: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI và các client khác. Agent chỉ có shell có thể gọi CLI trực tiếp; dna agent guide và skill Claude Code sẽ hướng dẫn chúng cách dùng.

Tôi có cần tài khoản Domain Name API không?

Có. dna hoạt động với tài khoản đại lý và thông tin xác thực API của tài khoản đó: Reseller ID và một khóa API, cả hai đều nằm trong mục Cài đặt API của bảng điều khiển đại lý. Môi trường thật và OTE dùng khóa khác nhau, và email cùng mật khẩu đăng nhập bảng điều khiển không dùng được ở đây.

dna có miễn phí không?

Có. Công cụ này miễn phí và là mã nguồn mở theo giấy phép Apache-2.0. Bạn chỉ trả tiền cho những gì mua qua nó, như tên miền, gia hạn, SSL và hosting, theo giá đại lý của bạn và trừ từ số dư tài khoản.

Thông tin xác thực của tôi được lưu ở đâu?

dna auth login lưu chúng vào một file profile trong thư mục cấu hình người dùng, trên Linux và macOS chỉ bạn mới đọc được; dna config path cho biết vị trí. Biến môi trường luôn được ưu tiên, và khóa API được che trong mọi đầu ra, kể cả --dry-run.

Tôi có thể dùng dna trong script và CI không?

Có. Đầu ra là JSON khi chạy qua pipe, lỗi là JSON với mã thoát ổn định, và không có lời nhắc nào ngoài terminal tương tác. Truyền thông tin xác thực qua DNA_RESELLER_ID và DNA_API_KEY. Lệnh tính phí không có --yes sẽ thoát với mã 9 và không gửi gì đi.

Tôi nên dùng CLI hay SDK?

Dùng dna khi người, script hoặc AI agent làm việc. Dùng SDK cho PHP, Node.js, Python, Ruby hoặc Go, hoặc chính REST API, khi bạn tích hợp tính năng tên miền vào ứng dụng của riêng mình. Tất cả đều dùng cùng một API và cùng thông tin xác thực.

Tôi có bắt buộc phải dùng terminal không?

Không. Dán một prompt có sẵn vào Claude Code (vốn cũng chạy được trong ứng dụng Claude trên máy tính) hoặc vào ChatGPT Codex, trợ lý sẽ cài đặt và kết nối dna cho bạn. Lệnh duy nhất bạn tự gõ là dna auth login, nên khóa API của bạn không bao giờ lọt vào chat. Nếu hoàn toàn không có terminal, prompt dành cho chat sẽ hướng dẫn bạn qua từng bước.