Warpweb

warpweb-mcp

Warpweb API の公式 MCP サーバーです。Claude Desktop、Claude Code、Cline、Cursor など、あらゆる MCP 対応クライアントから、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 クレジットが無料で付与されます。カード登録不要で、しっかりしたサイトを 1 つ構築し、数回修正するのに十分な量です。

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 に 1 対 1 で対応する 10 個のツールがあります。リクエストとレスポンスの全形式は docs.warpweb.ai をご覧ください。

ビジネス

• search_businesses — 構築前に、Google Places でビジネス名を照合して候補を絞り込みます。ユーザーが名前だけ（「Acme Plumbing」など）を指定した場合は、必ず最初に呼び出してください。すぐに create_site を呼び出すと、一般的な名前では誤った候補が通知なしに選ばれてしまいます。候補を最大 5 件返し、それぞれに placeId、住所、電話番号、評価が含まれます。正確に照合するには、選んだ placeId を create_site に渡してください。無料です。

サイト

• create_site — 最初から最後まで一貫してサイトの構築を開始します。すぐに siteId を返します。実際の構築には 3～8 分かかります。get_site でポーリングするか、ライフサイクル Webhook の site.complete を購読してください。
• get_site — 1 つのサイトの現在のステータスを取得します。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> の見出しに無料見積もりについて追加し、緊急サービスに関する FAQ を追加してください。"
• "ドメイン acmeplumbing.com をサイト <siteId> に割り当ててください。顧客はすでに GoDaddy でこのドメインを所有しています。"
• "サイト <siteId> のフォーム送信先として https://my-crm.example.com/leads を設定し、POST してください。"

---

料金

• 登録時に520クレジットを無料で付与（メール認証が必要です）。
• クレジットパック、Stripe Checkoutでの一回限りの購入：
  • Starter — 100クレジットで$5
  • Builder — 600クレジットで$25（まとめ買いで16%割引）
  • Pro — 2,800クレジットで$100（まとめ買いで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）
無限ループによる問題を防ぐため、サイト、リビジョン、ドメインには1日あたりの上限があります。エラーメッセージには、used、limit、resetDescriptionを含むクォータオブジェクトが表示されます。

queue_full: true（リビジョンで429）
各サイトのリビジョンキューの深さは3（実行中1件＋待機中2件）です。現在のリビジョンが完了してから、次のリビジョンをキューに追加してください。

クライアント接続時にツール一覧が空になる
クライアント設定のenvブロックにWARPWEB_API_KEYが設定されていません。サーバーはNO-TOOLモードで起動するため、接続自体は完了します。環境変数を設定して、クライアントを再起動してください。

ステージング環境でテストするには？
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エージェント向け）：warpweb.ai/llms-full.txt

ライセンス

MIT — LICENSEを参照してください。

コントリビューション

github.com/northbeamsoftware/warpweb-mcpでIssueやPRを歓迎します。新しいツールは、公開されているV1エンドポイントに1対1で対応させてください。Warpweb内部の概念は公開しないでください。