CapSolver para agentes de IA
Seu agente consegue navegar, clicar e digitar. Mas uma grande parte das tarefas do mundo real para em uma barreira de verificação humana: um reCAPTCHA, um Cloudflare Turnstile, uma verificação de impressão digital do dispositivo. Então, uma execução de várias etapas que estava perfeita simplesmente trava. O CapSolver remove essa barreira em linha, dentro do seu fluxo de trabalho existente, e devolve o controle diretamente ao agente para que a tarefa seja concluída.
Esta página explica o que isso significa na prática, onde o CapSolver se encaixa em uma pilha de agentes e como escolher um caminho de integração. Se preferir ir direto para o código, consulte Introdução e início rápido, o SDK principal, as ferramentas para agentes e o serviço MCP.
A lacuna em produção
Agentes funcionam muito bem em demonstrações. Em uma demo, o agente reserva o voo, enriquece o lead ou busca o documento. Em produção, ele chega a um desafio de verificação e alguém da equipe precisa intervir. A mesma falha aparece em quatro formas reconhecíveis:
- Interrupção do fluxo de trabalho: um único desafio de verificação interrompe uma tarefa de várias etapas que, de outro modo, estaria completa.
- Fallback manual: equipes acabam monitorando discretamente agentes “autônomos”, intervindo sempre que algum fica bloqueado.
- Sem camada de recuperação: agentes de navegador conseguem clicar e digitar, mas nada fecha o ciclo quando a verificação é acionada.
- Sem observabilidade: produção precisa de IDs de solicitação, tentativas novamente e estados de erro claros, não de um token retornado por uma caixa-preta.
Nos testes reais do próprio CapSolver, uma fração significativa das tarefas de agentes, na ordem de 30% ou mais, trava em CAPTCHA, Cloudflare ou verificações de impressão digital. Essa é a lacuna que o CapSolver foi criado para fechar.
O que o CapSolver adiciona: uma camada de recuperação, não uma reescrita
O CapSolver não substitui seu framework de agentes nem seu navegador. Ele fica entre o agente e a barreira, resolve o desafio e retorna o resultado em linha para que a tarefa original possa continuar. Não há re-arquitetura: você mantém sua orquestração, sua sessão de navegador e sua lógica de negócio exatamente como estão, e adiciona a única camada que elas não cobrem.
Duas decisões de design o tornam adequado para produção, em vez de apenas um script pontual:
- Criado para lógica de novas tentativas e observabilidade. Uma resolução retorna um token utilizável e um identificador de solicitação, para que cada desafio seja rastreável: você pode atribuir, tentar novamente e depurar bloqueios em vez de adivinhar por que um agente parou.
- A resolução acontece na nuvem. A detecção, a montagem de parâmetros e o preenchimento do resultado rodam do seu lado por meio do SDK; o reconhecimento real é realizado pelo serviço de IA do CapSolver. Seu código (ou seu modelo) decide o que fazer; o CapSolver cuida da resolução.
Atualmente, o SDK cobre os tipos de verificação que os agentes encontram com mais frequência: reCAPTCHA v2 e v3 (incluindo Enterprise) e Cloudflare Turnstile, enquanto o serviço CapSolver subjacente oferece suporte a um catálogo muito mais amplo de tipos de desafio. Consulte a referência de tipos de tarefa para ver a lista completa atual.
Como funciona
O CapSolver divide “passar por uma barreira” em cinco etapas claras que se encaixam em um fluxo existente:
- Detectar: seu agente ou fluxo de navegador encontra um desafio de verificação humana.
- Resolver: o CapSolver lida com o desafio em todos os tipos de CAPTCHA compatíveis.
- Recuperar: o resultado é retornado em linha ao fluxo do seu agente.
- Continuar: o agente retoma e conclui a tarefa original, sem falha.
- Observar: um ID de solicitação, status e informações de erro tornam cada resolução rastreável.
Escolha o caminho para sua pilha
O CapSolver é distribuído como três pacotes Python, além de integrações nativas com frameworks, para que você possa escolher o nível de abstração que combina com a forma como constrói. Os três são camadas sobre um único mecanismo: escolha o melhor encaixe e coloque em produção em minutos.
| Caminho | Melhor para | O que você recebe |
|---|---|---|
Serviço MCP (capsolver-mcp) | Qualquer cliente compatível com MCP: Claude Desktop, Claude Code, Cursor, Cline | Um servidor MCP padrão que expõe ferramentas de resolução automaticamente, com quase nenhum código de integração. O caminho mais rápido. Consulte o guia do serviço MCP. |
Ferramentas para agentes (capsolver-agent) | LangChain, o SDK de OpenAI Agents, Browser Use ou qualquer loop de agente personalizado | Esquemas de ferramentas independentes de framework, um executor e ferramentas LangChain prontas para uso: deixe o modelo decidir quando resolver. Consulte o guia de agentes. |
SDK principal (capsolver-core) | Scripts, crawlers e automação Playwright sob medida | O mecanismo em si: detectar, ler parâmetros, resolver e preencher de volta, sem exigir um LLM. Consulte o guia do SDK principal. |
As integrações com frameworks se conectam a esses pacotes: um agente de Browser Use registra a resolução como uma ação que recupera a sessão sempre que uma verificação aparece no meio da tarefa; um aplicativo de LangChain ou do SDK de OpenAI Agents chama o CapSolver como uma ferramenta com rastreamento completo; e um fluxo de Playwright conecta a resolução diretamente a automações personalizadas de QA, RPA e testes de ponta a ponta.
Funciona sobre sua infraestrutura de navegador
O CapSolver é aditivo. Você traz o navegador: Browserbase, Steel, Playwright, Puppeteer, Selenium ou o seu próprio, e o CapSolver limpa a parte pela qual ele não consegue passar sozinho. Um IP limpo e um navegador novo levam o agente até a barreira; o CapSolver o faz atravessar. Adicionamos a camada que sua pilha não cobre, em vez de substituir a pilha.
Para quem é
O problema de verificação aparece da mesma forma em todos os setores que constroem agentes de produção:
- Automação de vendas: agentes de prospecção e outreach são bloqueados ao enriquecer leads e coletar sinais em escala, então pipelines que deveriam rodar sem supervisão durante a noite acabam parando.
- Tecnologia de RH e recrutamento: agentes de busca de candidatos travam atrás de verificações em sites de vagas e perfis.
- RegTech e conformidade: agentes de revisão automatizada precisam acessar portais protegidos para coletar documentos e registros dentro do prazo.
- Ferramentas de QA e testes: agentes de testes de ponta a ponta quebram em CAPTCHA em fluxos de login de staging e produção.
Em cada caso, a correção é a mesma: uma camada de recuperação que permite que o trabalho autorizado e orientado pelo usuário seja concluído sem intervenção humana.
Criado para automação responsável
O CapSolver é infraestrutura para trabalho legítimo e autorizado pelo usuário: o mesmo papel que uma API de pagamentos desempenha para um produto SaaS, ou que uma API de mensagens desempenha para comunicações. Um agente age em nome de um usuário real que o autorizou; o problema não é o agente, mas o fato de que automação legítima e orientada pelo usuário continua sendo classificada incorretamente como bot. O CapSolver resolve essa classificação incorreta para que o trabalho autorizado possa terminar.
Esse posicionamento vem com salvaguardas:
- Apenas com autorização do usuário: criado para automação que um usuário direcionou e consentiu explicitamente.
- Respeita os termos do site: destinado a apoiar fluxos de agentes legais e em conformidade com os termos.
- Trilha de auditoria completa: cada resolução é registrada com um ID de solicitação para responsabilidade e revisão.
- Política clara de uso aceitável: diretrizes publicadas definem para que o serviço serve e para que não serve. Consulte nossa declaração de conformidade e nossa posição sobre abuso.
Modelo de preços
O CapSolver é baseado em uso: você paga por cada desafio resolvido com sucesso, sem mínimos mensais e sem cobrança por tentativas com falha. Um nível gratuito permite testar dentro do seu próprio fluxo de trabalho antes de se comprometer, descontos por volume são aplicados à medida que você escala, e equipes empresariais que executam agentes em escala podem solicitar um SLA, onboarding personalizado e um canal de suporte dedicado. Consulte preços para ver os detalhes atuais.
Comece agora
- Crie uma conta e obtenha uma chave de API: registre-se no site da CapSolver, copie sua chave no painel e adicione fundos. Cada resolução bem-sucedida consome saldo.
- Escolha um caminho: o serviço MCP para uso plug-and-play em um cliente de IA, as ferramentas para agentes para permitir que um modelo chame a resolução por conta própria, ou o SDK principal para scripts e automação personalizada.
- Insira no seu fluxo: siga o guia correspondente e adicione a camada que faltava ao seu agente.
Se seu agente toca a web real, ele vai encontrar essa barreira. O CapSolver é a camada que o ajuda a atravessá-la.