Introdução

A reCAPTCHA v2 é amplamente usada para proteger sites contra abuso automatizado, mas muitas vezes se torna um obstáculo principal para automação legítima, testes e fluxos de coleta de dados. Se você está com dificuldades para resolver a reCAPTCHA v2 de forma programática, este guia o guiará por uma solução confiável e eficiente usando a API CapSolver.

Neste tutorial, você aprenderá a criar e enviar uma tarefa de resolução de reCAPTCHA v2, recuperar o token de solução e integrar a CapSolver ao seu fluxo de trabalho usando tanto o Python quanto o Go. Você pode escolher entre usar seus próprios proxies com ReCaptchaV2Task ou confiar no proxy integrado da CapSolver via ReCaptchaV2TaskProxyLess.

Visão Geral: Resolvendo a reCAPTCHA v2 com a CapSolver

A CapSolver fornece uma abordagem baseada em API simples para resolver desafios de reCAPTCHA v2 por meio de:

1. Criando uma tarefa com os parâmetros necessários do site
2. Enviando a tarefa para a CapSolver
3. Verificando o resultado
4. Recebendo um token válido gRecaptchaResponse

Este token pode ser injetado em sua solicitação de destino ou em seu fluxo de automação de navegador.

Criando uma Tarefa

Para resolver a reCAPTCHA v2, você primeiro precisa criar uma tarefa usando o método createTask.

Aqui está a estrutura do objeto de tarefa:

• type: Obrigatório. Deve ser ReCaptchaV2Task ou ReCaptchaV2TaskProxyLess.
• websiteURL: Obrigatório. É o endereço web do site que usa a reCAPTCHA v2.
• websiteKey: Obrigatório. É a chave pública do domínio.
• proxy: Opcional. Se você estiver usando um proxy, pode incluí-lo aqui.
• isInvisible: Opcional. Se a reCAPTCHA não tiver pageAction, defina como true.
• userAgent: Opcional. Se você estiver simulando um navegador, inclua seu User-Agent aqui.
• cookies: Opcional. Se você precisar usar cookies, inclua-os aqui.

Aqui está um exemplo de solicitação:

{
  "clientKey": "SUA_CHAVE_DE_API",
  "task": {
    "type": "ReCaptchaV2Task",
    "websiteURL": "site",
    "websiteKey": "chave_do_site",
    "isInvisible": false,
    "userAgent": "",
    "cookies": [
      {
        "name": "__Secure-3PSID",
        "value": "sdadasdasdsda"
      },
      {
        "name": "__Secure-3PAPISID",
        "value": "sd/AytXQTb6RUALqxSEL"
      }
    ],
    "proxy": ""
  }
}

Assim que a tarefa for enviada com sucesso, você receberá um ID de tarefa na resposta:

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Obtendo Resultados

Assim que você tiver o ID da Tarefa, pode usá-lo para recuperar a solução. Envie o ID da Tarefa com o método getTaskResult. Os resultados devem estar prontos em um intervalo de 1s a 10s.

Aqui está um exemplo de solicitação:

{
    "clientKey": "SUA_CHAVE_DE_API",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

A resposta incluirá o token de solução:

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "userAgent": "xxx", 
        "expireTime": 1671615324290, 
        "gRecaptchaResponse": "3AHJ....." // Este é o token de solução
    },
    "status": "ready"
}

Resolver a reCAPTCHA v2 com Python:

# Instale o SDK da CapSolver
# pip install --upgrade capsolver

# Defina a chave da API da CapSolver
# export CAPSOLVER_API_KEY='SUA_CHAVE_DE_API'

import capsolver
# capsolver.api_key = 'SUA_CHAVE_DE_API'

# Resolver um desafio de reCAPTCHA v2
solution = capsolver.solve({
    "type": "ReCaptchaV2TaskProxyLess",
    "websiteURL": "url_do_site",
    "websiteKey": "chave_do_site",
})

Resolver a reCAPTCHA v2 com GO:

package main

import (
    "fmt"
    capsolver_go "github.com/capsolver/capsolver-go"
    "log"
)

func main() {
    // Instale o SDK da CapSolver
    // go get github.com/capsolver/capsolver-go

    // Defina a chave da API da CapSolver
    // export CAPSOLVER_API_KEY='SUA_CHAVE_DE_API'
    // ou
    // capSolver := CapSolver{apiKey:"SUA_CHAVE_DE_API"}

    capSolver := capsolver_go.CapSolver{}
    solution, err := capSolver.Solve(map[string]any{
        "type": "ReCaptchaV2TaskProxyLess",
        "websiteURL": "https://www.google.com/recaptcha/api2/demo",
        "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    })
    if err != nil {
        log.Fatal(err)
        return
    }
    fmt.Println(solution)
}

Por favor, substitua SUA_CHAVE_DE_API pela sua chave de API real da CapSolver, e substitua websiteURL e websiteKey pela URL do site e pela chave do site reCAPTCHA que você está tentando resolver.

Preços

Para informações detalhadas sobre preços, visite a página oficial de preços da CapSolver:
https://www.capsolver.com/#pricing

Recursos Adicionais

Para documentação mais aprofundada sobre a resolução da reCAPTCHA v2, consulte:
https://docs.capsolver.com/en/guide/recognition/ReCaptchaClassification/

Resgate seu Código de Bônus da CapSolver

Aumente seu orçamento de automação instantaneamente!
Use o código de bônus CAPN ao recarregar sua conta da CapSolver para obter um bônus adicional de 5% em cada recarga — sem limites.
Resgate-o agora em seu Painel da CapSolver
.

Conclusão

Resolver a reCAPTCHA v2 não precisa ser complexo ou confiável. Com a CapSolver, você pode automatizar todo o processo usando uma API simples que suporta soluções com e sem proxy. Ao seguir as etapas descritas neste guia — criar uma tarefa, recuperar o resultado e integrar o token de solução — você pode superar com eficiência a reCAPTCHA v2 em cenários de automação, testes e extração de dados.

Perguntas Frequentes

1. Qual é a diferença entre ReCaptchaV2Task e ReCaptchaV2TaskProxyLess?

ReCaptchaV2Task requer que você forneça seu próprio proxy, enquanto ReCaptchaV2TaskProxyLess usa o proxy integrado da CapSolver, tornando a configuração mais rápida e simples.

2. Quanto tempo leva para resolver um desafio de reCAPTCHA v2?

A maioria das tarefas é concluída em 1 a 10 segundos, dependendo da complexidade do desafio e da carga do sistema.

3. O token gRecaptchaResponse é reutilizável?

Não. O token é limitado no tempo e geralmente válido para uma única tentativa de verificação. Sempre solicite um novo token para cada desafio de reCAPTCHA.

4. Preciso de um navegador para usar a CapSolver?

Não. A CapSolver funciona totalmente via API e pode ser integrada a serviços de backend, scripts ou frameworks de automação sem precisar iniciar um navegador.