Cómo resolver reCAPTCHA v3 con Python

Automatizar Google Search, herramientas de SEO o la recopilación de datos a menudo requiere interactuar con sitios web protegidos por reCAPTCHA v3. A diferencia de la v2, reCAPTCHA v3 no muestra una casilla de verificación, asigna silenciosamente una puntuación de riesgo (0.0–1.0). Para realizar una automatización estable y obtener una puntuación similar a la humana (0.7–0.9), necesitas tanto la implementación correcta como un solucionador confiable.
Este guía te muestra cómo resolver reCAPTCHA v3 usando Python y CapSolver, con un script listo para usar, consejos de configuración clave y mejores prácticas para evitar obtener puntuaciones bajas.

⚙️ Requisitos previos

• Python instalado
• Clave de API de CapSolver

¿Por qué estos requisitos previos son importantes?
Python permite una integración sencilla con solucionadores basados en API, mientras que la clave de API de CapSolver identifica tu cuenta y asegura que la solicitud reciba una puntuación similar a la humana de alta calidad. reCAPTCHA v3 es muy sensible a la simulación del comportamiento del usuario, por lo tanto, usar una API optimizada es crucial.

🤖 Paso 1: Instalar los paquetes necesarios

Ejecuta los siguientes comandos para instalar los paquetes requeridos:

pip install capsolver

⚡ Consejo: Usar un entorno virtual (por ejemplo, venv o conda) ayuda a aislar las dependencias y evitar conflictos con otros proyectos de Python.

👨‍💻 Paso 2: Código Python para resolver reCaptcha v3 y obtener una puntuación de 0.7-0.9

Aquí tienes un script de ejemplo en Python para realizar la tarea:

import json
import os
import capsolver
from urllib.parse import urlparse

# Cambie estos valores
capsolver.api_key = "SuClaveDeApi"
PAGE_URL = ""
PAGE_KEY  = ""
PAGE_ACTION = ""

def solve_recaptcha_v3(url,key,pageAction):
    solution = capsolver.solve({
        "type": "ReCaptchaV3TaskProxyLess",
        "websiteURL": url,
        "websiteKey":key,
        "pageAction":pageAction
    })
    return solution


def main():

    print("Resolviendo reCaptcha v3")
    solution = solve_recaptcha_v3(PAGE_URL, PAGE_KEY, PAGE_ACTION)
    print("Solución: ", solution)

if __name__ == "__main__":
    main()

📌 Explicación adicional

• clave del sitio web
  Esta es típicamente el valor data-sitekey incrustado en el HTML del sitio objetivo. Puedes encontrarlo mediante las Herramientas de desarrollo del navegador o solicitudes de red.

• acción de la página
  Google utiliza pageAction para categorizar las interacciones del usuario. Establecerlo correctamente aumenta significativamente la precisión de la puntuación. Puedes consultar el blog vinculado para extraer valores reales de pageAction.

• ReCaptchaV3TaskProxyLess
  Este modo se recomienda cuando el sitio web no requiere un navegador con proxy. Si el sistema devuelve puntuaciones anormalmente bajas, podrías considerar un tipo de tarea con proxy para simular la localidad del usuario.

• Estructura del resultado
  CapSolver devuelve una cadena de token (g-recaptcha-response) que debes pasar de vuelta al formulario del sitio objetivo o al punto final de la API durante la presentación.

Este ejemplo de código se enfoca en la claridad, pero en scripts de producción, también podrías querer:
✓ Agregar lógica de reintentos
✓ Registrar respuestas
✓ Agregar manejo de excepciones para redes/timeout
✓ Validar tokens antes de la presentación

⚠️ Cambie estas variables

• capsolver.api_key: Obtenga su clave de API desde el Panel de control de CapSolver
• PAGE_URL: Reemplácelo con la URL del sitio web para el cual desea resolver el reCaptcha v3.
• PAGE_KEY: Actualícelo con la clave específica del sitio con reCAPTCHA.
• PAGE_ACTION: Reemplácelo con la acción de la página. Puede leer este blog

👀 Más información

• Cómo resolver reCAPTCHA v3 y obtener una puntuación de 0.7-0.9 como un humano
• Resolver todos los tipos de reCAPTCHA v2 / v2 invisible / v2 enterprise / v3 / v3 enterprise

✅ Conclusión

Resolver reCAPTCHA v3 de manera confiable es esencial para tareas de automatización como la extracción de datos de SEO, el raspado de resultados de búsqueda de Google (SERP) y la automatización de flujos de trabajo de alto volumen. Con Python y la API de CapSolver, puedes generar puntuaciones similares a las humanas estables (0.7–0.9) y evitar páginas de desafío, incluso en sitios muy protegidos.
Seguir los consejos de configuración anteriores asegura tasas de éxito más altas y una integración más fluida en tu flujo de automatización.

❓ Preguntas frecuentes

1. ¿Qué es reCAPTCHA v3 y cómo se diferencia de la v2?

reCAPTCHA v3 utiliza un sistema basado en puntuaciones en lugar de desafíos o pruebas de imágenes. Analiza silenciosamente el comportamiento del usuario y asigna una puntuación de 0.0 a 1.0. Las puntuaciones más altas indican actividad similar a la humana, mientras que los bots suelen recibir puntuaciones bajas.

2. ¿Cómo puedo encontrar la sitekey requerida para resolver reCAPTCHA v3?

Puedes inspeccionar el HTML de la página web usando las Herramientas de desarrollo de Chrome. Busca el atributo data-sitekey o revisa la carga del script de la biblioteca reCAPTCHA.

3. ¿Qué es pageAction y por qué es importante?

El parámetro pageAction identifica el tipo de interacción en el sitio web, como iniciar sesión, enviar o buscar. Una acción de página incorrecta puede llevar a puntuaciones bajas o rechazos.

4. ¿Por qué mi puntuación de reCAPTCHA v3 sigue siendo baja?

Causas comunes incluyen la falta de pageAction, sitekey incorrecto, proxies de baja calidad (si se usan) o fallar en imitar el comportamiento real del navegador. Usar la configuración optimizada de CapSolver ayuda a mejorar la puntuación.

5. ¿Puede integrarse esta solución con Selenium, Playwright o Puppeteer?

Sí. Después de obtener el token usando CapSolver, puedes inyectarlo en formularios o variables de JavaScript dentro de cualquier navegador automatizado, incluyendo Selenium o Playwright.