🎉NOVOCapSolver para agentes de IA
Selenium CAPTCHA solver landing page hero section with code snippet and CTA buttons
Selenium CAPTCHA solver landing page hero section with code snippet and CTA buttons

Automação de Agentes · LangChain

Adicione CapSolver ao seu agente LangChain – resolva CAPTCHAs em uma chamada de ferramenta

CapSolver Agent adiciona LangChain BaseTools prontos via get_langchain_tools() ao seu agente ReAct ou LangGraph. Quando um CAPTCHA aparece, ele chama o solucionador, obtém um token e continua – alimentado por um SDK nativo para LangChain, ferramentas de navegador e MCP.

Langchain •agent runner

agent → browser.navigate("signup")
agent → form.fill(profile)
CAPTCHA detected
tool_call: solve_recaptcha()span: tools.solve_recaptcha · sitekey + page_url
token returned → agent.resume()
final_output: signup complete
CapSolver Agent Tools

Solving captcha...

Fluxo de trabalho do agente CAPTCHA

01

Detectar

CAPTCHA ou verificação aparece

02

Extrair

URL, chave do site, metadados

03

Resolver

Tarefa CapSolver

04

Retorno

Solução devolvida ao agente

05

Continuar

O agente retoma o fluxo de trabalho

Adicione resolução CAPTCHA aos seus agentes LangChain

01

Criado para loops de agente

Um solucionador LangChain CAPTCHA é útil quando um fluxo de trabalho de agente atinge sites reais e pode ser interrompido pela validação de tráfego ou desafios de CAPTCHA.

02

Padrão nativo da ferramenta

Exponha o CapSolver como uma ferramenta LangChain que pode ser chamada com entradas claras, para que o agente possa solicitar a resolução de CAPTCHA apenas quando necessário.

03

Recuperação da produção

Lide com novas tentativas, erros, IDs de solicitação e tempos limite sem interromper o fluxo de trabalho do agente.

04

Limites claros da ferramenta

Seu agente controla o fluxo de trabalho. CapSolver trata da tarefa de resolução e retorna o resultado.

Por que os agentes LangChain precisam de recuperação CAPTCHA na produção

LangChain foi projetado para agentes que agem por meio de ferramentas. Em fluxos de trabalho de automação de navegador, esse ciclo é frequentemente interrompido pelo reCAPTCHA ou Cloudflare Turnstile. A solução certa não é transformar o CapSolver em uma estrutura de agente – é tornar o CapSolver a camada de infraestrutura CAPTCHA pronta para agente que todo agente de navegador do mundo real pode chamar quando necessário.

Camada de fluxo de trabalho

Função no fluxo de trabalho LangChain

O que CapSolver adiciona

Agente LangChain

Planeja a tarefa, seleciona ferramentas e mantém o estado.

Uma ferramenta de recuperação CAPTCHA que pode ser chamada somente quando necessário.

API CapSolver

Cria tarefas específicas para desafios e retorna soluções.

Lida com reCAPTCHA v2/v3, Cloudflare Challenge/Turnstile e outros desafios suportados por meio da API.

Observabilidade

Rastreia chamadas de ferramentas, erros e status do fluxo de trabalho

IDs de tarefas CAPTCHA, tipo de desafio, status de resolução e códigos de erro/novas tentativas.

Arquitetura

Mantenha as responsabilidades claras: LangChain orquestra, CapSolver resolve CAPTCHAs

Use CapSolver como uma ferramenta focada em seu fluxo de trabalho LangChain. O agente fornece o URL do site, a chave do site e os detalhes do desafio. A ferramenta cria uma tarefa, verifica o resultado e retorna a solução. LangChain gerencia o fluxo de trabalho do agente, enquanto CapSolver cuida da resolução de CAPTCHA.

Detectar

Um desafio CAPTCHA está presente na página de destino.

Extrair

Colete websiteURL, websiteKey e tipo de desafio.

Criar

Chame CapSolver createTask com o objeto de tarefa correto.

Enquete

Verifique getTaskResult até que a tarefa esteja pronta ou expire. Use atrasos de repetição para erros de limite de taxa.

Continuar

A ferramenta retorna um token estruturado e o agente LangChain retoma a tarefa original.

Observe

Registre o ID da tarefa, o status e os códigos/novas tentativas de erro.

Início rápido

Crie uma ferramenta Python LangChain com a API CapSolver

Enrole o CapSolvercreateTask+getTaskResultem uma ferramenta: entra informação estruturada, sai um resultado estruturado. A pesquisa usa um intervalo fixo com um tempo limite geral.

