@gatesolve/recaptcha-provider

Use GateSolve as the solving backend for puppeteer-extra-plugin-recaptcha.

Drop-in replacement for 2captcha — works with both puppeteer-extra and playwright-extra.

Install

npm install @gatesolve/recaptcha-provider

Usage with Puppeteer

import puppeteer from 'puppeteer-extra'
import RecaptchaPlugin from 'puppeteer-extra-plugin-recaptcha'
import { PROVIDER_ID, getSolutions } from '@gatesolve/recaptcha-provider'

puppeteer.use(RecaptchaPlugin({
  provider: { id: PROVIDER_ID, token: 'gs_your_key', fn: getSolutions }
}))

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

// Automatically detects and solves reCAPTCHAs using GateSolve
const { solved } = await page.solveRecaptchas()
console.log(`Solved ${solved.length} captcha(s)`)

await page.close()
await browser.close()

Usage with Playwright

import { chromium } from 'playwright-extra'
import RecaptchaPlugin from 'puppeteer-extra-plugin-recaptcha'
import { PROVIDER_ID, getSolutions } from '@gatesolve/recaptcha-provider'

chromium.use(RecaptchaPlugin({
  provider: { id: PROVIDER_ID, token: 'gs_your_key', fn: getSolutions }
}))

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

const { solved } = await page.solveRecaptchas()
console.log(`Solved ${solved.length} captcha(s)`)

await page.close()
await browser.close()

Get an API Key

Sign up at gatesolve.dev to get your API key.

How It Works

1. puppeteer-extra-plugin-recaptcha detects CAPTCHAs on the page
2. This provider sends them to the GateSolve API for solving
3. Solutions are returned and automatically injected into the page

Supports reCAPTCHA v2, v3, and hCaptcha.

License

MIT