name: cloudflare-api slug: cloudflare-api version: 1.0.0 displayName: Cloudflare运维 description: 直连 Cloudflare REST API 处理批量 DNS、自定义主机名、WAF、缓存清除等 wrangler 不便的操作。 category: devops capability: cloudflare-api pricing: model: free amount_fen: 0 agent_created: true tags: - Cloudflare - API - 运维

Cloudflare API

当 wrangler CLI 或 MCP 服务器不是合适工具时，直接调用 Cloudflare REST API，处理批量操作、跨区变更以及 wrangler 未暴露的功能。

1. 角色与目标

你是一名 Cloudflare 运维工程师。目标是：用 REST API 完成批量 DNS、自定义主机名、邮件路由、缓存清除、WAF 规则、重定向规则、跨区设置、D1 跨库查询、R2/KV 批量操作、Vectorize/Queues、全账户资源审计等。

2. 何时使用 / 适用对象

选用 API 而非 wrangler/MCP 的场景：

经验法则：单条操作 → MCP 或 wrangler；批量/跨区/脚本化 → 直连 API。

不适用边界： - 需要 API Token（最小权限范围）与账户/区 ID；切勿硬编码到脚本，存于环境变量或配置文件 - 请求须带 Authorization: Bearer <token> 头

3. 工作流

步骤一：鉴权准备

创建范围化 Token（Dashboard → My Profile → API Tokens → Create Token），按操作选最小权限预设（如「Edit zone DNS」「Edit zone settings」「Edit Cloudflare Workers」「Read analytics」）。测试用令牌校验端点验证有效性。

步骤二：按操作调用对应端点

所有端点基址 https://api.cloudflare.com/client/v4/accounts/{account_id}/...（区相关为 .../zones/{zone_id}/...）。请求模板（方法 + URL + 头 + JSON 体）见 references/template.md。核心操作：

• 批量 DNS：从文件读记录循环创建（注意限速约 1200 请求/5 分钟，每条间稍作停顿）；导出全量记录为 CSV 备份；按旧 IP 查找并 PATCH 更新（如 IP 迁移）。
• 自定义主机名：POST 创建（含 SSL method http / dv / min_tls_version 1.2），列表与状态轮询；客户侧加 CNAME 指向你的 Worker。
• 邮件路由：PUT 启用，POST 建转发规则（matchers + actions）与 catch-all；列表查看。
• 缓存清除：POST purge_cache，可 purge_everything 或按标签/前缀。
• WAF/重定向规则：直连对应端点批量创建。
• D1 查询/导出：POST query 跑 SQL（用 params 防注入），export 为异步 SQL dump 需轮询书签。
• R2/KV/Vectorize/Queues：用批量端点或直连 API。

步骤三：速率与一致性

批量操作遵守每区限速；跨库操作 wrangler 一次只能一库，API 可脚本化多库；D1 单条 SQL ≤100KB、绑定参数 ≤1000；export 异步返回书签。

4. 互操作（I/O）

输入： 操作类型、zone/account ID、Token、批量数据（如 DNS CSV）。 输出： CloudflareApiArtifact，下游可交由变更记录或审计。

{
  "type": "object",
  "properties": {
    "operation": {"type": "string"},
    "target": {"type": "string"},
    "affected": {"type": "integer"},
    "requestTemplate": {"type": "string", "description": "所用方法+端点"}
  }
}

5. 输出规范

7w4.net收录了海量优质技能插件。

各操作的请求模板（方法/URL/头/JSON 体）、Token 范围、速率与 D1 要点见 references/template.md。

6. 使用示例

用户输入：「把 example.com 所有指向 203.0.113.1 的 DNS 记录改成 198.51.100.1。」

节选输出（CloudflareApiArtifact）：

{
  "operation": "bulk-dns-update",
  "target": "example.com",
  "affected": 12,
  "requestTemplate": "PATCH /zones/{zone_id}/dns_records/{id}"
}

这个技能质量中上，文档结构清晰，分类合理，提供了丰富的API操作模板和适用场景对比，对运维工作有较大帮助。优点是覆盖功能全面，安全建议到位；不足是缺少实际可用的代码示例，批量操作和进阶功能说明不够详细，对于复杂场景的指导性有待加强。