@gatesolve/puppeteer-plugin

@gatesolve/puppeteer-plugin

Automatic CAPTCHA solving for Puppeteer. Detects Cloudflare Turnstile, reCAPTCHA, and hCaptcha challenges and solves them via GateSolve.

Install

npm install @gatesolve/puppeteer-plugin

Quick Start

One-shot: Solve CAPTCHA on current page

const puppeteer = require('puppeteer');
const { solveOnPage } = require('@gatesolve/puppeteer-plugin');

const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('https://example.com/login');

// Detect and solve any CAPTCHA
const result = await solveOnPage(page, {
  apiKey: 'gs_your_key_here', // Free at gatesolve.dev
});

if (result?.success) {
  console.log(`Solved ${result.type} in ${result.solveTimeMs}ms`);
  await page.click('button[type="submit"]');
}

Auto-solve: Wrap page

const { withGateSolve } = require('@gatesolve/puppeteer-plugin');

const page = await browser.newPage();
withGateSolve(page, { apiKey: 'gs_your_key_here', debug: true });

await page.goto('https://example.com/protected');
// CAPTCHAs are solved automatically on every page load

Detect only

const { detectCaptcha } = require('@gatesolve/puppeteer-plugin');

const detection = await detectCaptcha(page);
if (detection) {
  console.log(`Found ${detection.type} with siteKey ${detection.siteKey}`);
}

Options

Option	Type	Default	Description
apiKey	string	required	GateSolve API key
baseUrl	string	https://gatesolve.dev	API base URL
timeout	number	30000	Max solve wait (ms)
pollInterval	number	2000	Poll frequency (ms)
debug	boolean	false	Log debug info

Supported CAPTCHAs

• Cloudflare Turnstile — $0.02/solve
• reCAPTCHA v2/v3 — $0.03/solve
• hCaptcha — $0.03/solve

Free Tier

100 free solves per API key. No credit card required. gatesolve.dev

License

MIT