Como usar o CapSolver no n8n: O Guia Completo para resolver CAPTCHA em seus fluxos de trabalho

Todo engenheiro de automação enfrenta o mesmo problema: você cria um fluxo perfeito, raspagem, login ou submissão de formulário — e um CAPTCHA o para imediatamente. Como o reCAPTCHA pode dificultar seu trabalho de extração de dados, o Desafio Cloudflare interrompe suas solicitações e os quebra-cabeças de deslizamento bloqueiam o acesso às APIs que você precisa.

E se você pudesse resolver todos os principais tipos de CAPTCHA diretamente nos seus fluxos de trabalho do n8n sem scripts personalizados ou integrações complexas?

n8n é uma plataforma de automação de fluxos de trabalho com mais de 400 integrações, disponível como auto-hospedada ou em nuvem, que permite criar automações poderosas visualmente com no-code ou low-code. CapSolver é um serviço de resolução de CAPTCHA baseado em inteligência artificial, que suporta reCAPTCHA v2/v3, Cloudflare Turnstile/Challenge, GeeTest, AWS WAF, ImageToText e mais, disponível como um nó oficial do n8n que você pode usar diretamente em seus fluxos de trabalho.

Juntos, eles permitem que você resolva CAPTCHAs de forma transparente e construa pipelines de raspagem, automações de login e fluxos de formulário em um só lugar, e este guia é sua referência completa para usar o CapSolver no n8n.

Todas as Operações do CapSolver no n8n

O nó do CapSolver no n8n suporta várias operações organizadas sob dois tipos de recursos: Token e Reconhecimento. Compreender a diferença é essencial — isso determina como o nó se comporta, quais parâmetros você precisa e como usar o resultado.

Operações de Token (7) — Assíncrono, verificar resultado

Operações de token resolvem CAPTCHAs que protegem sites. Você fornece a URL do site-alvo e os parâmetros do CAPTCHA, o CapSolver cria uma tarefa em segundo plano, verifica até que seja resolvida e retorna um token (ou cookie) que você envia ao site — exatamente como um navegador faria.

Operações de Reconhecimento (4) — Resultado instantâneo, sem verificação

Operações de reconhecimento analisam imagens ou desafios visuais. Você envia os dados da imagem diretamente e o CapSolver retorna o resultado imediatamente — sem criar tarefas, sem verificação. Essas são usadas quando você precisa ler texto de imagens de CAPTCHA ou resolver um desafio visual como um quebra-cabeça de deslizamento.

Nota: As operações de reconhecimento do reCAPTCHA v2 e AWS WAF aparecem sob o tipo de recurso Reconhecimento no menu suspenso do nó CapSolver — elas são separadas das operações baseadas em Token com o mesmo nome. A versão de Token gera um token de verificação; a versão de Reconhecimento classifica um desafio de imagem.

Configurando o CapSolver no n8n

O CapSolver está disponível como uma integração oficial no n8n — sem necessidade de instalação de nó da comunidade. Você pode encontrá-lo diretamente no painel de nós ao construir seus fluxos de trabalho.

Como é uma integração oficial, você precisa criar uma credencial no n8n para que o nó do CapSolver possa autenticar com sua conta.

Passo 1: Abra a Página de Credenciais

Acesse sua instância do n8n e navegue até Configurações -> Credenciais. Você verá todas as credenciais configuradas aqui.

Passo 2: Crie a Credencial do CapSolver

1. Clique em Criar credencial (canto superior direito)
2. Pesquise por "CapSolver" e selecione API CapSolver
3. Insira sua Chave de API — copie-a diretamente do Painel do CapSolver
4. Deixe Domínios de solicitação HTTP permitidos definido como Todos (padrão)
5. Clique em Salvar

O n8n testará automaticamente a conexão. Você deverá ver uma mensagem verde "Conexão testada com sucesso", confirmando que sua chave de API é válida.

Importante: Todos os nós do CapSolver em seus fluxos de trabalho farão referência a essa credencial. Você precisa criá-la apenas uma vez — todos os fluxos de solução usarão a mesma credencial.

