Warpweb

warpweb-mcp

适用于 Warpweb API 的官方 MCP 服务 — 可通过任何兼容 MCP 的客户端（Claude Desktop、Claude Code、Cline、Cursor 等）研究、构建并部署 AI 生成的网站。

You:    "Build a website for Brookside Plumbing in Austin TX, contact [email protected]."

Claude: I'll use the warpweb create_site tool.
        [tool call → siteId returned, build started]
        Site queued. Real builds take 3-8 minutes. I'll poll status...
        [tool call → get_site]
        ...complete. Live at https://brookside-plumbing-a1b2c3.warpweb.app

一次 POST → 研究 → 构建 → 部署。Warpweb 会获取 Google Places 数据（营业时间、照片、评价、服务区域），撰写符合行业特点的文案，生成设计，构建多页网站，添加 SEO 内容（元标签、站点地图、Schema.org JSON-LD），并部署到免费的 *.warpweb.app 子域名。最适合以服务为主的本地商家（技工、诊所、沙龙、代理机构、餐厅、房地产）。

---

快速入门

1. 获取 API 密钥

在 warpweb.ai 注册，然后前往 warpweb.ai/app 创建密钥。密钥格式为 wwk_...。注册后可获得 520 个免费额度 — 足以完成一次高质量构建和几次修改，无需绑定银行卡。

2. 添加到 MCP 客户端

Claude Desktop — 编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "warpweb": {
      "command": "npx",
      "args": ["-y", "warpweb-mcp"],
      "env": {
        "WARPWEB_API_KEY": "wwk_your_key_here"
      }
    }
  }
}

Claude Code — 通过 MCP UI 或 claude mcp add 添加：

claude mcp add warpweb npx -y warpweb-mcp --env WARPWEB_API_KEY=wwk_your_key_here

Cline / Cursor / 其他客户端 — 配置方式相同：命令为 npx，参数为 ["-y", "warpweb-mcp"]，环境变量为 WARPWEB_API_KEY。任何支持 MCP stdio 的客户端都可以使用。

3. 重启客户端并尝试输入提示词

"Build a website for Acme Plumbing in Austin TX, contact [email protected].
Emphasize 24/7 emergency service."

客户端会从工具列表中选择 create_site，启动构建，并持续轮询，直到部署 URL 可用。

---

提供的工具

共十个工具，与 Warpweb V1 REST API 一一对应。完整的请求和响应格式请参阅 docs.warpweb.ai。

商家

• search_businesses — 构建网站前，通过 Google Places 消除商家名称歧义。只要用户仅提供名称（“Acme Plumbing”），就应先调用此工具；如果直接调用 create_site，常见名称可能会静默匹配到错误商家。最多返回 5 个候选结果，包含 placeId、地址、电话和评分 — 将选定的 placeId 传给 create_site 即可精确匹配。免费。

网站

• create_site — 启动端到端构建。立即返回 siteId；实际构建需要 3–8 分钟。轮询 get_site，或订阅 site.complete 生命周期 webhook。
• get_site — 获取某个网站的当前状态。当 status 为 generating 时，可用此工具轮询构建进度（每 2–5 秒一次）。
• list_sites — 列出账户中的所有网站。
• refresh_site — 重置免费子域名网站的不活跃计时器（7 天后自动暂停）。幂等且免费。

修改

• create_revision — 通过对话修改已部署的网站。发送普通英文提示词；Warpweb 会自动处理小幅精准修改或完整结构调整。异步执行，返回 revisionId。

域名

• check_domain — 检查候选域名是否可用及其价格。免费，并会返回几个相关建议。
• register_domain — 通过 Cloudflare Registrar 购买域名并将其关联到网站。必须先调用 check_domain；price 字段必须与该工具返回的美分价格一致。
• attach_domain — 用于已在其他地方注册、归客户所有的域名。返回需要在客户现有注册商处设置的 CNAME 目标。

Webhook

