Solucionador de captcha
para agentes de IA
Um agente que encontra um desafio trava em silêncio. Exponha a resolução como ferramenta e o bloqueio vira só mais uma chamada determinística.
Cole isto no seu agente de programação
Claude Code, Cursor, Codex, Copilot ou Windsurf: o prompt pede sua chave de API, adiciona o servidor MCP, integra um helper de resolução ao seu projeto e testa tudo de ponta a ponta.
Configure a CaptchaNo (https://captchano.com) neste projeto para que os captchas não bloqueiem mais a nossa automação de navegador. Leia primeiro o guia de configuração completo e siga-o: https://captchano.com/agents/setup.md Em resumo: 1. Peça-me uma chave de API da CaptchaNo (ela começa com "cn-"; posso criar uma em https://captchano.com/dashboard/keys). Nunca a coloque fixa no código, nem a imprima, registre em log ou faça commit dela. Guarde-a como CAPTCHANO_API_KEY no .env ignorado pelo git ou no cofre de segredos do projeto. 2. Se você tiver suporte a MCP, adicione para você o servidor MCP da CaptchaNo: comando "npx -y captchano-mcp", env CAPTCHANO_API_KEY e CAPTCHANO_MAX_SPEND_USD=1.00 (no Claude Code: claude mcp add captchano -e CAPTCHANO_API_KEY=<key> -e CAPTCHANO_MAX_SPEND_USD=1.00 -- npx -y captchano-mcp). 3. Se este código controla um navegador ou cliente HTTP (Playwright, Puppeteer, Selenium, Scrapy, requests...), adicione um pequeno helper solveCaptcha que chame POST https://api.captchano.com/v1/solve?wait=60 com a chave como bearer, e injete o token retornado da forma mostrada no guia. Reaproveite o cliente HTTP e o estilo que o projeto já usa. 4. Verifique: consulte o saldo (ferramenta get_balance ou GET /v1/balance) e depois faça a verificação de ponta a ponta com uma resolução descrita no guia (ela resolve o reCAPTCHA em https://captchano.com/tools/captcha-demo e confirma que o Google aceita o token). Suportados: reCAPTCHA v2/v3/Enterprise, Cloudflare Turnstile, DataDome (exige o nosso próprio proxy) e captchas de imagem. Resoluções que falham não são cobradas. Automatize apenas sites que são nossos ou que temos permissão para automatizar. Quando terminar, diga-me o que você alterou.
Guia completo que o agente segue: captchano.com/agents/setup.md
Configuração, respostas tipadas e visibilidade do custo por resolução.
Configuração, respostas tipadas e visibilidade do custo por resolução.
Configuração, respostas tipadas e visibilidade do custo por resolução.
Configuração, respostas tipadas e visibilidade do custo por resolução.
Configuração, respostas tipadas e visibilidade do custo por resolução.
Configuração, respostas tipadas e visibilidade do custo por resolução.
Por que agentes travam em captchas
Um script falha de forma evidente quando encontra um desafio. Um agente falha em silêncio, e isso é pior.
Nada no conjunto de ferramentas típico de um agente resolve uma grade de imagens ou um desafio avaliado por sessão, então o agente fica preso na página.
Os modelos inventam um próximo passo plausível e relatam um progresso que nunca fizeram. A falha é silenciosa.
Um agente que fica recarregando uma página com desafio gasta tokens e tempo sem chegar mais perto do objetivo.
Dê ao agente uma ferramenta de resolução
- 01Encapsule a API como ferramenta
Uma função que recebe type, sitekey e URL e chama /v1/solve?wait=60.
- 02Mantenha a chave fora do prompt
Leia a chave do ambiente dentro da ferramenta, para que o modelo nunca a veja.
- 03Retorne um resultado tipado
O token, o user agent usado e o custo, para que o agente possa enviar o formulário e contabilizar o gasto.
- 04Limite o loop
Defina um teto de resoluções ou de gasto por execução para que um agente confuso não fique em loop numa página.
O que a ferramenta retorna
Toda resposta traz o token ou cookie, o user agent com que ele foi gerado e o custo da resolução. O agente pode reutilizar o user agent no envio, e um supervisor pode interromper a execução quando o gasto passar de um limite. Os formatos de requisição de cada tipo de desafio estão na referência da API.
Nenhum SDK necessário
A CaptchaNo é uma API REST simples, então cada guia de framework acima são poucas linhas do seu próprio código, e não um pacote em que você precisa confiar. Isso também significa que a mesma ferramenta funciona em qualquer framework para o qual ainda não escrevemos um guia.
Perguntas frequentes sobre captcha e agentes de IA
Um agente de IA consegue resolver captchas sozinho?
Às vezes ele consegue clicar em uma caixa de seleção, mas não responde de forma confiável a desafios de imagem, e navegadores automatizados recebem esses desafios com mais frequência. Uma ferramenta de resolução transforma o desafio em uma chamada determinística a partir da qual o agente pode decidir o próximo passo.
Quais frameworks de agentes são suportados?
Qualquer framework que consiga chamar uma API HTTP. Temos guias para MCP, LangChain, Browser Use, OpenAI Agents SDK, CrewAI e n8n, e o mesmo padrão funciona em outros.
Existe um servidor MCP da CaptchaNo?
Sim. O captchano-mcp é um servidor MCP de código aberto (MIT) que você executa com npx -y captchano-mcp. Ele lê sua chave de API do ambiente, nunca do modelo, e aceita um teto de gasto opcional. Ele está listado no MCP Registry oficial.
Como evito que um agente gaste demais?
Todo resultado inclui o seu custo. Mantenha um total acumulado na ferramenta ou no contexto da execução e recuse novas resoluções depois de atingir um orçamento.
É permitido deixar agentes resolverem captchas?
Depende do site e da tarefa. Agentes que atuam nas suas próprias contas, testam seus próprios sistemas ou coletam dados que o site permite são os usos previstos. Leia antes os termos do site de destino.
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.