Token vs. Reconhecimento: Entendendo os Dois Tipos de Recurso

O nó do CapSolver no n8n organiza suas operações sob dois tipos de recursos. Escolher o correto determina como o nó se comporta e que tipo de resultado você recebe.

Token (Assíncrono)

Operações de token seguem um padrão criar tarefa -> verificar -> obter resultado:

1. Você fornece a URL do site-alvo e os parâmetros específicos do CAPTCHA (chave do site, proxy, etc.)
2. O CapSolver cria uma tarefa de resolução em segundo plano
3. O nó verifica a API do CapSolver até que a tarefa seja concluída (normalmente entre 5-30 segundos)
4. Você recebe um token, cookie ou string de resposta que você envia ao site-alvo

O resultado sempre é algo que você envia de volta ao site — um token gRecaptchaResponse para reCAPTCHA, um cookie cf_clearance para Cloudflare Challenge, um token para Turnstile, etc.

Quando usar Token: Sempre que precisar contornar um CAPTCHA que protege uma página da web, ponto de extremidade de API ou submissão de formulário. Isso abrange a maioria dos cenários de automação do mundo real.

Reconhecimento (Instantâneo)

Operações de reconhecimento seguem um padrão criar tarefa -> obter resultado imediatamente:

1. Você fornece uma imagem (codificada em base64) ou dados de desafio visual
2. O CapSolver analisa a imagem e retorna o resultado em um único ciclo de solicitação-resposta
3. Você recebe texto (para OCR), coordenadas (para desafios baseados em clique) ou medidas (para quebra-cabeças de deslizamento/rotação)

Não há verificação — o resultado retorna imediatamente.

Quando usar Reconhecimento: Quando você precisa ler texto de uma imagem de CAPTCHA, classificar um desafio de imagem ou resolver um quebra-cabeça visual como um de deslizamento ou rotação. Essas operações trabalham com os dados da imagem diretamente — elas não interagem com nenhum site.

Comparação Rápida

Escolhendo a Operação Correta

Não tem certeza qual operação usar? Siga este guia de decisão com base no que você vê no site-alvo.

Você vê uma caixa de seleção ("Não sou um robô") ou um desafio invisível em um site protegido pelo Google?
-> reCAPTCHA v2 (caixa de seleção) ou reCAPTCHA v3 (desafio invisível/baseado em pontuação). Verifique a fonte da página para render= na URL do script reCAPTCHA — se contiver uma chave de site diretamente, é provavelmente v3. Se você ver data-sitekey em um elemento div, é v2.

Você vê uma tela de "Verificando se você é humano..." ou "Verificando seu navegador..."?
-> Cloudflare Challenge. Este é um interstício de página inteira — não um widget pequeno. Ele requer um proxy. Consulte o guia dedicado ao Desafio Cloudflare para detalhes.

Você vê um widget pequeno com um ícone de verificação girando (não uma tela de página inteira)?
-> Cloudflare Turnstile. Procure um div com data-sitekey e um script de challenges.cloudflare.com.

Você vê um quebra-cabeça de deslizamento onde você arrasta uma peça para o lugar?
-> Pode ser GeeTest V3, GeeTest V4, DataDome ou um deslizamento genérico. Abra o DevTools e verifique as solicitações de rede: as solicitações do GeeTest vão para api.geetest.com ou gcaptcha4.geetest.com; as solicitações do DataDome vão para *.datadome.co. Se for um deslizamento genérico não vinculado a um serviço específico, use o Vision Engine com o módulo slider_1.

Você vê um CAPTCHA de imagem com texto/números (letras ou dígitos distorcidos)?
-> Image To Text. Capture a imagem, converta para base64 e envie-a para o recurso de Reconhecimento.

Você vê um quebra-cabeça de rotação (gire a imagem para a orientação correta)?
-> Vision Engine com o módulo rotate.

Você vê um desafio de detecção de objetos (clique em objetos específicos)?
-> Vision Engine com o módulo apropriado para o tipo de desafio.

