Cómo resolver reCAPTCHA v2 con Python

TL;DR

• Esta guía muestra cómo resolver reCAPTCHA v2 usando Python y CapSolver, con ambos tipos de tarea Proxy y Proxyless.
• Incluye explicaciones más profundas, consejos comunes para resolver problemas y ejemplos ampliados para escenarios de automatización del mundo real.
• Ideal para desarrolladores que trabajan en scraping, automatización de SEO, extracción de datos de SERP, bots para rellenar formularios y pipelines de pruebas de CI.

Introducción

La reCAPTCHA v2 de Google se utiliza ampliamente para bloquear el tráfico automatizado.
Si estás construyendo scrapers, flujos de automatización, creadores de cuentas, subidores de formularios en línea o herramientas de SERP, resolver la reCAPTCHA v2 es prácticamente obligatorio.

Esta guía ampliada te lleva a través de:

• Instalación
• Cómo funciona cada tipo de tarea
• Ejemplos detallados en Python
• Cuándo usar proxy / sin proxy
• Manejo de errores
• Notas clave para implementaciones en objetivos de alto valor

⚙️ Requisitos previos

• Un proxy funcional (Opcional, lee ambos ejemplos, ya que uno requiere proxy y otro no)
• Python instalado
• Clave de API de CapSolver

🤖 Instalar paquetes necesarios

Ejecuta los siguientes comandos para instalar los paquetes requeridos:

pip install capsolver

👨‍💻 Código Python para resolver reCaptcha v2 con tu proxy

Aquí tienes un script de Python de muestra para lograr la tarea:

import capsolver

# Considera usar variables de entorno para información sensible
PROXY = "http://username:password@host:port"
capsolver.api_key = "Tu clave de API de Capsolver"
PAGE_URL = "URL_DE_PÁGINA"
PAGE_KEY = "CLAVE_DE_SITIO_DE_PÁGINA"

def solve_recaptcha_v2(url,key):
    solution = capsolver.solve({
        "type": "ReCaptchaV2Task",
        "websiteURL": url,
        "websiteKey":key,
        "proxy": PROXY
    })
    return solution


def main():
    print("Resolviendo reCaptcha v2")
    solution = solve_recaptcha_v2(PAGE_URL, PAGE_KEY)
    print("Solución: ", solution)

if __name__ == "__main__":
    main()

👨‍💻 Código Python para resolver reCaptcha v2 sin proxy

Aquí tienes un script de Python de muestra para lograr la tarea:

import capsolver

# Considera usar variables de entorno para información sensible
capsolver.api_key = "Tu clave de API de Capsolver"
PAGE_URL = "URL_DE_PÁGINA"
PAGE_KEY = "CLAVE_DE_SITIO_DE_PÁGINA"

def solve_recaptcha_v2(url,key):
    solution = capsolver.solve({
        "type": "ReCaptchaV2TaskProxyless",
        "websiteURL": url,
        "websiteKey":key,
    })
    return solution



def main():
    print("Resolviendo reCaptcha v2")
    solution = solve_recaptcha_v2(PAGE_URL, PAGE_KEY)
    print("Solución: ", solution)

if __name__ == "__main__":
    main()

⚠️ Cambia estas variables

• PROXY: Actualiza con tus detalles de proxy. El formato debe ser http://username:password@ip:port. SOLO REQUERIDO con ReCaptchaV2Task
• capsolver.api_key: Obtén tu clave de API desde el Dashboard de Capsolver.
• PAGE_URL: Reemplázalo con la URL del sitio web para el cual deseas resolver la reCaptcha v2.
• PAGE_KEY: Reemplázalo con la clave del sitio del sitio web para el cual deseas resolver la reCaptcha v2.

📌 Conclusión

Resolver reCAPTCHA v2 de manera confiable es esencial para la automatización moderna — ya sea que estés ejecutando pipelines de scraping a gran escala, automatizando la presentación de formularios, extrayendo datos de SERP o construyendo agentes de inteligencia artificial personalizados que interactúen con la web. Con CapSolver, todo el proceso se vuelve mucho más predecible, estable y escalable.
Al elegir el tipo de tarea correcto (Proxy vs Proxyless), validar tus claves de sitio y asegurar que tu configuración de proxy sea sólida, puedes lograr resoluciones casi instantáneas de CAPTCHA con un mínimo de sobrecarga.

Preguntas frecuentes

1. ¿Necesito un proxy para cada sitio web?

No — muchos sitios web funcionan perfectamente con la tarea Proxyless. Solo necesitas proxies para objetivos de alto valor (por ejemplo, mercados, plataformas de boletos, Google Search, flujos de inicio de sesión, etc.).

2. ¿Qué tipo de proxy funciona mejor con reCAPTCHA v2?

Los proxies residenciales o de proveedores de servicios de Internet ofrecen la mejor estabilidad.
Los proxies de centros de datos pueden funcionar, pero a menudo se detectan en sitios de alto valor.

3. ¿Qué tan rápido devuelve CapSolver el token?

La mayoría de las tareas de reCAPTCHA v2 se resuelven en 1–5 segundos, dependiendo de la dificultad del sitio y la carga de la cola.

4. ¿Puedo reutilizar el mismo token varias veces?

No. Cada token es de uso único y expira muy rápidamente (normalmente dentro de ~120 segundos).

👀 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

¡Aumenta tu presupuesto de automatización instantáneamente!
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 Dashboard de CapSolver

🧾 Puntos clave

• Usa ReCaptchaV2Task + buen proxy para objetivos de alto valor.
• Usa Proxyless solo para sitios menos protegidos.
• CapSolver simplifica drásticamente la integración — solo llama a capsolver.solve().
• La reCAPTCHA v2 se vuelve más estricta cada año; solucionadores estables son esenciales para flujos de trabajo de producción.
• Siempre verifica cuidadosamente la clave del sitio y la URL — el 90% de los errores de principiantes vienen de claves del sitio incorrectas.