Introducción

reCAPTCHA v2 se utiliza ampliamente para proteger sitios web contra abusos automatizados, pero a menudo se convierte en un obstáculo importante para flujos de trabajo de automatización, pruebas y recolección de datos legítimos. Si estás luchando por resolver reCAPTCHA v2 de forma programática, esta guía te mostrará una solución confiable y eficiente utilizando la API de CapSolver.

En este tutorial, aprenderás a crear y enviar una tarea de resolución de reCAPTCHA v2, recuperar el token de solución y integrar CapSolver en tu flujo de trabajo utilizando tanto Python como Go. Puedes elegir entre usar tus propios proxies con ReCaptchaV2Task o confiar en el proxy integrado de CapSolver mediante ReCaptchaV2TaskProxyLess.

Vista general: Resolver reCAPTCHA v2 con CapSolver

CapSolver ofrece un enfoque basado en API para resolver desafíos de reCAPTCHA v2 mediante:

1. Crear una tarea con los parámetros necesarios del sitio web
2. Enviar la tarea a CapSolver
3. Consultar el resultado
4. Recibir un token válido gRecaptchaResponse

Este token se puede inyectar en tu solicitud de destino o en tu flujo de automatización de navegador.

Crear una tarea

Para resolver reCAPTCHA v2, primero necesitas crear una tarea utilizando el método createTask.

Estructura del objeto de tarea:

• type: Requerido. Debe ser ReCaptchaV2Task o ReCaptchaV2TaskProxyLess.
• websiteURL: Requerido. Es la dirección web del sitio que utiliza reCAPTCHA v2.
• websiteKey: Requerido. Es la clave pública del dominio.
• proxy: Opcional. Si estás usando un proxy, puedes incluirlo aquí.
• isInvisible: Opcional. Si reCAPTCHA no tiene pageAction, establece este valor en true.
• userAgent: Opcional. Si estás emulando un navegador, incluye su Agente de usuario aquí.
• cookies: Opcional. Si necesitas usar cookies, inclúyelas aquí.

Aquí tienes un ejemplo de solicitud:

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

Una vez que la tarea se haya enviado correctamente, recibirás un ID de tarea en la respuesta:

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

Obtener resultados

Una vez que tengas el ID de tarea, puedes usarlo para recuperar la solución. Envía el ID de tarea con el método getTaskResult. Los resultados deberían estar listos en un intervalo de 1s a 10s.

Aquí tienes un ejemplo de solicitud:

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

La respuesta incluirá el token de solución:

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "userAgent": "xxx", 
        "expireTime": 1671615324290, 
        "gRecaptchaResponse": "3AHJ....." // Este es el token de solución
    },
    "status": "listo"
}

Resolver reCAPTCHA v2 con Python:

# Instalar el SDK de CapSolver
# pip install --upgrade capsolver

# Establecer la clave de API de CapSolver
# export CAPSOLVER_API_KEY='TU_CLAVE_API'

import capsolver
# capsolver.api_key = 'TU_CLAVE_API'

# Resolver un desafío de reCAPTCHA v2
solution = capsolver.solve({
    "type": "ReCaptchaV2TaskProxyLess",
    "websiteURL": "url del sitio",
    "websiteKey": "clave del sitio",
})

Resolver reCAPTCHA v2 con GO:

package main

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

func main() {
    // Instalar el SDK de CapSolver
    // go get github.com/capsolver/capsolver-go

    // Establecer la clave de API de CapSolver
    // export CAPSOLVER_API_KEY='TU_CLAVE_API'
    // o
    // capSolver := CapSolver{apiKey:"TU_CLAVE_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, reemplaza TU_CLAVE_API con tu clave real de CapSolver, y reemplaza websiteURL y websiteKey con la URL y clave del sitio web para el desafío de reCAPTCHA que estás intentando resolver.

Precios

Para obtener información detallada sobre precios, por favor visita la página oficial de precios de CapSolver:
https://www.capsolver.com/#pricing

Recursos adicionales

Para más documentación detallada sobre resolver reCAPTCHA v2, consulta:
https://docs.capsolver.com/en/guide/recognition/ReCaptchaClassification/

Canjear su código de bonificación de CapSolver

Aumenta tu presupuesto de automatización de inmediato!
Usa el código de bonificación CAPN al recargar tu cuenta de CapSolver para obtener un 5% adicional en cada recarga — sin límites.
Canjéalo ahora en tu Panel de CapSolver
.

Conclusión

Resolver reCAPTCHA v2 no tiene por qué ser complejo o poco confiable. Con CapSolver, puedes automatizar todo el proceso utilizando una API sencilla que admite soluciones con y sin proxy. Siguiendo los pasos descritos en esta guía — crear una tarea, recuperar el resultado y integrar el token de solución — podrás evitar eficientemente reCAPTCHA v2 en escenarios de automatización, pruebas y extracción de datos.

Preguntas frecuentes

1. ¿Cuál es la diferencia entre ReCaptchaV2Task y ReCaptchaV2TaskProxyLess?

ReCaptchaV2Task requiere que proporciones tu propio proxy, mientras que ReCaptchaV2TaskProxyLess utiliza el proxy integrado de CapSolver, lo que hace que la configuración sea más rápida y sencilla.

2. ¿Cuánto tiempo tarda en resolver un desafío de reCAPTCHA v2?

La mayoría de las tareas se completan en 1 a 10 segundos, dependiendo de la complejidad del desafío y la carga del sistema.

3. ¿Es reutilizable el token gRecaptchaResponse?

No. El token tiene un límite de tiempo y generalmente es válido para un solo intento de verificación. Siempre solicita un nuevo token para cada desafío de reCAPTCHA.

4. ¿Necesito un navegador para usar CapSolver?

No. CapSolver funciona completamente a través de API y se puede integrar en servicios backend, scripts o marcos de automatización sin necesidad de iniciar un navegador.