C¨®mo resolver CAPTCHA en BrowserCloud con la API de CapSolver

Alo¨ªsio V¨ªtor
Image Processing Expert
11-Sep-2025
BrowserCloud es una plataforma de automatizaci¨®n de navegadores basada en la nube y de alto rendimiento, dise?ada para la automatizaci¨®n web escalable y distribuida. Permite a los desarrolladores ejecutar cientos de navegadores Chrome sin cabeza en paralelo para casos de uso como raspado web, pruebas automatizadas, monitoreo de SEO, extracci¨®n de datos y generaci¨®n de contenido. Con soporte integrado para Puppeteer, Selenium y Playwright, BrowserCloud simplifica los flujos de trabajo de automatizaci¨®n complejos al ofrecer rotaci¨®n de proxies, administraci¨®n de sesiones y monitoreo en tiempo real.
Sin embargo, los CAPTCHA, los sistemas de detecci¨®n de bots y las medidas avanzadas contra la automatizaci¨®n a menudo interrumpen estas tareas de automatizaci¨®n del navegador al exigir interacciones similares a las humanas para verificar la autenticidad. Tales barreras pueden bloquear los scripts de raspado, ralentizar las canalizaciones de prueba e interrumpir los env¨ªos de formularios automatizados, lo que resulta en p¨¦rdida de tiempo y reducci¨®n de la eficiencia.
CapSolver, un servicio de derivaci¨®n de CAPTCHA y detecci¨®n de bots con tecnolog¨ªa de IA, proporciona una soluci¨®n confiable. Detecta y resuelve program¨¢ticamente una amplia gama de tipos de CAPTCHA, incluidos reCAPTCHA v2/v3, Cloudflare Turnstile y rompecabezas basados en im¨¢genes, lo que garantiza flujos de trabajo de automatizaci¨®n del navegador ininterrumpidos.
En este art¨ªculo, proporcionaremos una gu¨ªa de integraci¨®n paso a paso para conectar CapSolver con BrowserCloud usando Puppeteer, junto con un ejemplo de c¨®digo completamente funcional. Al seguir esta gu¨ªa, podr¨¢ omitir sin problemas los desaf¨ªos de CAPTCHA, derrotar las medidas anti-bot y maximizar la eficiencia de sus scripts de automatizaci¨®n.
Descripci¨®n general y casos de uso de BrowserCloud
BrowserCloud es una plataforma vers¨¢til que gestiona una cuadr¨ªcula de navegadores Chrome con todas las funciones en una infraestructura de alto rendimiento, eliminando la necesidad de manejar dependencias de navegadores locales, fugas de memoria o mantenimiento de la infraestructura. Sus caracter¨ªsticas clave incluyen:
- Escalabilidad: Ejecute hasta 100 navegadores sin cabeza simult¨¢neamente para el procesamiento paralelo.
- Soporte de framework: Compatible con Puppeteer, Selenium y Playwright para una automatizaci¨®n flexible.
- Administraci¨®n de proxies: Ofrece rotaci¨®n inteligente de proxies y proxies premium para evitar la detecci¨®n y las prohibiciones de IP.
- Generaci¨®n de contenido: Genere archivos PDF, capturas de pantalla e im¨¢genes desde p¨¢ginas web o HTML personalizado a trav¨¦s de la API.
- Monitoreo en tiempo real: Proporciona herramientas para la administraci¨®n de sesiones y la depuraci¨®n.
Casos de uso
BrowserCloud admite una gama de tareas de automatizaci¨®n, que incluyen:
- Raspado web: Extraiga datos de sitios web para investigaci¨®n de mercado, monitoreo de precios o agregaci¨®n de contenido, aprovechando el soporte de proxy para evitar bloqueos.
- Pruebas automatizadas: Realice pruebas de extremo a extremo en m¨²ltiples navegadores y configuraciones para garantizar la confiabilidad de la aplicaci¨®n.
- Renderizado de contenido: Cree miles de informes PDF, facturas o capturas de pantalla automatizadas desde URL para fines de informes o marketing.
- Automatizaci¨®n de tareas: Automatice tareas repetitivas como env¨ªos de formularios, inicios de sesi¨®n de cuentas o validaci¨®n de enlaces.
Estos casos de uso a menudo encuentran CAPTCHA, lo que hace que la integraci¨®n de CapSolver sea esencial para una automatizaci¨®n ininterrumpida.
Por qu¨¦ se necesita la resoluci¨®n de CAPTCHA
Los sitios web implementan CAPTCHA y defensas anti-bot para protegerse contra el acceso automatizado, el correo no deseado y las actividades maliciosas, lo que representa un desaf¨ªo significativo para las tareas de automatizaci¨®n como el raspado web. Los CAPTCHA requieren interacciones como marcar casillas de verificaci¨®n o resolver rompecabezas de im¨¢genes, lo que puede detener los scripts de BrowserCloud si no se abordan. Los tipos de CAPTCHA comunes incluyen:
Tipo de CAPTCHA | Descripci¨®n |
---|---|
reCAPTCHA v2 | Requiere que los usuarios marquen una casilla o seleccionen im¨¢genes seg¨²n un mensaje. |
reCAPTCHA v3 | Utiliza un sistema de puntuaci¨®n para evaluar el comportamiento del usuario, a menudo invisible para los usuarios. |
Cloudflare Turnstile | Una alternativa de CAPTCHA centrada en la privacidad que minimiza la interacci¨®n del usuario. |
Para el raspado web y otras tareas de automatizaci¨®n, los CAPTCHA pueden impedir el acceso a datos cr¨ªticos, lo que requiere una intervenci¨®n manual que anula el prop¨®sito de la automatizaci¨®n. Si bien la rotaci¨®n de proxy de BrowserCloud ayuda a reducir los activadores de CAPTCHA, es posible que no los elimine por completo. La API de CapSolver proporciona una soluci¨®n confiable al resolver CAPTCHA program¨¢ticamente, permitiendo que los scripts de BrowserCloud omitan estas barreras y contin¨²en extrayendo datos o realizando tareas sin problemas.
C¨®mo usar CapSolver para manejar CAPTCHA
La API de CapSolver se puede integrar con BrowserCloud dentro de un script Puppeteer/Playwright/Selenium para manejar CAPTCHA de manera efectiva. El proceso implica:
- Detectar el CAPTCHA: Identifique la presencia de un CAPTCHA en la p¨¢gina, como un elemento reCAPTCHA.
- Extraer informaci¨®n: Recupere los detalles necesarios, como la clave del sitio y la URL de la p¨¢gina, necesarios para resolver el CAPTCHA.
- Llamar a la API de CapSolver: Env¨ªe una solicitud a CapSolver para crear una tarea y obtener un token de soluci¨®n.
- Inyectar la soluci¨®n: Inserte el token en la p¨¢gina para omitir el CAPTCHA.
- Continuar la automatizaci¨®n: Contin¨²e con tareas como el env¨ªo de formularios o la extracci¨®n de datos.
Esta integraci¨®n aprovecha la infraestructura de navegador escalable de BrowserCloud y las capacidades de resoluci¨®n de CAPTCHA impulsadas por IA de CapSolver para garantizar flujos de trabajo de automatizaci¨®n robustos.
Ejemplo de c¨®digo completo + Explicaci¨®n paso a paso
A continuaci¨®n, se muestra un ejemplo de c¨®digo completo que demuestra c¨®mo integrar CapSolver con BrowserCloud para resolver un reCAPTCHA v2 en una p¨¢gina de demostraci¨®n. El c¨®digo se basa en el script proporcionado, con mejoras menores para mayor claridad y confiabilidad.
Requisitos previos
Instale las dependencias necesarias:
bash
npm install puppeteer node-fetch@2 dotenv
Cree un archivo .env
con sus claves de API:
env
BROWSER_CLOUD_TOKEN=su_token_de_browsercloud
CAPSOLVER_API_KEY=su_clave_de_api_de_capsolver
Ejemplo de c¨®digo
javascript
import puppeteer from 'puppeteer';
import fetch from 'node-fetch';
import dotenv from 'dotenv';
dotenv.config();
const BROWSER_CLOUD_TOKEN = process.env.BROWSER_CLOUD_TOKEN;
const CAPSOLVER_API_KEY = process.env.CAPSOLVER_API_KEY;
async function solveCaptcha(sitekey, pageUrl) {
const createTaskRes = await fetch('https://api.capsolver.com/createTask', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
clientKey: CAPSOLVER_API_KEY,
task: {
type: 'ReCaptchaV2TaskProxyless',
websiteURL: pageUrl,
websiteKey: sitekey
}
})
});
const createTask = await createTaskRes.json();
if (!createTask.taskId) throw new Error(`CapSolver: Error al crear la tarea: ${JSON.stringify(createTask)}`);
let solution = null;
while (true) {
await new Promise(resolve => setTimeout(resolve, 2000));
const resultRes = await fetch('https://api.capsolver.com/getTaskResult', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
clientKey: CAPSOLVER_API_KEY,
taskId: createTask.taskId
})
});
const result = await resultRes.json();
if (result.status === 'ready') {
solution = result.solution.gRecaptchaResponse;
break;
}
if (result.status === 'failed') throw new Error(`CapSolver: Error al resolver: ${JSON.stringify(result)}`);
}
if (!solution) throw new Error('CapSolver: Tiempo de espera agotado esperando la soluci¨®n');
return solution;
}
(async () => {
try {
const browser = await puppeteer.connect({
browserWSEndpoint: `wss://chrome-v2.browsercloud.io?token=${BROWSER_CLOUD_TOKEN}`
});
const page = await browser.newPage();
await page.goto('https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php', { waitUntil: 'networkidle2' });
const sitekey = await page.$eval('.g-recaptcha', el => el.getAttribute('data-sitekey'));
console.log('Sitekey:', sitekey);
const solution = await solveCaptcha(sitekey, page.url());
console.log('Soluci¨®n CAPTCHA:', solution);
await page.evaluate(token => {
const textarea = document.getElementById('g-recaptcha-response');
if (textarea) {
textarea.value = token;
textarea.innerHTML = token;
textarea.style.display = '';
textarea.dispatchEvent(new Event('input', { bubbles: true }));
}
}, solution);
const submitBtn = await page.$('body > main > form > fieldset > button');
if (submitBtn) {
await Promise.all([
page.waitForNavigation({ waitUntil: 'networkidle2' }),
submitBtn.click()
]);
console.log('?Bot¨®n de enviar pulsado!');
} else {
console.log('?Bot¨®n de enviar no encontrado!');
}
console.log('Contenido de la p¨¢gina despu¨¦s del env¨ªo:', await page.content());
await browser.close();
} catch (error) {
console.error('Error:', error);
}
})();
Explicaci¨®n paso a paso
Paso | Descripci¨®n |
---|---|
1. Configurar el entorno | Instale puppeteer , node-fetch@2 y dotenv usando npm. Cree un archivo .env con sus claves de API de BrowserCloud y CapSolver. |
2. Definir la funci¨®n solveCaptcha | La funci¨®n toma la clave del sitio y la URL de la p¨¢gina, crea una tarea CapSolver para reCAPTCHA v2, sondea la soluci¨®n (hasta 30 intentos con intervalos de 2 segundos) y devuelve el token de soluci¨®n. |
3. Conectarse a BrowserCloud | Use puppeteer.connect con el punto final de WebSocket de BrowserCloud, incluyendo su token de API. Tenga en cuenta que createIncognitoBrowserContext no es compatible con el modo remoto de BrowserCloud, as¨ª que use browser.newPage() directamente. |
4. Navegar a la p¨¢gina de destino | Abra una nueva p¨¢gina y navegue a la p¨¢gina de demostraci¨®n con reCAPTCHA v2, esperando a que la red est¨¦ inactiva. |
5. Extraer la clave del sitio | Use page.$eval para recuperar el atributo data-sitekey del elemento .g-recaptcha . |
6. Resolver CAPTCHA | Llame a solveCaptcha con la clave del sitio y la URL de la p¨¢gina para obtener el token de soluci¨®n de CapSolver. |
7. Inyectar la soluci¨®n | Inyecte el token de soluci¨®n en el ¨¢rea de texto g-recaptcha-response y env¨ªe un evento de entrada para simular la interacci¨®n del usuario. |
8. Enviar formulario | Localice el bot¨®n de enviar, haga clic en ¨¦l y espere a la navegaci¨®n para asegurarse de que se procese el env¨ªo del formulario. |
9. Verificar el resultado | Imprima el contenido de la p¨¢gina para confirmar el env¨ªo exitoso. |
10. Cerrar el navegador | Cierre la conexi¨®n del navegador para liberar recursos. |
Nota: El c¨®digo original usaba page.waitForTimeout(3000)
despu¨¦s de hacer clic en el bot¨®n de enviar, lo que puede no esperar de manera confiable la navegaci¨®n. Este ejemplo lo mejora utilizando page.waitForNavigation()
para asegurar que la p¨¢gina se haya cargado completamente despu¨¦s del env¨ªo.
Recorrido de la demostraci¨®n
Esta secci¨®n describe la ejecuci¨®n del script en una p¨¢gina de demostraci¨®n con una casilla de verificaci¨®n reCAPTCHA v2:
- Conexi¨®n a BrowserCloud: El script establece una conexi¨®n a una instancia de navegador BrowserCloud usando Puppeteer.
- Navegaci¨®n a la p¨¢gina de demostraci¨®n: Carga la p¨¢gina de demostraci¨®n reCAPTCHA v2 (https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php).
- Detecci¨®n y extracci¨®n de la clave del sitio: El script identifica el elemento reCAPTCHA y extrae su clave del sitio.
- Resolver CAPTCHA: Env¨ªa la clave del sitio y la URL de la p¨¢gina a CapSolver, recibiendo un token de soluci¨®n despu¨¦s de sondear.
- Inyectar token: El token se inyecta en el ¨¢rea de texto
g-recaptcha-response
, simulando una verificaci¨®n exitosa de CAPTCHA. - Enviar formulario: El script hace clic en el bot¨®n de enviar, lo que desencadena el env¨ªo del formulario.
- Verificar el ¨¦xito: Despu¨¦s de la navegaci¨®n, se registra el contenido de la p¨¢gina, mostrando un env¨ªo exitoso (por ejemplo, un mensaje de confirmaci¨®n).
En la pr¨¢ctica, observar¨ªa que el navegador navega a la p¨¢gina de demostraci¨®n, la casilla de verificaci¨®n reCAPTCHA se marca autom¨¢ticamente y el formulario se env¨ªa correctamente, todo sin intervenci¨®n manual.
Secci¨®n de preguntas frecuentes
Pregunta | Respuesta |
---|---|
?Qu¨¦ tipos de CAPTCHA admite CapSolver? | CapSolver admite reCAPTCHA v2/v3, Cloudflare Turnstile y m¨¢s. Consulte la documentaci¨®n de CapSolver para obtener m¨¢s detalles. |
?C¨®mo obtengo claves de API para BrowserCloud y CapSolver? | Reg¨ªstrese en BrowserCloud y CapSolver para obtener sus claves de API despu¨¦s del registro. |
?Puedo usar esta integraci¨®n con Selenium o Playwright? | S¨ª, puede adaptar la integraci¨®n para Selenium o Playwright modificando la l¨®gica de control del navegador y manipulaci¨®n de p¨¢ginas para que coincida con las API de esos frameworks. |
?Qu¨¦ sucede si CapSolver no puede resolver el CAPTCHA? | Implemente una l¨®gica de reintento en su script o verifique su cuenta de CapSolver en busca de problemas como saldo insuficiente. Registre errores para la depuraci¨®n. |
?Necesito proxies con CapSolver? | El ejemplo usa ReCaptchaV2TaskProxyless , pero es posible que se necesiten proxies para CAPTCHA espec¨ªficos de la regi¨®n. La rotaci¨®n de proxy integrada de BrowserCloud puede complementar esto. |
Conclusi¨®n
La integraci¨®n de CapSolver con BrowserCloud crea una combinaci¨®n poderosa para automatizar tareas web que encuentran CAPTCHA. La resoluci¨®n de CAPTCHA impulsada por IA de CapSolver garantiza que sus scripts Puppeteer en BrowserCloud puedan omitir las medidas anti-bot, mientras que la infraestructura escalable y el soporte de proxy de BrowserCloud mejoran la confiabilidad de la automatizaci¨®n. Esto es particularmente valioso para el raspado web, las pruebas automatizadas y la generaci¨®n de contenido, donde los CAPTCHA son obst¨¢culos comunes.
Para comenzar, reg¨ªstrese en BrowserCloud y CapSolver, obtenga sus claves de API e implemente el ejemplo de c¨®digo proporcionado. Explore la documentaci¨®n de CapSolver y la documentaci¨®n de BrowserCloud para conocer las funciones avanzadas y los tipos de tareas adicionales. ?Pruebe esta integraci¨®n en su pr¨®ximo proyecto de automatizaci¨®n y experimente flujos de trabajo fluidos e ininterrumpidos!
Bono para usuarios de Browser: Use el c¨®digo promocional BROWSERCLOUD al recargar su cuenta de CapSolver y reciba un cr¨¦dito de bonificaci¨®n exclusivo del 6 %, sin l¨ªmites ni vencimiento.
Navegadores y herramientas compatibles
- BrowserCloud: Admite Puppeteer, Selenium y Playwright, ejecutando navegadores Chrome.
CapSolver: Compatible con cualquier cliente con capacidad HTTP, incluyendo extensiones de navegador para Chrome y Firefox.
Aviso de Cumplimiento: La informaci¨®n proporcionada en este blog es solo para fines informativos. CapSolver se compromete a cumplir con todas las leyes y regulaciones aplicables. El uso de la red de CapSolver para actividades ilegales, fraudulentas o abusivas est¨¢ estrictamente prohibido y ser¨¢ investigado. Nuestras soluciones para la resoluci¨®n de captcha mejoran la experiencia del usuario mientras garantizan un 100% de cumplimiento al ayudar a resolver las dificultades de captcha durante el rastreo de datos p¨²blicos. Fomentamos el uso responsable de nuestros servicios. Para obtener m¨¢s informaci¨®n, visite nuestros T¨¦rminos de Servicio y Pol¨ªtica de Privacidad.
M¨¢se

