Korzen
JA
サインイン無料で始める
Bot Protection

AI でセットアップ

Claude Code、Codex、Cursor などのコーディングエージェント向けのプロンプトを 1 つ用意しています。タグとサーバーからの呼び出しを monitor mode で追加し、差分を見せてくれます。

プロジェクトのフォルダーでコーディングエージェントを開き、このプロンプトを貼り付けて、提案された差分を確認してください。ログインしていれば、このページと dashboard のセットアップページにはお客様のサイトキーが入ります。

プロンプト
このプロジェクトに Korzen Bot Protection を追加してください。まず https://korzen.dev/bot-protection/docs/setup.md にあるセットアップガイドを読み、その手順に従ってください。

サイトキー: YOUR_SITE_KEY
API: https://korzen.dev
API key は環境変数 KORZEN_API_KEY に入っています。キーそのものは絶対に書かないでください。

1. 新規登録、ログイン、チェックアウトが始まるすべてのページの <head> にタグを追加してください:
   <script src="https://korzen.dev/v1/tag.js" data-site-key="YOUR_SITE_KEY" async></script>
2. サーバー側で、新規登録のハンドラーがアカウントを作成する前に（このプロジェクトにログインとチェックアウトがあれば、それらの前にも）、ガイドのとおり（ガイドが挙げるヘッダーとともに）POST https://korzen.dev/v1/decide を呼び出してください。タイムアウトは 200 ms です。
3. 応答の "action" フィールドを読み、それに従って処理してください:
   - "allow": 通常どおり続行します。
   - "challenge": 先に追加の確認を求めます。このプロジェクトにすでにある仕組み（CAPTCHA やメールアドレスの確認）を使ってください。そうした仕組みがなければ "allow" として扱います。
   - "block": 処理を中止し、新規登録が失敗したときと同じエラーを、理由を伝えずに表示します。
   呼び出しが失敗した場合、タイムアウトより時間がかかった場合、または 200 以外を返した場合は "allow" として扱ってください。Bot Protection が実際のお客様を止めることは決してあってはなりません（fail-open）。
4. 環境変数のサンプルファイルに KORZEN_API_KEY を値なしで追加してください。
5. ほかには何も変更しないでください。差分と、そのテスト方法を見せてください。

次にすること

  1. 差分を確認します。呼び出しはアカウントが作成される前に置き、エラーになる経路ではすべて訪問者を通す必要があります。
  2. キーを設定します。サーバーを動かす環境の KORZEN_API_KEY に API key を設定します。必要ならセットアップページで作成してください。
  3. monitor mode で deploy します。アカウントは monitor mode で始まるため、概要に数字がたまっていくのを見ている間、誰も止められません。
  4. 最初の判定を確認します。dashboard の判定ページで確認したら、monitor mode と block mode をお読みください。

対応ツール

Claude Code、OpenAI Codex、Cursor、GitHub Copilot、Windsurf、Gemini CLI のほか、Web ページを読んでファイルを編集できるエージェントならどれでも使えます。エージェントが読むガイドはプレーンな Markdown で、/bot-protection/docs/setup.md にあり、サイトの /llms.txt にも載っています。

手作業で導入したい場合は、タグとサーバーからの呼び出しにすべての手順があります。