Cloudflare API 运维

问题：CLI 与 MCP 在复杂运维场景下的力不从心

当你需要对一个 Cloudflare 账户下几十个区域执行批量 DNS 修改，或者同步跨区的安全策略时，wrangler 和 MCP 工具往往显得笨拙：一次只能操作一条记录、需要反复手动确认、跨区设置必须逐个调用。这些工具面向的是单点部署和交互式开发，而不是大规模、脚本化的运维任务。

核心能力：直接调用 REST API 的自动化引擎

本技能通过 Cloudflare REST API 填补这一空白，让你在 wrangler 或 MCP 不合适时，拥有更底层、更灵活的控制力。它能完成以下任务：

• 批量 DNS 管理：从 CSV 文件读取记录循环创建，按旧 IP 批量 PATCH 更新，支持限速（约 1200 请求/5 分钟）和全量备份。
• 自定义主机名与邮件路由：直接创建白标主机名（配置 http/dv SSL 方法与 TLS 版本），搭建邮件转发规则（matchers + actions）和 catch-all。
• WAF 与重定向规则：绕过 MCP 的冗长流程，批量创建 WAF 规则和重定向规则。
• 缓存清除与资源操作：按标签或前缀清除缓存，批量读写 R2/KV，调用 Vectorize 和 Queues 的直连端点。
• D1 跨库查询与导出：通过 POST query 执行 SQL（使用 params 防注入），异步导出全库 SQL dump 并轮询书签。

关键步骤分为三步：首先在 Cloudflare Dashboard 创建最小权限的 API Token（如 Edit zone DNS），然后按照 references/template.md 中的请求模板调用对应端点（基址为 https://api.cloudflare.com/client/v4/accounts/{account_id}/...），最后处理速率限制和跨区一致性问题。

适用边界与注意点

本技能适用于需要脚本化、批量化、跨区操作的场景，但不适用于单条记录的交互式编辑。使用时务必：

• 将 API Token 存储在环境变量或配置文件中，切勿硬编码。
• 遵守每个区域的请求限制，批量操作时加入适当延迟。
• 对于 D1 查询，确保单条 SQL 不超过 100KB，绑定参数不超过 1000 个。
• 导出操作为异步任务，需通过书签轮询获取结果。

当 wrangler 或 MCP 的“单点思维”成为阻碍时，REST API 才是批量运维的真正答案。