C¨®mo resolver cualquier versi¨®n de reCAPTCHA Enterprise v2, v2 invisible, v3, v3 Enterprise puntuaci¨®n 0.9
Domina la resoluci¨®n de cualquier versi¨®n de reCaptcha con CapSolver: Este gu¨ªa proporciona un tutorial paso a paso para resolver reCaptcha de manera efectiva, garantizando resultados precisos cada vez.

Alo¨ªsio V¨ªtor
11-Oct-2025

C¨®mo resolver captchas de imagen
Esta entrada de blog proporciona una gu¨ªa completa sobre c¨®mo resolver captchas de imagen utilizando CapSolver, una herramienta dise?ada para automatizar el proceso. Comienza explicando qu¨¦ es un captcha de imagen, seguido de una gu¨ªa paso a paso detallada sobre c¨®mo usar la API de CapSolver para resolver estos captchas. La gu¨ªa incluye ejemplos de las solicitudes y respuestas involucradas en el proceso. La entrada concluye con una nota sobre la eficiencia y la conveniencia de usar CapSolver para resolver captchas de imagen, convirti¨¦ndola en una fuente invaluable para quienes buscan automatizar tareas que involucran la resoluci¨®n de captchas.

Emma Foster
11-Oct-2025

C¨®mo resolver reCaptcha versi¨®n 2 Invisible
Este blog sirve como una gu¨ªa completa sobre c¨®mo resolver reCaptcha v2 invisible utilizando Capsolver. Proporciona una gu¨ªa paso a paso, desde enviar la informaci¨®n necesaria a Capsolver hasta verificar los resultados. El blog est¨¢ dise?ado para ser f¨¢cil de entender y seguir, haciendo que el proceso de implementar y resolver reCaptcha v2 invisible en tu sitio web sea r¨¢pido y eficiente. Es una gu¨ªa ¨²nica y extensa, asegurando que los lectores adquieran una comprensi¨®n completa del proceso sin ning¨²n plagio.

