Korzen
Bot Protection

Configurar con IA

Un prompt para Claude Code, Codex, Cursor o cualquier agente de código: añade el tag y la llamada desde tu servidor, en monitor mode, y te muestra el diff.

Abre tu agente de código en la carpeta del proyecto, pega este prompt y lee el diff que propone. Con la sesión iniciada, esta página y la página Configuración del panel ya traen tu site key.

Prompt
Añade Korzen Bot Protection a este proyecto. Primero lee la guía de configuración en https://korzen.dev/bot-protection/docs/setup.md y síguela.

Site key: YOUR_SITE_KEY
API: https://korzen.dev
La API key está en la variable de entorno KORZEN_API_KEY; nunca escribas su valor en el código.

1. Añade el tag al <head> de cada página donde empieza un registro, un inicio de sesión o un checkout:
   <script src="https://korzen.dev/v1/tag.js" data-site-key="YOUR_SITE_KEY" async></script>
2. En el servidor, antes de que el handler de registro cree la cuenta (y antes del inicio de sesión y del checkout, si el proyecto los tiene), llama a POST https://korzen.dev/v1/decide como muestra la guía (con los headers que enumera), con un timeout de 200 ms.
3. Lee el campo "action" de la respuesta y actúa en consecuencia:
   - "allow": sigue como siempre.
   - "challenge": pide una prueba más antes de seguir, con lo que el proyecto ya tiene (un CAPTCHA, o verificar el email); si no tiene nada parecido, trátalo como "allow".
   - "block": detente, y muestra el mismo error que muestra un registro fallido, sin decir el motivo.
   Si la llamada falla, supera el timeout o responde algo distinto de 200, trátalo como "allow": Bot Protection nunca debe frenar a un cliente real (fail open).
4. Añade KORZEN_API_KEY al archivo de ejemplo de variables de entorno, sin valor.
5. No cambies nada más. Muéstrame el diff y cómo probarlo.

Después

  1. Revisa el diff. La llamada debe ir antes de crear la cuenta, y cada camino de error debe dejar pasar al visitante.
  2. Define la clave. Pon tu API key en KORZEN_API_KEY donde corre tu servidor; crea una en la página Configuración si la necesitas.
  3. Haz el deploy en monitor mode. Tu cuenta empieza ahí: no se frena a nadie mientras vigilas el panel.
  4. Revisa las primeras decisiones en la página Decisiones del panel, y luego lee Monitor mode y block mode.

Funciona con

Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Windsurf, Gemini CLI y cualquier agente que lea una página web y edite archivos. La guía que lee es Markdown simple, en /bot-protection/docs/setup.md, y aparece en /llms.txt.

¿Prefieres hacerlo a mano? El tag y la llamada desde tu servidor explican cada paso.