Bypass reCAPTCHA with Puppeteer
Automatically solve reCAPTCHA v2 and v3 challenges in your Puppeteer scripts. Built-in CAPTCHA solving, stealth mode, and fingerprint evasion for reliable automation.
The reCAPTCHA Challenge
Why solving CAPTCHAs with Puppeteer is difficult
The Browserless Solution
Automated reCAPTCHA bypass with zero configuration
Simple Puppeteer Code
No complex CAPTCHA solving logic needed - just write normal Puppeteer code
import puppeteer from 'puppeteer';
import { solveCaptcha } from 'some-captcha-service';
const browser = await puppeteer.launch();
const page = await browser.newPage();
// Navigate to page with reCAPTCHA
await page.goto('https://example.com/login');
// Detect CAPTCHA
const captchaExists = await page.$('.g-recaptcha');
if (captchaExists) {
// Extract site key
const siteKey = await page.$eval(
'.g-recaptcha',
el => el.getAttribute('data-sitekey')
);
// Call external CAPTCHA solving service
const solution = await solveCaptcha({
siteKey,
url: page.url(),
apiKey: process.env.CAPTCHA_API_KEY
});
// Wait for solution (can take 30+ seconds)
const token = await solution.waitForToken();
// Inject token into page
await page.evaluate((token) => {
document.getElementById('g-recaptcha-response').innerHTML = token;
}, token);
// Submit form
await page.click('button[type="submit"]');
}
// Continue automation...
await browser.close();import puppeteer from 'puppeteer-core';
// solveCaptchas turns on background solving; the longer timeout gives a solve room to finish
const browser = await puppeteer.connect({
browserWSEndpoint: 'wss://production-sfo.browserless.io?token=YOUR_API_KEY&solveCaptchas=true&timeout=300000'
});
const page = await browser.newPage();
const cdp = await page.createCDPSession();
// Browserless reports a detected reCAPTCHA, then the result of its background solve
const captchaFound = new Promise((resolve) =>
cdp.once('Browserless.captchaFound', () => resolve(true))
);
const captchaSolved = new Promise((resolve) =>
cdp.once('Browserless.captchaAutoSolved', resolve)
);
// Navigate to page with reCAPTCHA
await page.goto('https://example.com/login', {
waitUntil: 'networkidle2',
timeout: 60000,
});
// Fill in the login form while Browserless solves the reCAPTCHA in the background
await page.type('#username', 'user@example.com');
await page.type('#password', 'password123');
// Submit only once a detected reCAPTCHA has been solved
const found = await Promise.race([
captchaFound,
new Promise((resolve) => setTimeout(() => resolve(false), 5000)),
]);
if (found) {
const { solved, error } = await captchaSolved;
if (!solved) throw new Error(error || 'reCAPTCHA was not solved');
}
await page.click('button[type="submit"]');
// Continue automation...
await page.waitForNavigation();
const data = await page.evaluate(() => {
return document.querySelector('.dashboard-data').textContent;
});
await browser.close();
console.log('Data:', data);import puppeteer from 'puppeteer-core';
const browser = await puppeteer.connect({
browserWSEndpoint: 'wss://production-sfo.browserless.io?token=YOUR_API_KEY&solveCaptchas=true&timeout=300000'
});
const page = await browser.newPage();
const cdp = await page.createCDPSession();
// Arm the listeners before the first navigation: once() captures the first CAPTCHA
// detected anywhere in the session, even on a later page. Arm a fresh pair before
// each additional CAPTCHA you need to wait on.
const captchaFound = new Promise((resolve) =>
cdp.once('Browserless.captchaFound', () => resolve(true))
);
const captchaSolved = new Promise((resolve) =>
cdp.once('Browserless.captchaAutoSolved', resolve)
);
// First page: no reCAPTCHA here
await page.goto('https://example.com/account', {
waitUntil: 'networkidle2',
timeout: 60000,
});
// Click through to a form guarded by reCAPTCHA; detection fires as it loads
await page.click('a[href="/account/support"]');
await page.waitForNavigation({ waitUntil: 'networkidle2' });
await page.type('#message', 'Hello from an automated test');
// Submit only once a detected reCAPTCHA has been solved
const found = await Promise.race([
captchaFound,
new Promise((resolve) => setTimeout(() => resolve(false), 5000)),
]);
if (found) {
const { solved, error } = await captchaSolved;
if (!solved) throw new Error(error || 'reCAPTCHA was not solved');
}
await page.click('button[type="submit"]');
await page.waitForNavigation();
await browser.close();Comprehensive CAPTCHA Coverage
Support for all major CAPTCHA types and services
Why Choose Browserless for CAPTCHA Bypass?
Common Use Cases
Browserless is built for automating systems you own or are authorized to access.
How It Works Behind the Scenes
Multi-layered approach for reliable CAPTCHA bypass
Stealth Mode Activation
When your Puppeteer script connects to Browserless, stealth mode is automatically enabled. This removes all WebDriver flags, randomizes browser fingerprints, and masks automation signatures that trigger CAPTCHA challenges.
CAPTCHA Detection
As your script navigates pages, Browserless continuously monitors for CAPTCHA elements. When a reCAPTCHA or other challenge is detected, the solving process initiates automatically in the background.
Automatic Solving
The CAPTCHA is solved using a combination of techniques: advanced computer vision for image challenges, machine learning models, and when needed, integration with professional solving services. The solution is injected seamlessly.
Seamless Continuation
Once solved, the token is already in the page and your script carries on from the step that was waiting on it. No polling a solving service, no callback plumbing, no manual intervention.
Start Bypassing reCAPTCHA Today
Add automatic CAPTCHA solving to your Puppeteer scripts with zero configuration. The free plan includes 1,000 units, with CAPTCHA solving included.