コンテンツにスキップ
すべてのアップデート
新機能

コードやAIエージェントからWebサイトをクローン

API呼び出し1回でWebサイトのクローンを開始できます。APIキーまたはOAuthで認証し、クローンが完了または失敗すると署名付きWebhookが届きます。

A robot arm turning a key in a server, looped back to a webhook bell

アプリとエージェントのためのWebサイトクローンAPI

Clone APIを使えば、アプリやスクリプト、AIエージェントからWebサイトのクローンを開始し、完了したら通知を受け取れます。ブラウザーは不要です。

APIキーまたはOAuthで認証

  • APIキー: Developersページで作成し、Bearerトークンとして送信します。
  • OAuth 2: アプリやエージェントが自身を登録し、ユーザーにアクセスを求められます。ディスカバリーは /.well-known/oauth-authorization-server にあります。
  • キーの貼り付け不要: 代わりに、エージェントが6桁のコードの確認をあなたに求めることもできます。詳しくは auth.md をご覧ください。

アクセス権はスコープ(クローンリクエストの作成、読み取り)に分かれているので、各ツールには必要な権限だけを与えられます。

クローンを開始し、Webhookで結果を受け取る

  1. POST /api/v1/clone-requests にソースURLと Idempotency-Key を付けて送信します。再試行しても2つ目のクローンが始まることはありません。
  2. 進捗は GET /api/v1/clone-requests/{id} で確認できます。待つだけでもかまいません。
  3. 指定した 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レスポンスが返ります。