Korzen
PT
EntrarComece grátis
Bot Protection

Configurar com IA

Um prompt para o Claude Code, Codex, Cursor ou qualquer agente de código: ele adiciona a tag e a chamada do seu servidor, em monitor mode, e mostra o diff.

Abra o seu agente de código na pasta do projeto, cole este prompt e leia o diff que ele propõe. Se você estiver logado, esta página e a página Configuração do painel já trazem a sua site key.

Prompt
Adicione o Korzen Bot Protection a este projeto. Primeiro leia o guia de configuração em https://korzen.dev/bot-protection/docs/setup.md e siga-o.

Site key: YOUR_SITE_KEY
API: https://korzen.dev
A API key está na variável de ambiente KORZEN_API_KEY; nunca coloque a chave no código.

1. Adicione a tag ao <head> de toda página onde começa um cadastro, um login ou um checkout:
   <script src="https://korzen.dev/v1/tag.js" data-site-key="YOUR_SITE_KEY" async></script>
2. No servidor, antes de o handler de cadastro criar a conta (e antes do login e do checkout, se o projeto os tiver), chame POST https://korzen.dev/v1/decide como o guia mostra (com os headers que ele lista), com timeout de 200 ms.
3. Leia o campo "action" da resposta e aja de acordo:
   - "allow": siga normalmente.
   - "challenge": peça mais uma prova antes de seguir, com o que o projeto já tem (um CAPTCHA, ou a verificação do email); se não houver nada assim, trate como "allow".
   - "block": pare, e mostre o mesmo erro de quando um cadastro falha, sem dizer o motivo.
   Se a chamada falhar, passar do timeout ou responder qualquer coisa diferente de 200, trate como "allow": o Bot Protection nunca pode barrar um cliente de verdade (fail open).
4. Adicione KORZEN_API_KEY ao arquivo de exemplo das variáveis de ambiente, sem valor.
5. Não mude mais nada. Mostre o diff e como testar.

Depois

  1. Revise o diff. A chamada precisa vir antes de a conta ser criada, e todo caminho de erro precisa deixar o visitante passar.
  2. Defina a chave. Coloque a sua API key em KORZEN_API_KEY onde o seu servidor roda; crie uma na página Configuração se precisar.
  3. Faça o deploy em monitor mode. A sua conta começa nele: ninguém é parado enquanto você acompanha o painel.
  4. Confira as primeiras decisões na página Decisões do painel, e depois leia Monitor mode e block mode.

Funciona com

Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Windsurf, Gemini CLI e qualquer agente que leia uma página da web e edite arquivos. O guia que ele lê é Markdown simples, em /bot-protection/docs/setup.md, e o site o lista em /llms.txt.

Prefere fazer à mão? A tag e a chamada do seu servidor trazem o passo a passo.