为 AI 智能体打造的域名 CLI 和 MCP 服务器
dna 是 Domain Name API 官方的命令行工具和 MCP 服务器。把现成的提示词复制到 Claude 或 ChatGPT 中,您的助手就会安装并连接 dna,然后着手处理您的域名、DNS、SSL 和主机。任何需要花钱的操作,都会先等待您的同意。
在 Claude Code 中设置 dna
请帮我安装配置 dna CLI (https://github.com/domainreseller/cli)。 1. 使用适合我操作系统的官方安装脚本安装,然后运行 `dna version` 和 `dna doctor`。 2. 用 `dna agent skill --install` 安装 Claude Code 技能,并用 `claude mcp add dna -- dna mcp serve --env ote` 添加 MCP 服务器。 3. 不要要求我把 API 密钥粘贴到这个对话中。提示我自己运行 `dna auth login --env ote`, 然后用 `dna --ote account get` 检查连接。 只在 OTE 测试环境中操作,未经我同意,绝不要使用 `--yes`。
在 ChatGPT Codex 中设置 dna
请帮我安装配置 dna CLI (https://github.com/domainreseller/cli)。 1. 使用适合我操作系统的官方安装脚本安装,然后运行 `dna version` 和 `dna doctor`。 2. 把它作为 MCP 服务器添加到我的 Codex 配置 (`~/.codex/config.toml`) 中:名称为 `dna`, 命令为 `dna`,参数为 `mcp serve --env ote`。 3. 不要要求我把 API 密钥粘贴到这个对话中。提示我自己运行 `dna auth login --env ote`, 然后用 `dna --ote account get` 检查连接。 只在 OTE 测试环境中操作,未经我同意,绝不要使用 `--yes`。
没有终端?在 ChatGPT 或 Claude 聊天中提问
请阅读 https://raw.githubusercontent.com/domainreseller/cli/main/llms.txt 及其中链接的 dna 文档。然后一步一步地给出在 OTE 测试环境中注册域名的确切 dna 命令:安装、登录、查询、 用 `--dry-run` 预览,以及注册。解释每条命令的作用。
复制一条提示词,粘贴到您的 AI 助手中,让它替您完成工作。每条提示词都从 OTE 测试环境开始,并会在任何付费操作之前停下来等待您的确认。
- 64API 操作
- 65MCP 工具
- 4安全类别
- 6平台,同一个二进制文件
- Apache-2.0开源许可证
适用于 Claude 和 ChatGPT 的现成提示词
换上您自己的域名,把提示词粘贴到助手中,看它如何完成工作。每条提示词都写明了该在哪里停下,未经您同意,不会发生任何付费操作。
查询并注册域名
用 dna 检查 brandname.com、brandname.net 和 brandname.io 是否可以注册。用表格列出结果 和价格,然后用 `--dry-run` 预览注册其中最便宜的可注册域名。在我同意之前,什么都不要注 册。
domain bulk-search · domain registerbillable近期续费
用 dna 列出我未来 60 天内到期的域名及其续费价格,按到期日期排序。什么都不要续费。
domain list · domain renew-checkread将域名指向服务器
用 dna 将 example.com 指向 203.0.113.10:为 `@` 和 `www` 添加 A 记录,然后给我看最终的 DNS 区域。修改或删除任何现有记录之前,先问我。
dns add · dns listwrite转入域名
用 dna 检查 example.org 能否转入我的账户,告诉我还缺什么(授权码、解锁),并用 `--dry-run` 预览转入。
domain transfer-check · domain transferbillable订购 SSL 证书
用 dna 为 example.com 找到最便宜的 DV SSL 证书,生成 CSR 并预览订单。购买前等待我的确 认。
product ssls · ssl generate-csr · ssl initializebillable说出您的需求,智能体会找到正确的命令。
每个 API 操作都是一个带有清晰描述和 JSON Schema 的工具,因此助手第一次就能选对调用、填对参数。您只管说,具体的活由 dna 精确完成。
没有您的同意,智能体一分钱也花不了
每条命令都有一个安全类别,由类别决定接下来会发生什么。查看信息以及免费、可撤销的变更会立即执行;任何会从余额扣费或无法撤销的操作,都会先停下来征求您的同意。
- read
读取
查询、列表、域名信息、价格和域名后缀规则。
立即执行 - write
写入
DNS 记录、转移锁、WHOIS 隐私保护和联系人。免费且可撤销。
立即执行 - destructive
破坏性
删除记录、吊销 SSL、关闭 DNSSEC。
等待您的同意 - billable
计费
注册、续费、转移、恢复,以及 SSL 和主机订单。
等待您的同意
确认是如何运作的
受管控的工具多了一个 confirm 字段。大多数 MCP 客户端在每次调用工具前也会先询问您;安全标注能帮助它们标出有风险的调用。
智能体先询问
它不带 confirm 调用工具。不会发送任何内容,返回的是确切请求的预览。
由您决定
智能体向您展示域名、期限和操作。您来回答是或否。
只执行一次
只有在您同意之后,它才会带上 confirm=true 再次调用。计费调用在网络错误后绝不会重发。
决定它能触及的范围
--env ote- 测试环境:真实的 API,不花真钱
--read-only- 只看不动,所有变更都会被拦下
--no-billable- 除购买以外的一切
--groups domain,dns- 只开放您列出的命令组
--dry-run- 打印确切的 HTTP 请求,API 密钥已打码
从提示词到第一个域名只需四步,全程在测试环境中
OTE 是我们的测试环境:同一套 API,配有独立的 API 密钥和独立的余额。先在那里练手,然后用一个参数切换到生产环境。
复制一条提示词
在本页顶部选择 Claude Code、ChatGPT Codex 或普通聊天,然后复制提示词。
粘贴给您的助手
助手会安装 dna、添加 MCP 服务器,并运行 dna doctor 检查配置。
dna doctor亲自登录 OTE
在您自己的终端中运行登录命令,并在那里输入经销商 ID 和 OTE API 密钥,切勿输入到聊天中。
dna auth login --env ote用自然语言提出需求
查询,用 --dry-run 预览,然后注册。任何会从测试余额扣费的操作,都会等待您的同意。
--dry-run
更习惯用终端?两条命令即可连接
先安装二进制文件,再把 dna mcp serve 添加到您的 MCP 客户端。每个 API 操作都会成为 Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Codex CLI 或 Gemini CLI 可用的工具。
$ curl -fsSL https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.sh | shPS> irm https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.ps1 | iex$ go install github.com/domainreseller/cli/cmd/dna@latest单个二进制文件,没有任何依赖。每个版本都附带 SHA-256 校验和。
- 每个 API 操作对应一个工具,每个工具都带有根据 API 规范生成的 JSON Schema
- dna_context 会在模型动手之前告诉它:当前是生产环境还是测试环境
- 用 --groups 或 --read-only 只开放您需要的部分。工具列表越短,也越节省上下文 token。
- 只有 shell 的智能体,一次调用即可获得 Claude Code 技能和使用指南
# 先连接测试环境
$ claude mcp add dna -- dna mcp serve --env ote
# 只读,通过 .mcp.json 与团队共享
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only {
"mcpServers": {
"dna": {
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} {
"servers": {
"dna": {
"type": "stdio",
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} [mcp_servers.dna]
command = "dna"
args = ["mcp", "serve", "--env", "ote"] # Claude Code 技能:~/.claude/skills/dna/SKILL.md
$ dna agent skill --install
# 一份可放进任何智能体指令中的精简指南
$ dna agent guide 运行 dna mcp config,即可为每个客户端输出现成的配置片段。
全部 64 个 API 操作,按您的思路分组
经销商 API 能做的,dna 都能做。每条命令的 --help 都会显示它的安全类别、API 路径和示例。
dna domain
单个和批量查询,注册、续费、转移和恢复。转移锁、WHOIS 隐私保护、转移授权码(auth code)、域名服务器、子域名服务器和转发。
dna dns · dna dnssec
平台域名服务器上的区域记录,以及注册局中的 DS 记录。
dna ssl
生成 CSR、购买、配置、查询状态、下载、重新签发和吊销证书。
dna hosting
主机方案与套餐、新订单及其状态。
dna contact
可复用的联系人记录,以及电子邮件和电话验证。
dna account · product · order
余额和交易记录、带价格的域名后缀目录,以及订单状态。
dna api
向任意端点发送经过认证的原始请求,遵循同样的安全规则。
dna schema · enums · agent
每个操作、输入和编码值的机器可读描述,供智能体和工具开发者使用。
为管道、cron 任务和流水线而生
在终端里,您看到的是易读的表格;在管道中,得到的是 JSON。错误也是 JSON,退出码的含义永不改变,脚本始终知道哪里出了问题。
- 管道输出为 JSON,数据流使用 JSON Lines,内置 --jq 精简输出
- 在 CI 中从 DNA_RESELLER_ID 和 DNA_API_KEY 读取凭据,在您自己的机器上则从配置文件读取
- 终端之外没有隐藏的提示:需确认的命令以代码 9 退出,不发送任何内容
- 发送前先校验输入,遇到速率限制会自动重试
# 未来 30 天内到期的域名,输出为 CSV
$ dna domain list --all \
--jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'
# 一次查询多个名字
$ dna domain bulk-search brand.com brand.net brand.io \
--jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'
# 在脚本中,未带 --yes 的购买会停在这里
$ dna domain renew example.com --period 1
exit 9 confirmation required · nothing sent | 0 | 成功 | 6 | 触发速率限制 |
|---|---|---|---|
| 2 | 输入无效,未发送任何内容 | 7 | 服务器错误 |
| 3 | 认证失败 | 8 | 网络错误 |
| 4 | 未找到 | 9 | 需要确认 |
| 5 | 被 API 拒绝 | 10 | 只读模式 |
CLI、SDK、REST API,还是现成模块?
它们都使用同样的凭据,连接同一个经销商 API。根据工作发生的地方来选择即可。
CLI 与 MCP 服务器
当工作由人、脚本或 AI 智能体来完成时:日常运维、自动化、CI,以及 Claude 或 Cursor 等助手。
SDK
当您要把域名功能构建到自己的应用中时。支持 PHP、Node.js、Python、Ruby 和 Go。
查看 SDKREST API
当您想用任意语言完全掌控每一个请求时。基于 HTTPS 的 JSON,只需两个请求头。
阅读 API 指南计费模块
当您通过 WHMCS、Blesta、HostBill、WiseCP 或 Clientexec 销售,并希望一切自动运行时。
查看集成什么是 Domain Name API CLI?
dna 是 Domain Name API 经销商平台的官方命令行客户端和 MCP 服务器。它覆盖经销商 REST API 的全部 64 个操作,从域名查询、注册、续费和转移,到 DNS、DNSSEC、联系人、SSL 和主机,以单个开源二进制文件的形式提供,支持 macOS、Linux 和 Windows,采用 Apache-2.0 许可证。
让 AI 智能体注册域名安全吗?
安全,因为智能体无法自行购买任何东西。计费和破坏性操作不会直接执行,而是返回一份预览。只有在您批准、且调用带有 confirm=true(在 CLI 中为 --yes)之后,它们才会执行。先让智能体在 OTE 测试环境中运行,再用 --read-only 或 --no-billable 进一步收窄范围。
可以不花钱试用吗?
可以。使用 --env ote 时,dna 连接的是我们的测试环境 OTE。它有独立的 API 密钥和独立的余额,您在那里做的任何操作都不会影响线上域名或您的真实账户。
哪些 AI 助手可以使用 dna?
任何 MCP 客户端都可以:Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、OpenAI Codex CLI、Gemini CLI 等。只有 shell 的智能体可以直接调用 CLI;dna agent guide 和 Claude Code 技能会教它们如何使用。
我需要 Domain Name API 账户吗?
需要。dna 需要配合经销商账户及其 API 凭据使用:您的经销商 ID 和一个 API 密钥,两者都在经销商面板的 API 设置中。生产环境和 OTE 使用不同的密钥,而且面板的电子邮箱和密码在这里不能使用。
dna 免费吗?
免费。该工具免费,并以 Apache-2.0 许可证开源。您只需为通过它购买的内容付费,例如域名、续费、SSL 和主机,按您的经销商价格从账户余额中扣除。
我的凭据存放在哪里?
dna auth login 会把凭据保存在您用户配置文件夹中的一个配置文件里,在 Linux 和 macOS 上只有您本人可以读取;dna config path 会显示它的位置。环境变量始终优先,而且 API 密钥在所有输出中都会被打码,包括 --dry-run。
可以在脚本和 CI 中使用 dna 吗?
可以。通过管道时输出为 JSON,错误也是 JSON 并带有稳定的退出码,在交互式终端之外不会出现任何提示。请通过 DNA_RESELLER_ID 和 DNA_API_KEY 传入凭据。未带 --yes 的计费命令会以代码 9 退出,不发送任何内容。
我该用 CLI 还是 SDK?
当工作由人、脚本或 AI 智能体完成时,使用 dna。当您要把域名功能构建到自己的应用中时,使用 PHP、Node.js、Python、Ruby 或 Go 的 SDK,或者直接使用 REST API。它们都使用同一个 API 和同样的凭据。
必须使用终端吗?
不必。把现成的提示词粘贴到 Claude Code(它也能在 Claude 桌面应用中运行)或 ChatGPT Codex 中,助手就会为您安装并连接 dna。唯一需要您亲自输入的命令是 dna auth login,因此您的 API 密钥永远不会进入聊天。如果完全没有终端,聊天提示词会一步一步带您完成全部操作。

