# 域名注册与续费

> 域名注册、续费、转入与 DNS 托管服务。覆盖 1438 个顶级域与 8509 个多级后缀。
> 本文件面向 AI 助手与 agent，说明本站**能做什么、怎么调**。

## 给 AI 助手的要点

- **可以直接调用**：下面列出的只读能力**免费、无需确认**，可以随时调。
- **不能直接调用**：注册 / 续费 / 转移等花钱或不可逆的动作共 300 个，
  一律需要**带外确认**（客户在另一条通道上确认），agent 无法单独完成。这是刻意的。
- **不要替客户改标识符**：域名、身份证号、统一社会信用代码、手机号**原样透传**。
  校验位由后端计算；补出来的号码看起来永远合理，但查不出来是假的。
- **状态是多态的**：查询结果里的"暂时查不到"**不等于**"可以注册"，也不等于"已被注册"。
  不要把它折叠成能买/不能买两种。

## MCP 接口

- 端点：https://example.invalid/mcp
- 协议：Model Context Protocol
- 暴露动作：5 个（全部只读、免费）

## 免费能力清单

### domain.check
- 花费：none　确认：none　幂等：是
- 查询一个或多个域名在指定供应商处是否可注册，并返回该供应商的报价。⚠️ 这是**供应商口径**（它卖不卖、多少钱）；域名在注册局层面到底注册了没有，以 domain.registry.lookup 的 RDAP/WHOIS 结果为准，两者可能不一致。

### domain.info
- 花费：none　确认：none　幂等：是
- 取单个域名的到期时间、状态、NS、锁状态、隐私保护、联系人 id。⚠️ 域名不在本账户下时返回 not_found —— **该错误不可重试**，且不能据此判定"域名已转出"（有的供应商对"不存在"和"不属于你"返回同一个错）。

### domain.ns.get
- 花费：none　确认：none　幂等：是
- 读取域名当前的名称服务器（NS）设置，返回供应商侧记录的 NS 列表。⚠️ 这是**供应商侧的记录**，不等于注册局的实际委派 —— 两者可能不一致（改过 NS 但还没生效、或在别处改过）。要判断"NS 到底切没切过去"，用 dns.delegation.status 去问权威，不要拿这个字段当结论。

### dns.rrset.list
- 花费：none　确认：none　幂等：是
- 读取域名在该供应商 DNS 上的全部解析记录。

### job.get
- 花费：none　确认：none　幂等：是
- 查询一笔异步操作（注册/转入/续费/赎回）的进度，返回 pending / success / failed。⚠️ pending 不是失败，不要重发原请求 —— 重发花钱的操作是灾难。

## 需要带外确认的能力（不通过 MCP 直接执行）

注册域名、续费、转入、转出、修改 DNS、设置域名密码等。
这类动作的流程是：agent 发起 → 客户在带外通道确认 → 凭确认票执行。

## 后缀与材料要求

- **常规后缀**（.com/.net/.org 等）：国际模板，拉丁字母姓名与地址、邮箱、电话。
- **国内后缀**（.cn/.中国/.公司/.网络 及二级 cn）：需实名模板 ——
  中文姓名、中文省市**县**、中文详细地址、证件类型与号码。
  省份、城市、座机区号需按 GB/T 2260-2007 行政区划代码填写。
- **地区后缀**（.hk/.com.hk）：国际模板 + 香港专用证件类型与号码。
- **境外证件注册人**：需额外提供境外证件类型与号码，且**不能用于注册 .cn 类后缀**
  （注册局会直接拦截）。

## 联系

站点：https://example.invalid