Cómo identificar y enviar parámetros adicionales de reCAPTCHA (v2/v3/Enterprise) | Guía de CapSolver

Al enfrentarse a desafíos complejos de anti-bot y CAPTCHA, especialmente de reCAPTCHA de Google, simplemente proporcionar el sitekey y la pageurl a menudo no es suficiente para obtener con éxito una g-recaptcha-response válida. Muchos sitios web utilizan parámetros adicionales para mejorar su seguridad, lo que requiere que nuestras soluciones de automatización identifiquen y envíen correctamente estos datos ocultos.

Este artículo explora en profundidad los parámetros adicionales comunes en reCAPTCHA, guía sobre cómo utilizar herramientas profesionales como CapSolver para identificarlos y ofrece un ejemplo completo de envío a través de la API.

1. Conceptos básicos: Comprender los parámetros adicionales de reCAPTCHA

Estos parámetros suelen estar definidos por los sitios web para distinguir entre usuarios normales y programas automatizados. Su presencia depende de la configuración específica del sitio y de la versión de reCAPTCHA que se esté utilizando.

1.1. Diferencias entre versiones de reCAPTCHA

reCAPTCHA existe en varios tipos principales, cada uno con requisitos diferentes de parámetros:

1.2. Explicación de los parámetros clave

Nota importante: Debe incluir un parámetro en su envío solo si conoce su propósito exacto y ha confirmado su presencia utilizando una herramienta de detección. Añadir parámetros ciegamente puede provocar una validación fallida.

2. Cómo identificar con precisión los parámetros adicionales de reCAPTCHA

La mejor forma de identificar estos parámetros ocultos es utilizar una extensión de navegador proporcionada por un servicio profesional de resolución de CAPTCHA, como la extensión Captcha Solver Auto Solve de CapSolver.

Paso 1: Instalar la extensión de CapSolver

1. Para usuarios de Chrome: Instale la extensión Captcha Solver Auto Solve.
2. Para usuarios de Firefox: Instale la extensión Captcha Solver Auto Solve.

Paso 2: Usar las herramientas de desarrollador para la detección

1. Navegue hasta el sitio web con la reCAPTCHA que necesita resolver.
2. Presione F12 o haga clic derecho en la página y seleccione "Inspeccionar" para abrir las Herramientas de desarrollador.
3. Cambie a la pestaña CapSolver Captcha Detector.
   
4. Mantenga abierta la ventana de CapSolver y active la reCAPTCHA en la página (por ejemplo, haciendo clic en un botón de inicio de sesión o recargando la página).
5. La extensión capturará y analizará automáticamente todos los parámetros necesarios.

Paso 3: Obtener los datos de envío en formato JSON

Una vez que los parámetros se hayan capturado correctamente, el panel de la extensión de CapSolver mostrará inmediatamente la información necesaria en formato JSON. Este JSON se puede utilizar directamente en su solicitud de API, asegurando que su tarea de envío sea completa y precisa.

Lista de parámetros detectables:

• URL del sitio web
• Clave del sitio
• isInvisible
• pageAction
• isEnterprise
• isSRequired (indica si se necesita s-data/enterprisePayload)
• isReCaptchaV3
• Dominio de la API
• Anchor
• Reload

3. Ejemplo de envío a través de la API: Incluir parámetros adicionales

La API de CapSolver está diseñada para permitirle enviar todos los parámetros detectados a través de una interfaz unificada. A continuación se muestra un ejemplo en Python utilizando la biblioteca requests para enviar una tarea de reCAPTCHA Enterprise, incluyendo parámetros adicionales como enterprisePayload y apiDomain.

import requests
import time

# Su clave de API de CapSolver
API_KEY = "SU_CLAVE_DE_API_DE_CAPSOLVER"

# Puntos finales de la API
CREATE_TASK_URL = "https://api.capsolver.com/createTask"
GET_TASK_RESULT_URL = "https://api.capsolver.com/getTaskResult"

# Parámetros detectados por la extensión de CapSolver
site_key = "6Lc_a_xxxxxxxxxxxxxxxxxxxxxxx"
page_url = "https://example.com/login"
enterprise_payload = "s-data-payload-from-extension"