• configure_form_webhook — 将网站上的表单提交发送到你的 HTTP(S) 端点。每次发送均使用 HMAC-SHA256 签名；首次配置或轮换时，签名密钥只会返回一次 — 请立即保存。

LLM 会在运行时通过 MCP 获取完整的输入架构（必填/可选字段、类型、说明）— 无需记忆参数。

---

示例提示词

• “为 [Business Name] 在 [City, State] 构建一个网站，所有者邮箱为 [email]。”
• “检查 <domain> 是否可用，以及价格是多少。”
• “在网站 <siteId> 上，将标题改为提及免费报价，并添加一个关于紧急服务的常见问题解答。”
• “将域名 acmeplumbing.com 关联到网站 <siteId> — 客户已在 GoDaddy 拥有该域名。”
• “将网站 <siteId> 上的表单提交配置为 POST 到 https://my-crm.example.com/leads。”

---

定价

• 注册即赠送 520 点额度（需验证邮箱）。
• 额度包，通过 Stripe Checkout 一次性购买：
  • Starter — $5 购买 100 点额度
  • Builder — $25 购买 600 点额度（批量购买优惠 16%）
  • Pro — $100 购买 2,800 点额度（批量购买优惠 29%）
• 活跃站点订阅 — 每个站点每月 $10，仅适用于已绑定自定义域名的站点。使用免费子域名的站点无需支付月费。

每次调用的大致额度成本：

工具	成本
create_site	约 200–500 点额度（构建完成后按实际 AI 用量计费）
create_revision	约 20–100 点额度
attach_domain	5 点额度
register_domain	50 点额度 + 注册商转收费
search_businesses、check_domain、get_site、list_sites、refresh_site、configure_form_webhook	免费

---

故障排除

Check WARPWEB_API_KEY env var（401） 客户端配置中的密钥缺失、格式错误或已撤销。请前往 warpweb.ai/app 创建新密钥。密钥以 wwk_ 开头。

Add credits at warpweb.ai/app/credits（402） 账户余额为 0，且自动充值已关闭。请充值或在控制面板中启用自动充值。

Daily quota exceeded（429） 为防止循环调用失控，每天的站点、修订和域名数量均有限制。错误消息中包含配额对象，其中有 used、limit 和 resetDescription。

queue_full: true（修订时返回 429） 每个站点的修订队列深度为 3（1 个运行中 + 2 个等待中）。请等待当前修订完成后再排入更多修订。

客户端连接时工具列表为空 客户端配置的 env 块中未设置 WARPWEB_API_KEY。服务会以无工具模式启动，因此连接仍可完成——请设置环境变量并重启客户端。

想要针对暂存环境进行测试？ 将 WARPWEB_API_URL 设置为其他基础 URL（默认为 https://api.warpweb.ai/v1）。

---

不适合使用 Warpweb 的情况

• 你的企业没有 Google Places 商家信息。Warpweb 仍可使用，但生成结果会显得更通用——研究内容将改用你的 businessDescription。其针对本地服务型企业进行了优化（手工业、诊所、沙龙、代理机构、餐厅、房地产）。
• 你想要像素级精准控制的手写模板。Warpweb 会生成布局；它不接受 Figma 规范作为输入。要实现这一点，请自行使用 Next.js / Astro。
• 你需要拖放式构建器 UI。Warpweb 仅提供 API。
• 不会更新的静态个人网站。单独使用 Cloudflare Pages 更便宜。

---

链接

• API 参考文档：docs.warpweb.ai
• 营销与注册：warpweb.ai
• API 密钥管理：warpweb.ai/app
• 仓库：github.com/northbeamsoftware/warpweb-mcp
• 机器可读参考文档（供 LLM Agent 使用）：warpweb.ai/llms-full.txt

许可证

MIT — 详见 LICENSE。

贡献

欢迎在 github.com/northbeamsoftware/warpweb-mcp 提交问题和 PR。新工具应与公开的 V1 端点一一对应；不要暴露 Warpweb 的内部概念。