@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');
const result = await solveOnPage(page, {
apiKey: 'gs_your_key_here',
});
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');
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
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