コードやAIエージェントからWebサイトをクローン
API呼び出し1回でWebサイトのクローンを開始できます。APIキーまたはOAuthで認証し、クローンが完了または失敗すると署名付きWebhookが届きます。
アプリとエージェントのためのWebサイトクローンAPI
Clone APIを使えば、アプリやスクリプト、AIエージェントからWebサイトのクローンを開始し、完了したら通知を受け取れます。ブラウザーは不要です。
APIキーまたはOAuthで認証
- APIキー: Developersページで作成し、Bearerトークンとして送信します。
- OAuth 2: アプリやエージェントが自身を登録し、ユーザーにアクセスを求められます。ディスカバリーは
/.well-known/oauth-authorization-serverにあります。 - キーの貼り付け不要: 代わりに、エージェントが6桁のコードの確認をあなたに求めることもできます。詳しくは auth.md をご覧ください。
アクセス権はスコープ(クローンリクエストの作成、読み取り)に分かれているので、各ツールには必要な権限だけを与えられます。
クローンを開始し、Webhookで結果を受け取る
POST /api/v1/clone-requestsにソースURLとIdempotency-Keyを付けて送信します。再試行しても2つ目のクローンが始まることはありません。- 進捗は
GET /api/v1/clone-requests/{id}で確認できます。待つだけでもかまいません。 - 指定した
callbackUrlにclone.readyまたはclone.failedを送信します。すべてのWebhookはHMAC-SHA256(Standard Webhooks)で署名されています。サーバーがダウンしていた場合は、約14時間のあいだに最大6回再試行します。
無料でテスト
プリフライト呼び出しなら、課金なしでキー、リクエスト、Webhookの設定を確認できます。テスト実行では、実際の署名付きWebhookを含むフロー全体を0クレジットで試せます。
MCPでAIエージェントから使う
MCPサーバー(/mcp)が、Claudeなどのエージェントに同じ操作をツールとして提供します。エージェントは自分でクローンを開始し、進捗を追跡できます。
料金と制限
クローンにはWebサイトと同じ残高のクレジットを使い、失敗したクローンのクレジットは自動で戻ります。APIキーごとに毎分60リクエストまで送信できます。詳しいリファレンスはClone APIガイドをご覧ください。
このリリースに含まれる変更
- 新機能テスト実行とプリフライトチェックは無料
- 新機能AIエージェントが直接サイトをクローンできるMCPサーバー
- 新機能ガイドは7言語に対応
よくある質問
Clone APIの認証方法を教えてください
DevelopersページのAPIキーをBearerトークンとして使います。他のユーザーの代わりに動くアプリやエージェントを作る場合は、OAuth 2を使ってください。
クレジットを使わずにAPIをテストできますか?
はい。プリフライトチェックは無料で、テスト実行では実際の署名付きWebhookが0クレジットで送信されます。
Webhookの署名はどう検証しますか?
`whsec_` シークレットで `webhook-id.webhook-timestamp.body` のHMAC-SHA256を計算してbase64エンコードし、`webhook-signature` ヘッダーの `v1,` の値と比較します。重複の除外には `webhook-id` を使います。
クローン完了時にサーバーがダウンしていたら?
約14時間のあいだに最大6回再試行します。2xxレスポンスは配信済みとみなし、リダイレクトは配信済みとみなしません。
AIエージェントからclonesiteを使えますか?
はい。`/mcp` のMCPサーバー、またはOAuthか6桁コードの確認フローでAPIから利用できます。
レート制限はありますか?
APIキーごとに毎分60リクエストです。超えると429レスポンスが返ります。