capsolver_solve_captcha.py
# pip install "capsolver-agent[langchain]" langchain-openai langgraph
# export CAPSOLVER_API_KEY=CAP-XXXXXX
# export OPENAI_API_KEY=sk-XXXXXX

import asyncio
import os
from langchain_core.tools import tool
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent
from capsolver_agent.schema import create_executor
from _env import load_example_env  # demo only: reads repo-root .env

load_example_env()

# 1. Wrap CapSolver as one LangChain tool.
#    createTask + result polling are handled inside capsolver-agent.
executor = create_executor()  # key from CAPSOLVER_API_KEY

@tool
async def solve_captcha(captcha_type: str, website_url: str, website_key: str) -> dict:
    """Solve a captcha (reCaptchaV2 / reCaptchaV3 / cloudflare) and return its token.

    captcha_type: captcha family, e.g. reCaptchaV2
    website_url:  full URL of the page that loads the captcha
    website_key:  site key found on that page
    """
    result = await executor.execute(
        "solve_captcha",
        {"captcha_type": captcha_type, "website_url": website_url, "website_key": website_key},
    )
    if not result.get("success"):
        return {"ok": False, "error": result.get("error", "unknown error")}
    return {"ok": True, "token": result["solution"]["token"]}

# 2. Any OpenAI-compatible chat model works; the LLM decides when to call the tool.
llm = ChatOpenAI(model=os.environ.get("OPENAI_MODEL", "gpt-4o"), temperature=0)

# 3. Give the tool to a ReAct agent.
agent = create_react_agent(llm, [solve_captcha])

# 4. Run.
PROMPT = (
    "Solve the reCaptchaV2 at https://www.google.com/recaptcha/api2/demo "
    "with site key 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ- "
    "and report the first 40 characters of the token."
)
result = asyncio.run(agent.ainvoke({"messages": [("user", PROMPT)]}))
print(result["messages"][-1].content)

Adicione as ferramentas a um agente LangChain

get_langchain_tools()retorna BaseTools padrão que ficam ao lado do navegador, extração de dados ou ferramentas de fluxo de trabalho que seu agente já usa.

langchain_agent.py
# pip install "capsolver-agent[langchain]" langchain-openai langgraph
# export CAPSOLVER_API_KEY=CAP-XXXXXX
# export OPENAI_API_KEY=sk-XXXXXX

import asyncio
import os
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent
from capsolver_agent.langchain_tools import get_langchain_tools
from _env import load_example_env  # demo only: reads repo-root .env

load_example_env()

# CapSolver's ready-made LangChain BaseTools, backed by capsolver-core:
# solve_captcha, detect_captchas, solve_on_page, get_balance, get_supported_captchas
tools = get_langchain_tools(api_key=os.environ["CAPSOLVER_API_KEY"])

llm = ChatOpenAI(model=os.environ.get("OPENAI_MODEL", "gpt-4o"), temperature=0)

# The solver tools sit beside the browser / data / workflow tools your agent already uses
agent = create_react_agent(llm, tools)

result = asyncio.run(  # CapSolver tools are async, so use ainvoke
    agent.ainvoke(
        {
            "messages": [
                {
                    "role": "user",
                    "content": "Solve the reCaptchaV2 at "
                               "https://www.google.com/recaptcha/api2/demo with site key "
                               "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ- and report the "
                               "first 40 characters of the token.",
                }
            ]
        }
    )
)

print(result["messages"][-1].content)
capsolver-agent é um pacote Python puro. Instale-o com

e importe as ferramentas diretamente – nenhum pacote JavaScript ou TypeScript é necessário.

Melhores práticas de produção

Crie soluções CAPTCHA prontas para produção para agentes LangChain

01

Gerenciamento secreto

Armazene CAPSOLVER_API_KEY em variáveis de ambiente ou em um gerenciador de segredos.

Por que

Evita a exposição acidental de chaves em prompts, logs e repositórios.

02

Esquema de ferramenta

Mantenha a entrada da ferramenta restrita e digitada (website_url, website_key).

Por que

Reduz a confusão do modelo e a geração de argumentos inseguros.

03

Detecção

Leia o tipo de desafio e a chave do site no contexto da página.

Por que

O modelo não deve adivinhar os parâmetros da página a partir do texto bruto.

04

Enquete e tente novamente

Verifique o status da tarefa em intervalos definidos e pare após um tempo limite. Tente novamente erros de API com espera.

Por que

