Cómo resolver reCaptcha v2 usando Puppeteer [Javascript] con la extensión Capsolver

Introducción

Automatizar las interacciones del navegador a menudo requiere manejar desafíos CAPTCHA, especialmente cuando se trabaja con herramientas como Puppeteer. En esta guía, explicaremos cómo configurar Puppeteer JS con la extensión CapSolver para resolver reCAPTCHA v2 de manera eficiente. Aunque este tutorial se centra en reCAPTCHA v2, el mismo enfoque puede extenderse a otros tipos de CAPTCHA compatibles con CapSolver.

Al final de este artículo, comprenderá cómo instalar las dependencias requeridas, configurar la extensión CapSolver, y activar la resolución de CAPTCHA directamente dentro de una sesión de navegador controlada por Puppeteer.

1. Instalación de componentes de puppeteer

⚠️ En este blog, explicaremos cómo configurar Puppeteer JS con la extensión CapSolver para resolver reCAPTCHA v2. Sin embargo, este enfoque también se puede aplicar a otros tipos de CAPTCHA.

npm i puppeteer puppeteer-extra puppeteer-extra-plugin-stealth

2. Configuración de la extensión

Descargue el archivo con la extensión, y descomprímalo en la carpeta ./CapSolver.Browser.Extension en la raíz del proyecto.

La extensión tiene muchas configuraciones, incluyendo la resolución automática de CAPTCHA, soporte para proxies y opciones de control detallado. Estas configuraciones están disponibles en el archivo ./assets/config.json.

Estas configuraciones son:

{
    "apiKey": "SuApiKey",
    "useCapsolver": true,

    "useProxy": false,
    "proxyType": "http",
    "hostOrIp": "",
    "port": "",
    "proxyLogin": "",
    "proxyPassword": "",

    "enabledForBlacklistControl": false,
    "blackUrlList": [],

    "enabledForRecaptcha": true,
    "enabledForRecaptchaV3": true,
    "enabledForcaptcha": true,

    "reCaptchaMode": "token",
    "captchaMode": "click",

    "reCaptchaDelayTime": 0,
    "captchaDelayTime": 0,

    "reCaptchaRepeatTimes": 10,
    "reCaptcha3RepeatTimes": 10,
    "captchaRepeatTimes": 10
}

Ingrese su clave de API en el archivo de configuración de la extensión ./assets/config.json. La clave debe asignarse al campo apiKey. Puede copiar su clave de API directamente desde el panel de control de CapSolver.

Ejemplo:

apiKey: "CAP-4FDBD3SDFSD-23S-2-3"

En este ejemplo, reCaptchaMode está configurado como token. Aunque también está disponible el modo click, se recomienda generalmente el modo token para reCAPTCHA.

3. Configuración de Puppeteer para resolver reCAPTCHA con la extensión CapSolver

const puppeteer = require('puppeteer-extra');
const StealthPlugin = require('puppeteer-extra-plugin-stealth');
const { executablePath } = require('puppeteer'); 

(async () => {
  const pathToExtension = require('path').join(__dirname, 'CapSolver.Browser.Extension');
  puppeteer.use(StealthPlugin())
  const browser = await puppeteer.launch({
    headless: false,
    args: [
      `--disable-extensions-except=${pathToExtension}`,
      `--load-extension=${pathToExtension}`,
    ],
    executablePath: executablePath()
  });
  
  const [page] = await browser.pages()
})();

A continuación, abra la página https://www.google.com/recaptcha/api2/demo y envíe el CAPTCHA a CapSolver.

Utilice page.goto() para navegar a la página objetivo. El CAPTCHA puede enviarse para su resolución automáticamente o manualmente.
En este ejemplo, lo activamos manualmente esperando al checkbox de CAPTCHA y haciendo clic en él.

await page.goto('https://site.example') 

// Esperando al elemento con el selector CSS "#recaptcha-anchor-label"
await page.waitForSelector('#recaptcha-anchor-label')
// Hacer clic en el elemento
await page.click('#recaptcha-anchor-label')

Código completo

const puppeteer = require('puppeteer-extra');
const StealthPlugin = require('puppeteer-extra-plugin-stealth');
const { executablePath } = require('puppeteer'); 

(async () => {
  const pathToExtension = require('path').join(__dirname, 'CapSolver.Browser.Extension');
  puppeteer.use(StealthPlugin())
  const browser = await puppeteer.launch({
    headless: false,
    args: [
      `--disable-extensions-except=${pathToExtension}`,
      `--load-extension=${pathToExtension}`,
    ],
    executablePath: executablePath()
  });
  
  const [page] = await browser.pages()

  // Abriendo una página
  await page.goto('https://site.example') 

  // Esperando al elemento con el selector CSS "#recaptcha-anchor-label"
  await page.waitForSelector('#recaptcha-anchor-label')
  // Hacer clic en el elemento
  await page.click('#recaptcha-anchor-label')
})();

Conclusión

Ha resuelto correctamente reCAPTCHA v2 usando Puppeteer y la extensión de navegador CapSolver. Esta configuración proporciona una forma flexible y escalable de manejar desafíos CAPTCHA directamente en un entorno de navegador real. Al ajustar la configuración de la extensión, el mismo flujo de trabajo puede reutilizarse para otros tipos de CAPTCHA compatibles con CapSolver, lo que lo hace adecuado para pruebas, automatización y tareas a gran escala basadas en navegadores.

Preguntas frecuentes (FAQs)

1. ¿Puede usarse este método en modo headless?
La extensión de navegador CapSolver requiere un entorno de navegador visible. Por esta razón, se recomienda headless: false al usar el enfoque basado en la extensión.

2. ¿Funciona esta configuración para otros tipos de CAPTCHA además de reCAPTCHA v2?
Sí. La extensión CapSolver admite múltiples tipos de CAPTCHA. Puede habilitar o deshabilitar solucionadores específicos en el archivo config.json y adaptar el flujo de trabajo en consecuencia.

3. ¿Es necesario un proxy al usar la extensión CapSolver?
Un proxy es opcional. La extensión admite la configuración de proxy, pero muchos casos de uso funcionan sin él. El uso de un proxy depende del sitio web objetivo y de los requisitos de automatización.

4. ¿Cuál es la diferencia entre los modos token y click para reCAPTCHA?
El modo token recupera la solución CAPTCHA de forma programática y es generalmente más estable para automatización. El modo click simula la interacción del usuario con la casilla de CAPTCHA.

5. ¿Puede usarse esta configuración en entornos de producción?
Sí. Con una configuración adecuada, manejo de errores y consideraciones de escalabilidad, este enfoque puede integrarse en flujos de automatización de navegadores de producción.