@gatesolve/recaptcha-provider

@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

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

Supports reCAPTCHA v2, v3, and hCaptcha.

License

MIT