网站克隆 API：用代码或 AI Agent 克隆网站
一次 API 调用就能发起网站克隆。用 API key 或 OAuth 登录，克隆完成或失败时都会收到带签名的 webhook。
面向应用和 Agent 的网站克隆 API
通过 Clone API，你的应用、脚本或 AI Agent 可以发起网站克隆，并在完成时收到通知——完全不需要浏览器。
用 API key 或 OAuth 登录
- API key：在 Developers 页面创建，作为 Bearer token 发送。
- OAuth 2：应用和 Agent 可以自行注册，并向用户申请授权。发现端点在
/.well-known/oauth-authorization-server。 - 无需粘贴 key：Agent 也可以请你确认一个 6 位数验证码。详见 auth.md。
权限按 scope 拆分——创建克隆请求、读取克隆请求——每个工具只拿到它需要的权限。
发起克隆，然后接收 webhook
POST /api/v1/clone-requests，带上源网址和一个Idempotency-Key，这样重试也不会重复发起克隆。- 用
GET /api/v1/clone-requests/{id}查看进度，或者直接等着。 - 我们会调用你的
callbackUrl，发送clone.ready或clone.failed。每个 webhook 都用 HMAC-SHA256 签名（Standard Webhooks）。如果你的服务器宕机，我们会在大约 14 小时内最多重试六次。
免费测试
预检调用会检查你的 key、请求和 webhook 配置，不扣费。测试运行会走完整个流程——包括真实的签名 webhook——花费 0 credits。
通过 MCP 在 AI Agent 里使用
MCP server 的地址是 /mcp，它把同样的操作作为工具提供给 Claude 等 Agent，让它们自己发起和跟踪克隆。
价格和限制
每次克隆从和网站相同的 credits 余额里扣费，克隆失败会自动退回 credits。每个 API key 每分钟最多 60 次请求。完整参考见 Clone API 指南。
本次一并发布
- 新增测试运行和预检都免费
- 新增提供 MCP server，AI Agent 可以直接克隆网站
- 新增指南支持七种语言
常见问题
Clone API 怎么做身份验证？
在 Developers 页面创建 API key，作为 Bearer token 使用；如果你开发的应用或 Agent 需要代表其他用户操作，就用 OAuth 2。
能不花 credits 测试 API 吗？
可以。预检免费，测试运行也会发送真实的签名 webhook，花费 0 credits。
怎么校验 webhook 签名？
用你的 `whsec_` secret 对 `webhook-id.webhook-timestamp.body` 计算 HMAC-SHA256，做 base64 编码，再与 `webhook-signature` 请求头里的 `v1,` 值比对。用 `webhook-id` 跳过重复投递。
克隆完成时我的服务器宕机了怎么办？
我们会在大约 14 小时内最多重试六次。任何 2xx 响应都算投递成功；重定向不算。
AI Agent 能用 clonesite 吗？
能——通过 `/mcp` 上的 MCP server，或者通过 API，配合 OAuth 或 6 位数确认码流程。
有速率限制吗？
每个 API key 每分钟 60 次请求，超出会返回 429。