共计 4274 个字符，预计需要花费 11 分钟才能阅读完成。
最近 [[Cloudflare]] 悄悄发布了一个让人眼前一亮的新功能——Registrar API。说实话，这个功能出来之前，注册域名这件事虽然不复杂，但每次都得打开浏览器、手动搜索、一步一步点表单，对于开发者来说多少有些重复劳动。现在有了 API，整个流程可以完全程序化，更重要的是，可以直接接入 AI 智能体，让你的 Claude 或者 GPT 帮你完成域名搜索和注册的全流程。
Cloudflare Registrar API 是什么
[[Cloudflare]] 在此之前就有自己的域名注册服务 Cloudflare Registrar，主打的优势是以成本价注册域名，不加价、无附加费用。这次推出的 Registrar API 是在这个基础上，提供了一套 RESTful 接口，让开发者可以通过代码完成整个域名注册流程。
这个 API 目前处于 Beta 阶段，官方文档中明确说明了三个核心功能：搜索候选域名、检查实时可用性和价格、以及直接注册域名。API 的另一个亮点是它已经被默认集成到了 Cloudflare MCP（Model Context Protocol）服务器中，这意味着只要你给 AI 智能体连接了 Cloudflare MCP，它就可以开箱即用地执行这些域名操作，无需额外的集成工作。
前期准备
在调用任何 API 之前，有几个前提条件需要准备好，缺一不可。
首先需要一个 Cloudflare 账户 ID。登录 Cloudflare 控制台后，在首页右侧的"添加"按钮旁边点击"…"，就能看到"复制账户 ID"的选项，复制下来备用。
其次是创建一个专用的 API Token。点击控制台左下角"管理账户"→"账户 API 令牌"→"创建令牌"，选择自定义令牌，然后在权限组里选择 DNS & ZONES 以及 Registrar Domains，并勾选读取和编辑权限。这里有一点强烈建议：不要使用全局 API Key，专门创建一个只有域名注册权限的 Token。万一 Token 泄露，影响范围也仅限于 Registrar 操作，不会危及账户下的其他服务。Token 只会显示一次，创建后务必立即保存到安全的地方，比如密码管理器。
最后还需要在账户里绑定默认付款方式，并配置好默认注册人联系信息。如果之前从没有在 Cloudflare 注册过域名，这两步需要提前完成，否则到注册步骤时会报错。
配置好环境变量后，所有后续请求都能直接复用：
export ACCOUNT_ID="你的账户ID"
export CLOUDFLARE_API_TOKEN="你创建的API Token"
三步核心工作流
Cloudflare 官方将整个域名注册流程设计为三个递进的步骤，官方也反复强调：搜索用于发现，检查用于确认，注册才是最终操作，这三步不能乱序或跳过。
搜索候选域名
Search 端点接受关键词并返回候选域名列表，数据来自缓存，响应速度快，适合快速生成一批选项。比如搜索 acme corp：
curl --request GET \
--url "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar/domain-search?q=acme%20corp&limit=3" \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
返回结果会包含域名、是否可注册、价格等基础信息。不过 Cloudflare 特别提醒，搜索结果不能作为最终决策依据，因为是缓存数据，可能已经过期。
检查实时可用性和价格
Check 端点直接查询注册局，返回的是当前真实状态，每次请求最多可以传入 20 个域名批量查询：
curl --request POST \
--url "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar/domain-check" \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{"domains": ["acmecorp.dev"]}'
返回的 registrable 字段是 true 才代表当前可以注册。如果是 false，还会附带一个 reason 字段说明原因，常见的有 domain_unavailable（已被注册）、extension_not_supported_via_api（该后缀暂不支持通过 API 注册）等。注册前必须调用这个端点确认，不能跳过。
注册域名
Registration 端点是真正会产生费用的一步，成功注册的域名不支持退款，调用前一定要确认好域名和价格：
curl --request POST \
--url "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar/registrations" \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{"domain_name": "acmecorp.dev"}'
API 默认会等待最多 10 秒，如果注册在这个时间内完成，返回 201 Created；如果还在处理中，返回 202 Accepted，此时需要轮询状态端点，直到 state 变为 succeeded 或 failed。注意，不要因为收到 202 就重复提交注册请求，否则可能触发重复扣费。
接入 AI 智能体
这个 API 真正让我感兴趣的地方在于它对 AI 智能体场景的原生支持。官方文档给出了一些示例 prompt，可以直接发给接入了 Cloudflare MCP 的 AI 智能体：
- "帮我搜索适合一家在科罗拉多州的咖啡馆的域名"
- "找 5 个适合 AI 记账工具的可用 .com 或 .dev 域名"
- "检查 example.com 是否可以注册，告诉我当前价格"
- "帮我注册 example.com"
如果使用 Cloudflare MCP，这些端点已经默认可用，不需要额外配置。如果是自己搭建智能体，把账户 ID 和 API Token 以安全方式暴露给智能体（比如通过环境变量或密钥管理服务，而不是硬编码在 prompt 里），然后把官方文档地址 https://developers.cloudflare.com/registrar/registrar-api/ 发给智能体让它学习接口规范，就可以开始测试了。
官方文档中还有一个细节值得注意：在 AI 智能体的最佳实践部分，Cloudflare 建议智能体在 Search 阶段生成多个候选，在 Check 阶段确认最终选择，遇到 action_required 状态时必须停止自动流程、等待用户决策，不能无声地继续往下执行。这其实是一种内置的安全门控设计，防止智能体在用户不知情的情况下完成注册并扣款。
封装成 Skill 使用
除了直接集成到 AI 智能体工作流，这套 API 非常适合封装成一个可复用的 [[Claude Code]] Skill。Skill 是 Claude Code 的技能扩展机制，可以把一段固定的操作流程定义成一条斜线命令，在任何对话中随时调用。
把 Cloudflare Registrar API 做成 Skill 的好处在于，三步工作流（Search → Check → Report）可以被标准化成一个统一的入口。每次需要查域名，只需要在对话框里输入 /cloudflare-domain acme corp 这样的命令，Skill 就会自动完成搜索、批量检查可用性、按价格排序展示结果，省去了每次手动组织 API 调用的步骤。账户 ID 和 API Token 配置一次就存在 Skill 的环境变量里，不用每次都重新提供。
在 Skill 的设计上，有几个实践经验值得参考：把 Search 和 Check 两步合并成一个操作，用户输入关键词，Skill 先拿搜索结果，再批量 Check 确认可用性，最终只返回 registrable: true 的域名和对应价格，这样输出更干净；注册动作建议单独拎出来，不包含在默认 Skill 流程里，需要用户显式触发，以此作为一道防止误操作的安全门；另外可以在输出里附上直达 Cloudflare 控制台对应域名注册页面的链接，方便用户确认后直接跳转完成操作。这样一个 Skill 用下来，域名调研环节的效率提升是非常明显的。
安全操作建议
域名注册有一点比较特殊：注册成功后不支持退款。这意味着如果因为 API Token 泄露、智能体误操作、或者 prompt 表达不清导致注册了不想要的域名，损失是实实在在的。
基于这一点，我个人的建议是：用 API 做查询，用控制台做注册。Search 和 Check 两个端点可以放心接入智能体，用来快速筛选候选域名、了解价格，非常高效。但最终的注册动作，建议还是让用户自己登录 Cloudflare 控制台手动操作，这样既避免了误操作的风险，也对整个注册流程有更清晰的感知。
如果确实需要让智能体执行注册，建议在注册前加一个明确的确认环节——让智能体在调用 Registration 端点前，先向用户展示域名名称和价格，等到用户明确确认后才继续。同时，为注册用的 API Token 单独设置权限，不要和其他服务共用，这样即使 Token 泄露，影响范围也是可控的。
Beta 阶段的限制
现在这个 API 还在 Beta，有些功能暂时没有：域名续费、域名转入、联系人信息更新都还不支持通过 API 完成；并不是所有 Cloudflare 支持的后缀都已经开放 API 注册，如果检查某个后缀返回 extension_not_supported_via_api，只能先去控制台手动注册；溢价域名（Premium Domains）目前也还不支持通过 API 购买。Cloudflare 表示这些功能会在后续版本中陆续补充，现阶段适合先以查询为主，摸清 API 的行为模式。
最后
Cloudflare Registrar API 是一个方向非常正确的产品——把原本只能在 Web 界面上操作的服务打通成程序化接口，自然地接入 AI 智能体工作流。对于经常需要为项目选域名的开发者来说，这个 API 让"告诉 AI 我想做什么，它帮我找出几个可用的合适域名"这件事变得非常顺畅。当然，真正的价值还需要在日常使用中去挖掘，目前 Beta 阶段的限制也需要留意。如果你已经在使用 Cloudflare 管理域名，可以考虑把这个 API 接入自己的工具链，体验一下程序化管理域名的感觉。
