Como Identificar e Enviar Parâmetros Adicionais do reCAPTCHA (v2/v3/Enterprise) | Guia do CapSolver

Ao lidar com desafios anti-bot e CAPTCHA complexos, especialmente do reCAPTCHA da Google, fornecer apenas o sitekey e o pageurl muitas vezes não é suficiente para obter com sucesso uma resposta válida g-recaptcha-response. Muitos sites utilizam parâmetros adicionais para aprimorar sua segurança, exigindo que nossas soluções de automação identifiquem e enviem esse dado oculto com precisão.

Este artigo explora em detalhes os parâmetros comuns do reCAPTCHA, orienta como usar ferramentas profissionais como CapSolver para identificá-los e oferece um exemplo completo de submissão via API.

1. Conceitos Básicos: Compreendendo os Parâmetros Extras do reCAPTCHA

Esses parâmetros são geralmente definidos pelos sites para distinguir entre usuários normais e programas automatizados. Sua presença depende da configuração específica do site e da versão do reCAPTCHA utilizada.

1.1. Diferenças entre as Versões do reCAPTCHA

O reCAPTCHA possui várias versões principais, cada uma com requisitos diferentes de parâmetros:

1.2. Explicação dos Parâmetros Extras Principais

Nota Importante: Você deve incluir apenas um parâmetro em sua submissão se souber exatamente sua finalidade e tiver confirmado sua presença usando uma ferramenta de detecção. Adicionar parâmetros cegamente pode levar a falhas na validação.

2. Como Identificar com Precisão os Parâmetros Extras do reCAPTCHA

A melhor maneira de identificar esses parâmetros ocultos é usando uma extensão de navegador fornecida por um serviço profissional de resolução de CAPTCHA, como a extensão Captcha Solver Auto Solve do CapSolver.

Passo 1: Instale a Extensão do CapSolver

1. Para usuários do Chrome: Instale a extensão Captcha Solver Auto Solve.
2. Para usuários do Firefox: Instale a extensão Captcha Solver Auto Solve.

Passo 2: Use as Ferramentas de Desenvolvedor para Detecção

1. Navegue até o site com o reCAPTCHA que você precisa resolver.
2. Pressione F12 ou clique com o botão direito na página e selecione "Inspecionar" para abrir as Ferramentas de Desenvolvedor.
3. Alterne para a aba CapSolver Captcha Detector.
   
4. Mantenha o painel do CapSolver aberto e acione o reCAPTCHA na página (por exemplo, ao clicar em um botão de login ou recarregar a página).
5. A extensão capturará e analisará automaticamente todos os parâmetros necessários.

Passo 3: Obtenha os Dados de Submissão em JSON

Assim que os parâmetros forem capturados com sucesso, o painel da extensão do CapSolver exibirá imediatamente as informações necessárias em formato JSON. Este JSON pode ser usado diretamente em sua solicitação de API, garantindo que sua tarefa seja submetida com completude e precisão.

Lista de Parâmetros Detectáveis:

• URL do Site
• Chave do Site
• isInvisible
• pageAction
• isEnterprise
• isSRequired (indica se s-data/enterprisePayload é necessário)
• isReCaptchaV3
• Domínio da API
• Anchor
• Reload

3. Exemplo de Submissão via API: Inclusão de Parâmetros Extras

A API do CapSolver foi projetada para permitir que você submeta todos os parâmetros detectados através de uma interface unificada. Abaixo está um exemplo em Python usando a biblioteca requests para submeter uma tarefa do reCAPTCHA Enterprise, incluindo parâmetros extras como enterprisePayload e apiDomain.

import requests
import time

# Sua chave de API do CapSolver
API_KEY = "SUA_CHAVE_DE_API_DO_CAPSOLVER"

# Pontos finais da API
CREATE_TASK_URL = "https://api.capsolver.com/createTask"
GET_TASK_RESULT_URL = "https://api.capsolver.com/getTaskResult"

# Parâmetros detectados pela extensão do CapSolver
site_key = "6Lc_a_xxxxxxxxxxxxxxxxxxxxxxx"
page_url = "https://example.com/login"
enterprise_payload = "s-data-payload-da-extensão"

