capguru

English | Русский

Automatic captcha solving for Puppeteer via the Cap.Guru service.

Supported: reCAPTCHA v2, hCaptcha, GeeTest v3/v4, FunCaptcha (Arkose Labs), TikTok, AWS WAF, Yandex SmartCaptcha.

Installation

npm install capguru puppeteer

Usage

const puppeteer = require('puppeteer');
const { CaptchaSolver, CapGuruFatalError } = require('capguru');

(async () => {
  const browser = await puppeteer.launch({ headless: false });
  const page = await browser.newPage();

  const solver = new CaptchaSolver({ page, apiKey: 'YOUR_KEY', debug: true });
  await solver.setup();

  await page.goto('https://site.com/cap');

  try {
    const kind = await solver.auto(30);
    console.log('Captcha:', kind || 'not found');
  } catch (e) {
    if (e instanceof CapGuruFatalError) console.log('API key or balance problem:', e.message);
    else console.log('Not solved:', e.message);
  } finally {
    await browser.close();
  }
})();

Create the solver before page.goto() and call await solver.setup().

Methods

await solver.auto(30)          // find and solve the captcha, returns its type or null
await solver.detect()          // only detect the type
await solver.solveRecaptcha2()
await solver.solveHcaptcha()
await solver.solveOther()      // Yandex SmartCaptcha
await solver.solveGeetest()
await solver.solveFuncaptcha()
await solver.solveTiktok()
await solver.solveAws()

Full documentation: https://docs.cap.guru

Русский

Автоматическое решение капчи для Puppeteer через сервис Cap.Guru.

Поддерживаются: reCAPTCHA v2, hCaptcha, GeeTest v3/v4, FunCaptcha (Arkose Labs), TikTok, AWS WAF, Яндекс SmartCaptcha.

Установка

npm install capguru puppeteer

Использование

const solver = new CaptchaSolver({ page, apiKey: 'YOUR_KEY', debug: true });
await solver.setup();

await page.goto('https://site.com/cap');

const kind = await solver.auto(30);
console.log('Captcha:', kind || 'not found');

Создавайте солвер до page.goto() и вызывайте await solver.setup(): так модуль успевает перехватить картинки капчи и переключить hCaptcha на английский.

Методы

await solver.auto(30)          // найти капчу и решить, вернёт тип или null
await solver.detect()          // только определить тип
await solver.solveRecaptcha2()
await solver.solveHcaptcha()
await solver.solveOther()      // Яндекс SmartCaptcha
await solver.solveGeetest()
await solver.solveFuncaptcha()
await solver.solveTiktok()
await solver.solveAws()

При неверном API-ключе или нулевом балансе выбрасывается CapGuruFatalError, при неудаче решения — обычная ошибка Error.

Полная документация: https://docs.cap.guru