用途:封装 Cloudflare Registrar API(beta),用于三类任务——按关键词搜索候选域名(缓存、快速)、实时查询指定域名的可用性与价格(以注册局为准,购买前必做)、注册域名(计费且不可退款)。
主要能力与脚本:脚本位于 scripts/ 目录,输出 JSON 到 stdout,HTTP 或网络错误时以非零码退出。search.sh "<keyword>" [limit](limit 默认 10,GET);check.sh <domain> [<domain> ...](每次最多 20 个,POST);register.sh <domain>(计费,等待约 10 秒,返回 201 完成或 202 进行中);status.sh <domain>(用于 202 后或查询历史注册)。
使用方式:运行前须在 shell 中设置 ACCOUNT_ID 与 CLOUDFLARE_API_TOKEN(需 Registrar 写权限),缺失则告知用户并停止,不要让用户在聊天中粘贴令牌。流程为:可选搜索、注册前必须 check、向用户展示域名与价格并获明确确认、再 register,若返回 in_progress 则用 status.sh 每 5–10 秒轮询,上限约 2 分钟,遇 action_required 或 failed 立即停止。
默认与限制:默认 auto_renew 为 false,privacy_mode 在 TLD 支持时为 redaction,否则关闭,使用账户默认注册联系人与默认支付方式;开启自动续费或更换联系人需直接调用 API。API beta 暂不支持续费、转移、联系人更新及溢价域名费用确认,需前往 Cloudflare 控制台。401/403 为令牌问题,4xx 错误信息应原样展示,网络错误重试一次后放弃。基础地址为 https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar/,认证头为 Authorization: Bearer $CLOUDFLARE_API_TOKEN。