def solve_recaptcha():
    # 1. Crie a tarefa
    task_payload = {
        "clientKey": API_KEY,
        "task": {
            "type": "ReCaptchaV2EnterpriseTask",
            "websiteURL": page_url,
            "websiteKey": site_key,
            "enterprisePayload": {
                "s": enterprise_payload
            },
            "apiDomain": "www.recaptcha.net"
        }
    }

    try:
        response = requests.post(CREATE_TASK_URL, json=task_payload)
        response.raise_for_status()
        task_data = response.json()

        if task_data.get("errorId") == 0:
            task_id = task_data.get("taskId")
            print(f"Tarefa criada com sucesso. ID da tarefa: {task_id}")

            # 2. Aguarde o resultado
            while True:
                result_payload = {
                    "clientKey": API_KEY,
                    "taskId": task_id
                }
                result_response = requests.post(GET_TASK_RESULT_URL, json=result_payload)
                result_response.raise_for_status()
                result_data = result_response.json()

                if result_data.get("errorId") == 0:
                    status = result_data.get("status")
                    if status == "ready":
                        # Sucesso! Obtenha o token.
                        token = result_data["solution"]["gRecaptchaResponse"]
                        print(f"CAPTCHA resolvido! Token: {token[:30]}...")
                        return token
                    elif status == "processing":
                        print("A tarefa ainda está sendo processada, aguardando...")
                        time.sleep(5)  # Aguarde 5 segundos antes de verificar novamente
                    else:
                        print(f"A tarefa falhou. Status: {status}")
                        return None
                else:
                    print(f"Erro ao obter o resultado: {result_data.get('errorDescription')}")
                    return None
        else:
            print(f"Erro ao criar a tarefa: {task_data.get('errorDescription')}")
            return None

    except requests.exceptions.RequestException as e:
        print(f"Ocorreu um erro durante a solicitação da API: {e}")
        return None

if __name__ == '__main__':
    solve_recaptcha()

Perguntas Frequentes (FAQ)

Q1: Por que preciso enviar parâmetros extras?

A: Muitos sites usam recursos avançados do reCAPTCHA, como a versão Enterprise ou a análise de comportamento do v3, para aprimorar a segurança. Esses recursos exigem dados contextuais adicionais do cliente (como enterprisePayload ou pageAction) para funcionar corretamente. Se esses parâmetros estiverem ausentes, o serviço reCAPTCHA não conseguirá avaliar corretamente a solicitação, resultando em falha na tarefa.

Q2: Se eu não souber se um parâmetro existe, devo enviá-lo mesmo assim?

A: Isso não é recomendado. Você deve enviar apenas um parâmetro quando tiver confirmado que ele é necessário usando uma ferramenta como a extensão do CapSolver e obtido seu valor válido. Enviar parâmetros desnecessários ou incorretos pode causar falha na solicitação da API ou retornar um token inválido.

Q3: O que são os parâmetros Anchor e Reload? Preciso analisá-los manualmente?

A: Anchor e Reload são dados auxiliares capturados pela extensão do CapSolver em cenários específicos. Você não precisa analisá-los manualmente. O valor da extensão do CapSolver é capturar e fornecer esses parâmetros em formato JSON pronto para uso. Basta enviar o conjunto completo de parâmetros fornecido pela extensão para a API do CapSolver.

Q4: Qual a diferença entre pageAction do reCAPTCHA v3 e sitekey do v2?

A:

• sitekey (v2/v3): Identifica o site e é um parâmetro fundamental necessário para todas as versões do reCAPTCHA.
• pageAction (v3): Identifica a ação específica que o usuário está realizando na página atual (por exemplo, login, checkout). O reCAPTCHA v3 usa essa ação, juntamente com o comportamento do usuário, para retornar uma pontuação de risco. Este parâmetro não é usado no v2.

Conclusão e Leitura Recomendada

Dominar a identificação e submissão dos parâmetros extras do reCAPTCHA é essencial para a automação bem-sucedida. Ao utilizar ferramentas e APIs profissionais como as do CapSolver, você pode enfrentar com confiança até os desafios mais complexos de CAPTCHA.

Leitura Recomendada:

• Documentação da API do CapSolver - Aprenda mais sobre os tipos de tarefas do reCAPTCHA e seus parâmetros.
• Como Resolver o reCAPTCHA v3 - Obtenha uma visão aprofundada sobre o mecanismo de pontuação do v3 e sua solução.
• Tutorial da Extensão do CapSolver - Aprenda a maximizar as capacidades da extensão.

Resgate seu código promocional do CapSolver

Não perca a oportunidade de otimizar ainda mais suas operações! Use o código promocional CAPN ao recarregar sua conta do CapSolver e receba um bônus adicional de 5% em cada recarga, sem limites. Acesse o CapSolver para resgatar seu bônus agora!