Ad¨¦lia Cruz
11-Oct-2025

Resolver reCaptcha v2 Enterprise
En el mundo digital, la seguridad y la comodidad del usuario a menudo se encuentran en extremos opuestos del espectro. Los CAPTCHAs, espec¨ªficamente reCaptcha, han sido fundamentales para equilibrar los dos aspectos. Sin embargo, ?qu¨¦ pasa si necesitas resolver las pruebas de reCaptcha a menudo complejas y que consumen mucho tiempo, especialmente la versi¨®n Enterprise de reCaptcha V2, para un prop¨®sito leg¨ªtimo como pruebas automatizadas? En este blog, te guiaremos a trav¨¦s del proceso de resolver reCaptcha V2 Enterprise utilizando la API de CapSolver.

Ad¨¦lia Cruz
11-Oct-2025

Resolver reCaptcha v3
Aprende a resolver reCaptcha V3 usando CapSolver: diversos tipos de tareas, integraci¨®n de API simple y soluciones efectivas para automatizaci¨®n y pruebas

Alo¨ªsio V¨ªtor
10-Oct-2025

C¨®mo resolver Captcha en Crawl4AI con CapSolver integraci¨®n
Extracci¨®n de datos web fluida con Crawl4AI & CapSolver: soluci¨®n autom¨¢tica de CAPTCHA, mayor eficiencia y extracci¨®n de datos robusta para la IA.

Ad¨¦lia Cruz
26-Sep-2025