def solve_recaptcha():
    # 1. Crear la tarea
    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"Tarea creada correctamente. ID de tarea: {task_id}")

            # 2. Consultar el 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":
                        # ¡Éxito! Obtenga el token.
                        token = result_data["solution"]["gRecaptchaResponse"]
                        print(f"CAPTCHA resuelto! Token: {token[:30]}...")
                        return token
                    elif status == "processing":
                        print("La tarea aún está en proceso, esperando...")
                        time.sleep(5)  # Esperar 5 segundos antes de verificar nuevamente
                    else:
                        print(f"La tarea falló. Estado: {status}")
                        return None
                else:
                    print(f"Error al obtener el resultado: {result_data.get('errorDescription')}")
                    return None
        else:
            print(f"Error al crear la tarea: {task_data.get('errorDescription')}")
            return None

    except requests.exceptions.RequestException as e:
        print(f"Ocurrió un error durante la solicitud de la API: {e}")
        return None

if __name__ == '__main__':
    solve_recaptcha()

Preguntas frecuentes (FAQ)

P1: ¿Por qué necesito enviar parámetros adicionales?

R: Muchos sitios web utilizan funciones avanzadas de reCAPTCHA, como la versión Enterprise o el análisis de comportamiento de v3, para mejorar la seguridad. Estas funciones requieren datos contextuales adicionales del cliente (como enterprisePayload o pageAction) para funcionar correctamente. Si faltan estos parámetros, el servicio reCAPTCHA no puede evaluar adecuadamente la solicitud, lo que lleva a un fallo en la tarea.

P2: Si no sé si un parámetro existe, ¿debo intentar enviarlo de todos modos?

R: No se recomienda. Debe enviar un parámetro solo cuando haya confirmado que es necesario utilizando una herramienta como la extensión de CapSolver y haya obtenido su valor válido. Enviar parámetros innecesarios o incorrectos puede hacer que la solicitud de la API falle o devuelva un token inválido.

P3: ¿Qué son los parámetros Anchor y Reload? ¿Debo analizarlos yo mismo?

R: Anchor y Reload son puntos de datos auxiliares capturados por la extensión de CapSolver en escenarios específicos. No necesita analizarlos manualmente. El valor de la extensión de CapSolver es que detecta y proporciona estos parámetros en un formato listo para usar. Simplemente envíe el conjunto completo de parámetros proporcionado por la extensión a la API de CapSolver.

P4: ¿Cuál es la diferencia entre pageAction de reCAPTCHA v3 y sitekey de v2?

R:

• sitekey (v2/v3): Identifica el sitio web y es un parámetro fundamental requerido para todas las versiones de reCAPTCHA.
• pageAction (v3): Identifica la acción específica que el usuario está realizando en la página actual (por ejemplo, inicio de sesión, pago). reCAPTCHA v3 utiliza esta acción, junto con el comportamiento del usuario, para devolver una puntuación de riesgo. Este parámetro no se utiliza en v2.

Conclusión y lectura adicional

Dominar la identificación y el envío de los parámetros adicionales de reCAPTCHA es crucial para lograr una automatización exitosa. Al aprovechar herramientas y APIs profesionales como los de CapSolver, puede enfrentar con confianza incluso los desafíos más complejos de CAPTCHA.

Lectura recomendada:

• Documentación de la API de CapSolver - Aprenda más sobre los tipos de tareas de reCAPTCHA y sus parámetros.
• Cómo resolver reCAPTCHA v3 - Obtenga una visión profunda del mecanismo de puntuación de v3 y su solución.
• Tutorial de la extensión de CapSolver - Aprenda a maximizar las capacidades de la extensión.

¡Recupere su código de bonificación de CapSolver!

¡No pierda la oportunidad de optimizar aún más sus operaciones! Utilice el código de bonificación CAPN al recargar su cuenta de CapSolver y obtenga un 5% adicional en cada recarga, sin límites. Visite CapSolver para recuperar su bonificación ahora!