@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