Introducción

reCAPTCHA v2 se utiliza ampliamente para proteger sitios web contra abuso automatizado, pero a menudo se convierte en un obstáculo importante para la automatización legítima, las pruebas y los flujos de trabajo de recolección de datos. Si está luchando por resolver reCAPTCHA v2 de forma programática, esta guía lo guiará a través de una solución confiable y eficiente utilizando la API de CapSolver.

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

Visión general: Resolver reCAPTCHA v2 con CapSolver

CapSolver proporciona 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 su solicitud de destino o en su flujo de automatización del navegador.

Crear una tarea

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

Aquí está la estructura del objeto de tarea:

• type: Requerido. Debe ser ReCaptchaV2Task o ReCaptchaV2TaskProxyLess.
• websiteURL: Requerido. Esta es la dirección web del sitio que utiliza reCAPTCHA v2.
• websiteKey: Requerido. Esta es la clave pública del dominio.
• proxy: Opcional. Si está usando un proxy, puede incluirlo aquí.
• isInvisible: Opcional. Si el reCAPTCHA no tiene pageAction, establezca esto en true.
• userAgent: Opcional. Si está emulando un navegador, incluya su User-Agent aquí.
• cookies: Opcional. Si necesita usar cookies, inclúalas aquí.

Aquí hay un ejemplo de solicitud:

{
  "clientKey": "SU_CLAVE_DE_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á un ID de tarea en la respuesta:

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

Obtener resultados

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

Aquí hay un ejemplo de solicitud:

{
    "clientKey": "SU_CLAVE_DE_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": "ready"
}

Resolver reCAPTCHA v2 con Python:

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

# Establezca la clave de API de CapSolver
# export CAPSOLVER_API_KEY='SU_CLAVE_DE_API'

import capsolver
# capsolver.api_key = 'SU_CLAVE_DE_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() {
    // Instale el SDK de CapSolver
    // go get github.com/capsolver/capsolver-go

    // Establezca la clave de API de CapSolver
    // export CAPSOLVER_API_KEY='SU_CLAVE_DE_API'
    // o
    // capSolver := CapSolver{apiKey:"SU_CLAVE_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, reemplace SU_CLAVE_DE_API con su clave de API real de CapSolver, y reemplace websiteURL y websiteKey con la URL del sitio y la clave del sitio reales para el desafío de reCAPTCHA que está intentando resolver.

Precios

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

Recursos adicionales

Para documentación más detallada sobre la resolución de reCAPTCHA v2, consulte:
https://docs.capsolver.com/en/guide/recognition/ReCaptchaClassification/

Redime tu código de bono de CapSolver

¡Aumente su presupuesto de automatización instantáneamente!
Use el código de bono CAPN al recargar su cuenta de CapSolver para obtener un 5% adicional en cada recarga — sin límites.
Redímelo ahora en su Panel de CapSolver
.

Conclusión

Resolver reCAPTCHA v2 no tiene por qué ser complejo o poco confiable. Con CapSolver, puede automatizar todo el proceso utilizando una API sencilla que admite soluciones basadas en proxy y sin proxy. Siguiendo los pasos descritos en esta guía — crear una tarea, recuperar el resultado y integrar el token de solución — puede 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 proporcione su 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 solicite un nuevo token para cada desafío de reCAPTCHA.

4. ¿Necesito un navegador para usar CapSolver?

No. CapSolver funciona completamente mediante API y se puede integrar en servicios backend, scripts o marcos de automatización sin lanzar un navegador.