Evita loops desnecessários de carga e agente descontrolado.

05

Registro

Registre task_id, tipo de desafio, status e códigos de erro/novas tentativas.

Por que

Facilita a depuração e o suporte.

06

Tratamento de erros

Evite falhas repetidas e envie a tarefa para revisão humana quando necessário.

Por que

Evita novas tentativas cegas em fluxos de trabalho sensíveis ou incertos.

07

Conformidade

Revise os termos do site, autorização do usuário, requisitos de privacidade e limites de taxas.

Por que

Mantém a automação alinhada com os casos de uso aprovados.

Ajuste ao ecossistema

CapSolver funciona com a infraestrutura do seu navegador – ele não a substitui

01

Base do navegador / Aço

02

Dramaturgo / Marionetista

03

LangChain / LangGraph

Trabalho principal

Execução de navegador hospedado e gerenciamento de sessão.

Controle do navegador e interação DOM.

Orquestração de agentes e uso de ferramentas.

Sem CapSolver

A sessão do navegador pode continuar em execução, mas um CAPTCHA pode interromper o fluxo de trabalho.

A automação pode detectar e interagir com a página, mas ainda precisa de lógica de resolução de CAPTCHA.

O agente pode chamar ferramentas, mas não possui nenhuma ferramenta integrada para resolver CAPTCHAs.

Com CapSolver

CapSolver lida com a tarefa CAPTCHA enquanto a sessão do navegador permanece ativa.

A automação envia os dados do desafio para o CapSolver e utiliza a solução retornada.

O agente chama o CapSolver como ferramenta e continua o fluxo de trabalho com o resultado.

Casos de uso mais adequados

Criado para equipes de agentes B2B que executam fluxos de trabalho de navegador em produção

Automação de vendas

A pesquisa de vendas autorizada e os fluxos de trabalho de CRM podem encontrar CAPTCHA ou verificações de verificação durante as tarefas do navegador.

Tecnologia de RH

Os fluxos de trabalho de recrutamento aprovados podem ser pausados quando a verificação aparece durante tarefas de navegação em várias etapas.

Ferramentas de controle de qualidade e teste

Testes ponta a ponta para inscrição, checkout e formulários precisam de um tratamento claro de CAPTCHA para reduzir falhas nas execuções de testes.

RegTech e conformidade

As verificações de registros públicos e os fluxos de trabalho de coleta de evidências precisam de confiabilidade, registros de auditoria e comportamento alternativo claro.

Automação de Pesquisa

Os fluxos de trabalho de dados públicos autorizados podem ser pausados quando uma fonte mostra um CAPTCHA ou uma verificação de verificação.

RPA Interna

Fluxos de trabalho repetitivos autorizados pelo usuário se beneficiam de uma camada de recuperação CAPTCHA clara quando a validação de tráfego bloqueia uma tarefa.

Uso responsável

Use CapSolver para automação legal e legal

CapSolver destina-se a usos legais e autorizados, incluindo testes de controle de qualidade aprovados, RPA interno, tarefas de agentes autorizados pelo usuário e fluxos de trabalho de dados públicos compatíveis. Antes de automatizar um site, revise seus termos, regras de privacidade aplicáveis, limites de taxas e requisitos de conformidade da sua organização.

01

Testes de controle de qualidade autorizados

02

RPA aprovado

03

Fluxos de trabalho de dados públicos

04

Tarefas de agente autorizado pelo usuário

05

Automação revisada por conformidade

06

Automação de comércio eletrônico

Perguntas frequentes

Integrações Relacionadas

Explore mais integrações CapSolver para sua pilha de agentes

Escolha outra integração para adicionar solução CAPTCHA ao fluxo de trabalho do seu agente ou navegador.

01

Servidor MCP

Conecte o CapSolver a outros clientes que suportam ferramentas MCP.

Ver Integração
02

Dramaturgo

Adicione resolução CAPTCHA à automação personalizada do navegador.

Ver Integração
03

Uso do navegador

Adicione CapSolver como uma ação para agentes de IA baseados em navegador.

Ver Integração
04

SDK de agentes OpenAI

Adicione resolução CAPTCHA por meio de ferramentas funcionais e fluxos de trabalho de agentes.

Ver Integração

Se o seu agente LangChain funciona em demonstrações, mas para na produção, adicione uma camada de recuperação CAPTCHA.

Comece com o wrapper da ferramenta acima, revise a documentação do CapSolver e entre em contato com a equipe quando precisar de suporte empresarial, volume maior ou um caminho de integração SDK nativo.