新 · v1.0 · 开源

为 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`。

复制一条提示词,粘贴到您的 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 客户端在每次调用工具前也会先询问您;安全标注能帮助它们标出有风险的调用。

  1. 智能体先询问

    它不带 confirm 调用工具。不会发送任何内容,返回的是确切请求的预览。

  2. 由您决定

    智能体向您展示域名、期限和操作。您来回答是或否。

  3. 只执行一次

    只有在您同意之后,它才会带上 confirm=true 再次调用。计费调用在网络错误后绝不会重发。

决定它能触及的范围

--env ote
测试环境:真实的 API,不花真钱
--read-only
只看不动,所有变更都会被拦下
--no-billable
除购买以外的一切
--groups domain,dns
只开放您列出的命令组
--dry-run
打印确切的 HTTP 请求,API 密钥已打码
快速上手

从提示词到第一个域名只需四步,全程在测试环境中

OTE 是我们的测试环境:同一套 API,配有独立的 API 密钥和独立的余额。先在那里练手,然后用一个参数切换到生产环境。

  1. 复制一条提示词

    在本页顶部选择 Claude Code、ChatGPT Codex 或普通聊天,然后复制提示词。

  2. 粘贴给您的助手

    助手会安装 dna、添加 MCP 服务器,并运行 dna doctor 检查配置。

    dna doctor
  3. 亲自登录 OTE

    在您自己的终端中运行登录命令,并在那里输入经销商 ID 和 OTE API 密钥,切勿输入到聊天中。

    dna auth login --env ote
  4. 用自然语言提出需求

    查询,用 --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 | sh

单个二进制文件,没有任何依赖。每个版本都附带 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

运行 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

    每个操作、输入和编码值的机器可读描述,供智能体和工具开发者使用。

查看完整的命令参考

脚本与 CI

为管道、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。根据工作发生的地方来选择即可。

常见问题

接入智能体之前,大家常问的问题

简短、直接的回答。所有细节都在 GitHub 上的 README 中。

阅读完整文档
什么是 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 密钥永远不会进入聊天。如果完全没有终端,聊天提示词会一步一步带您完成全部操作。