Você vê um desafio "Pressione e segure" ou quebra-cabeça em um site de comércio eletrônico?
-> Verifique o DevTools para padrões de solicitação do DataDome ou AWS WAF. Desafios do DataDome carregam de *.datadome.co. Desafios do AWS WAF contêm awswaf nas URLs dos scripts.

Não tem certeza do tipo de CAPTCHA que um site usa?
-> Instale a extensão do navegador CapSolver. Abra o DevTools, vá para a aba "CapSolver Captcha Detector" e dispare o CAPTCHA. A extensão identificará o tipo de CAPTCHA e mostrará todos os parâmetros necessários automaticamente.

Padrões Comuns de Fluxo de Trabalho

Todo fluxo de trabalho de resolução de CAPTCHA no n8n segue um dos quatro padrões. Compreender esses padrões significa que você pode criar um fluxo para qualquer tipo de CAPTCHA — basta trocar a operação do CapSolver e ajustar os parâmetros.

Padrão 1: API de Solução

Um ponto de extremidade reutilizável que aceita parâmetros de CAPTCHA e retorna o token resolvido. Outras ferramentas, scripts ou fluxos chamam esse ponto de extremidade quando precisam resolver um CAPTCHA.

Webhook (receber solicitação)
  -> CapSolver (resolver CAPTCHA)
    -> IF (verificar erros)
      -> Responder ao Webhook (retornar token ou erro)

Melhor para: Criar um serviço centralizado de resolução de CAPTCHA que múltiplos sistemas possam chamar. Você configura uma vez e qualquer ferramenta que possa fazer uma solicitação HTTP pode usá-la.

Padrão 2: Pipeline de Raspagem

Um fluxo agendado ou sob demanda que resolve um CAPTCHA, busca dados protegidos, extrai campos, compara com valores anteriores e alerta sobre mudanças.

Agendamento / Webhook (gatilho)
  -> Configuração do Alvo (URL, chaves, proxy)
    -> CapSolver (resolver CAPTCHA)
      -> Requisição HTTP (buscar página protegida com token)
        -> HTML / Código (extrair dados)
          -> Código (comparar com dados armazenados)
            -> IF (dados alterados?)
              -> Construir Alerta / Sem Alteração

Melhor para: Monitoramento de preços, rastreamento de estoque, análise de concorrentes — qualquer cenário em que você precise raspagem regularmente uma página protegida por CAPTCHA e detectar mudanças.

Padrão 3: Automação de Login

Um fluxo que resolve um CAPTCHA, envia credenciais de login e verifica se o login foi bem-sucedido.

Agendamento / Webhook (gatilho)
  -> Configuração de Login (URL, chaves, credenciais)
    -> CapSolver (resolver CAPTCHA)
      -> Requisição HTTP (POSTar credenciais + token)
        -> IF (login bem-sucedido?)
          -> Marcar como Sucesso / Marcar como Falha

Melhor para: Manter sessões ativas, monitoramento automático de contas ou qualquer fluxo que exija autenticação por meio de um formulário de login protegido por CAPTCHA.

Fluxo de Trabalho Exemplo: API de Resolução reCAPTCHA v2

O seguinte fluxo implementa Padrão 1: API de Solução — um endpoint de webhook simples com 5 nós que resolve reCAPTCHA v2 e retorna o token. Este é o fluxo mais simples do CapSolver e serve como modelo para qualquer operação de Token.

Fluxo de Trabalho

Receber Solicitação de Solução (Webhook)
  -> Resolver CAPTCHA (reCAPTCHA v2 do CapSolver)
    -> Houve erro do CapSolver? (nó IF)
      -> Responder ao Webhook (Erro) / Responder ao Webhook (Sucesso)

Como Funciona

1. Receber Solicitação de Solução — Um nó Webhook escuta por solicitações POST contendo websiteURL e websiteKey
2. Resolver CAPTCHA — O nó CapSolver resolve o desafio reCAPTCHA v2 usando os parâmetros fornecidos
3. Houve erro do CapSolver? — Um nó IF verifica se a resposta do CapSolver contém um erro
4. Responder ao Webhook — Retorna o token resolvido em caso de sucesso, ou a mensagem de erro em caso de falha

