Resolução de captcha para
agentes n8n
Um agente que encontra um desafio não tem nada no seu conjunto de ferramentas que consiga respondê-lo, então ele trava ou alucina para contorná-lo. Dê a ele um solucionador como ferramenta e o bloqueio vira só mais uma chamada.
HTTP Request node
Method: POST
URL: https://api.captchano.com/v1/solve?wait=60
Authentication: Header Auth
Name: Authorization
Value: Bearer cn-YOUR_API_KEY
Send Body: JSON
Body:
{
"type": "turnstile",
"sitekey": "{{ $json.sitekey }}",
"url": "{{ $json.pageUrl }}"
}
The node outputs { status, solution: { token, userAgent }, cost } —
pass {{ $json.solution.token }} to the next step.Por que agentes precisam especificamente disso
Um scraper que encontra um desafio falha de forma evidente e você corrige. Um agente falha em silêncio: ele raciocina sobre a página bloqueada, inventa um próximo passo plausível e relata um progresso que nunca fez. A falha é pior porque é silenciosa. Uma ferramenta de resolução tipada transforma um beco sem saída ambíguo em um resultado determinístico a partir do qual o agente pode decidir.
O que a ferramenta retorna
- Um token ou cookie — dependendo do tipo de desafio. Sistemas avaliados por sessão retornam um cookie e o conjunto de headers usado para obtê-lo.
- O user agent usado, para que o agente possa reutilizá-lo no envio.
- O custo da resolução, para que um agente que opera com orçamento possa contabilizá-lo em vez de gastar às cegas.
Mantendo o loop sob controle
Dê ao agente um orçamento de resoluções por execução. Toda resposta informa o seu custo, então um supervisor pode cortar o loop quando o gasto passar de um limite, em vez de descobrir isso na fatura. A $0.00598 por resolução, uma execução típica de agente custa alguns centavos ou menos, mas um loop de novas tentativas sem limite continua sendo um loop sem limite.
Mantenha a chamada da ferramenta bloqueante
Os exemplos chamam ?wait=60, então a ferramenta retorna um token pronto em uma única etapa. Isso importa mais para agentes do que para scripts: uma ferramenta que retorna "ainda resolvendo" obriga o modelo a raciocinar sobre polling, algo que ele faz mal. Se você precisar de um teto maior, aumente wait para até 120 segundos. Os formatos de requisição de cada tipo de desafio estão na referência da API.
Como a resolução se encaixa no n8n
O nó AI Agent do n8n pode chamar uma ferramenta HTTP Request. Aponte-a para o endpoint de resolução e o agente poderá resolver um captcha no meio do workflow.
- 01Adicione um nó AI Agent
Conecte um modelo de chat e memória, como de costume.
- 02Adicione uma ferramenta HTTP Request
Faça POST para a API com ?wait=60 e credenciais Header Auth.
- 03Descreva a ferramenta
Diga ao agente para chamá-la com type, sitekey e url quando uma página mostrar um captcha.
- 04Use o token
O agente passa o token para a ferramenta que envia o formulário.
Colocando o token na página
O agente recebe o token da ferramenta e o passa para o próximo nó ou ferramenta que faz o envio.
Onde as integrações costumam dar errado
Aumente o timeout da ferramenta para acima do valor de wait.
Use as credenciais do n8n para que a chave nunca apareça no prompt nem na exportação do workflow.
Perguntas frequentes sobre captcha no n8n
Existe um community node?
Não, e nenhum é necessário. A ferramenta HTTP Request cobre toda a API.
Posso usar sem um agente?
Sim. Veja o guia de integração com o n8n para um workflow simples com um único nó HTTP Request.
Funciona no n8n cloud?
Sim. É uma requisição HTTPS de saída comum.
Como vejo quanto o agente gastou?
Cada resultado inclui o custo, e o painel lista todas as resoluções.
Guias que ajudam
Pronto para começar?
Comece com um teste grátis de 3 dias e depois pague por resolução bem-sucedida conforme seu tráfego cresce. Não é preciso cartão para o teste.