Modelo para qualquer operação de Token: Este fluxo funciona para qualquer uma das 9 operações de Token — basta alterar o menu suspenso Operação no nó CapSolver (por exemplo, de "reCAPTCHA v2" para "Cloudflare Turnstile") e ajustar os parâmetros de entrada conforme necessário. O padrão webhook -> resolver -> verificar -> responder permanece o mesmo.

{
  "nodes": [
    {
      "parameters": {
"content": "## CapSolver \u2014 API de resolução de reCAPTCHA v2\n\n### Como funciona\n\n1. Recebe uma solicitação por meio de um gatilho de webhook.\n2. Usa o CapSolver para resolver o desafio reCAPTCHA v2.\n3. Envia o resultado de volta por meio de uma resposta de webhook.\n\n### Etapas de configuração\n\n- [ ] Defina a URL do webhook no aplicativo.\n- [ ] Configure as credenciais da API do CapSolver.\n\n### Personalização\n\nPersonalize as configurações do CapSolver, se necessário, para diferentes tipos de reCAPTCHA.",
        "width": 480,
        "height": 512
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        -784,
        -368
      ],
      "id": "c6530d09-1367-41d4-a4d6-e9d015347dbd",
      "name": "Nota Adesiva"
    },
    {
      "parameters": {
        "content": "## Operação de resolução de reCAPTCHA\n\nGerencia todo o processo desde a recepção de uma solicitação até a resposta com os resultados.",
        "width": 720,
        "height": 304,
        "color": 7
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        -224,
        -368
      ],
      "id": "dcceb52e-8816-48f2-bd26-b56e2592edf6",
      "name": "Nota Adesiva1"
    },
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "capsolver-recaptcha-v2",
        "responseMode": "responseNode",
        "options": {}
      },
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 2.1,
      "position": [
        -176,
        -240
      ],
      "id": "ov-002",
      "name": "Receber Solicitação de Resolução",
      "webhookId": "ov-002-webhook",
      "onError": "continueRegularOutput"
    },
    {
      "parameters": {
        "websiteURL": "={{ $json.body.websiteURL }}",
        "websiteKey": "={{ $json.body.websiteKey }}",
        "optional": {}
      },
      "type": "n8n-nodes-capsolver.capSolver",
      "typeVersion": 1,
      "position": [
        80,
        -240
      ],
      "id": "ov-003",
      "name": "Resolver Captcha",
      "credentials": {
        "capSolverApi": {
          "id": "BeBFMAsySMsMGeE9",
          "name": "conta CapSolver"
        }
      }
    },
    {
      "parameters": {
        "respondWith": "json",
        "responseBody": "={{ JSON.stringify($json.data) }}",
        "options": {}
      },
      "type": "n8n-nodes-base.respondToWebhook",
      "typeVersion": 1.5,
      "position": [
        352,
        -240
      ],
      "id": "ov-004",
      "name": "Responder ao Webhook"
    }
  ],
  "connections": {
    "Receber Solicitação de Resolução": {
      "main": [
        [
          {
            "node": "Resolver Captcha",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Resolver Captcha": {
      "main": [
        [
          {
            "node": "Responder ao Webhook",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "pinData": {},
  "meta": {
    "instanceId": "962ff0267b713be0344b866fa54daae28de8ed2144e2e6867da355dae193ea1f"
  }
}

Boas Práticas

Essas dicas se aplicam a todos os tipos de captcha e padrões de fluxo de trabalho.

Use a extensão do navegador do CapSolver para identificar os parâmetros do captcha. Não chute qual tipo de captcha o site usa ou procure manualmente no código-fonte da página por chaves de site. Instale a extensão do navegador do CapSolver, abra o DevTools e dispare o captcha — a extensão identifica o tipo e exibe todos os parâmetros necessários automaticamente.

Comece com os tipos de tarefa sem proxy; adicione o proxy apenas quando necessário. A maioria das operações de Token oferece variantes com e sem proxy. A versão sem proxy é mais simples (menos parâmetros, sem custo de proxy) e funciona para a maioria dos sites. Mude para um tipo de tarefa com proxy apenas se a versão sem proxy falhar ou se o tipo de captcha exigir (o Cloudflare Challenge e o DataDome sempre exigem um proxy).

Use proxies residenciais para Cloudflare Challenge e DataDome. Proxies de datacenter são mais baratos, mas frequentemente bloqueados por sistemas anti-bot rigorosos. O CapSolver retornará o erro 1002 ou marcará a tarefa como "não solucionável" se você usar um proxy de datacenter em um site que exige IPs residenciais. Use proxies residenciais ou móveis para esses dois tipos de captcha.

Configure tratamento de erros com nós IF. Sempre adicione um nó IF após o nó do CapSolver para verificar erros antes de prosseguir. O CapSolver retorna errorId: 0 em caso de sucesso e um errorId diferente de zero com uma errorDescription em caso de falha. Rotear os erros separadamente evita falhas em cascata no seu fluxo de trabalho.

Use nós de Configuração de Campos para centralizar a configuração. Não codifique diretamente URLs de destino, chaves de site e strings de proxy em cada nó. Use um nó Set no início do seu fluxo de trabalho para definir todos os parâmetros em um único local. Isso facilita a atualização de parâmetros, a troca entre destinos ou a duplicação do fluxo de trabalho para um site diferente.

Envie os tokens imediatamente — eles expiram. A maioria dos tokens de captcha é válida por 60-120 segundos. Não adicione atrasos desnecessários entre o nó do CapSolver e o nó de solicitação HTTP que envia o token. Se você estiver construindo uma API de resolução, certifique-se de que o cliente envie o token imediatamente após recebê-lo.

Teste primeiro com o caminho do webhook, depois ative o agendamento. Todos os fluxos de trabalho de casos de uso nos guias detalhados incluem tanto um gatilho de agendamento (para execuções recorrentes) quanto um gatilho de webhook (para testes sob demanda). Comece com o caminho do webhook para verificar se tudo funciona, depois ative o fluxo de trabalho para habilitar o agendamento.

Inspeção a submissão real do formulário no DevTools. Resolver o captcha é apenas metade do trabalho — você também precisa submeter o token exatamente como o navegador faz. Abra o DevTools -> aba Rede, resolva o captcha manualmente no seu navegador e inspecione a solicitação que é enviada. Verifique o nome do campo (não é sempre g-recaptcha-response), o método da solicitação, o tipo de conteúdo e a URL do endpoint.

Pronto para começar? Registre-se no CapSolver e use o código de bônus n8n para obter um bônus extra de 8% na sua primeira recarga!

Conclusão

O nó CapSolver do n8n oferece acesso a 13 operações de resolução de captcha em 2 tipos de recursos — cobrindo cada serviço de captcha majoritário que você encontrará na natureza. Seja com reCAPTCHA, Cloudflare, GeeTest, DataDome, AWS WAF, MTCaptcha ou desafios baseados em imagem, há uma operação dedicada pronta para uso.

Todo fluxo de trabalho segue um dos três padrões: API de Resolução, Pipeline de raspagem. Uma vez que você entenda o padrão, criar um novo fluxo de trabalho para um tipo de captcha diferente é apenas uma questão de alterar o menu suspenso da operação e ajustar os parâmetros.

Para instruções passo a passo sobre qualquer tipo de captcha específico, use os guias detalhados vinculados na tabela de operações acima. Cada guia inclui JSON de fluxo de trabalho completo e importável para APIs de resolução, pipelines de raspagem e automações de login.

Dica: Esses fluxos de trabalho usam gatilhos de Agendamento + Webhook, mas você pode trocar o nó de gatilho para qualquer gatilho do n8n — manual, evento de app, submissão de formulário, etc. Após buscar os dados, use os nós integrados do n8n para salvar os resultados no Google Sheets, bancos de dados, armazenamento em nuvem ou enviar alertas via Telegram/Slack/Email.

Perguntas Frequentes

O CapSolver é uma integração oficial do n8n?

Sim. O CapSolver está disponível como um nó oficial na biblioteca de nós integrados do n8n. Você não precisa instalar nenhum nó de comunidade — apenas pesquise por "CapSolver" no painel de nós e ele estará pronto para uso. A única configuração necessária é criar uma credencial com a sua chave de API do CapSolver.

Quais tipos de captcha exigem um proxy?

Cloudflare Challenge e DataDome sempre exigem um proxy — não há opção sem proxy. Todas as outras operações de Token (reCAPTCHA v2/v3, Cloudflare Turnstile, Challenge, GeeTest V3/V4, AWS WAF, ) oferecem variantes sem proxy que funcionam sem um. Operações de Reconhecimento (Texto de Imagem, Engine de Visão) nunca precisam de um proxy.

Qual é a diferença entre Token e Reconhecimento?

Operações de Token resolvem captchas que protegem sites — elas retornam um token ou cookie que você submete ao site. Elas são assíncronas (criar tarefa, verificar, obter resultado) e levam 5-30 segundos. Operações de Reconhecimento analisam imagens — elas retornam texto, coordenadas ou medidas instantaneamente. Token cobre 9 das 13 operações; Reconhecimento cobre 4.

O CapSolver funciona com o n8n Cloud?

Sim. Esses fluxos de trabalho funcionam tanto com o n8n autosservido quanto com o n8n Cloud. O nó CapSolver já está disponível na biblioteca de nós do n8n Cloud — basta adicionar suas credenciais de API.

Quanto custa o CapSolver?

O preço varia de acordo com o tipo de captcha. O reCAPTCHA v2 começa em 0,4 por 1.000 resoluções; o Cloudflare Challenge e o DataDome são mais caros devido à sua complexidade. As tarefas de reconhecimento de texto de imagem e engine de visão são normalmente as mais baratas. Consulte a página de preços do CapSolver para as taxas atuais. Use o código de bônus n8n para obter um bônus de 8% na sua primeira recarga.

Como identificar qual captcha um site usa?

O método mais rápido é a extensão do navegador do CapSolver. Instale-a, abra o DevTools na página de destino, vá para a aba "CapSolver Captcha Detector" e dispare o captcha. A extensão identifica o tipo de captcha e exibe todos os parâmetros necessários (chave do site, domínio da API, ID do desafio, etc.) automaticamente. Alternativamente, você pode inspecionar manualmente o código-fonte da página e as solicitações da rede — procure por URLs de script contendo recaptcha, turnstile, geetest, datadome ou awswaf.

Posso resolver múltiplos tipos de captcha em um único fluxo de trabalho?

Sim. Você pode adicionar múltiplos nós do CapSolver em um único fluxo de trabalho, cada um configurado para uma operação diferente. Por exemplo, um fluxo de trabalho pode resolver um desafio Cloudflare Turnstile em uma página de login, e depois resolver um desafio reCAPTCHA v2 em um formulário dentro da sessão autenticada. Cada nó do CapSolver opera de forma independente — certifique-se apenas de que cada um tenha a operação e os parâmetros corretos configurados.

O que fazer se o CapSolver retornar um token, mas o site o rejeitar?

Várias coisas podem causar isso. Primeiro, os tokens expiram rapidamente (60-120 segundos) — certifique-se de submetê-los imediatamente após a resolução. Segundo, verifique se você está enviando o token para o endpoint certo e com o nome do campo correto: inspecione a solicitação real que o navegador faz ao enviar o formulário (DevTools -> aba Rede) e confirme que tudo corresponda. Terceiro, alguns sites exigem parâmetros adicionais (como enterprisePayload para reCAPTCHA Enterprise, metadata.action para Turnstile ou cabeçalhos/cookies específicos). Use a extensão do CapSolver para verificar se algum desses se aplica. Quarto, para Cloudflare Challenge e DataDome, verifique os guias dedicados — esses tipos têm requisitos adicionais (proxy, correspondência de User-Agent, etc.). Se o token ainda for rejeitado, entre em contato com o suporte do CapSolver para ajuda.