This is a Node.js module designed to solve reCAPTCHA v2 automatically in Puppeteer or Selenium environments. It interacts with web pages to detect and bypass CAPTCHAs using external solving services.

The module itself is free and open-source, but solving CAPTCHAs requires an account with a CAPTCHA-solving provider like CaptchaAI, which charges based on usage.

Currently, it supports Google reCAPTCHA v2 (checkbox and invisible). It does not support reCAPTCHA v3, hCaptcha, or image-based CAPTCHAs.

Simply sign up at CaptchaAI.com, get your API key, and set it in your environment or code configuration. The module automatically forwards CAPTCHA solving requests to CaptchaAI.

Yes, it is built specifically for headless testing frameworks such as Puppeteer and Selenium, often used in automated scraping and browser testing.

No, this tool does not handle advanced bot protection like fingerprint evasion or detection of headless browsers. You may need to pair it with additional stealth plugins.

Proxy handling is not directly managed by the module itself. You need to configure proxies via your Puppeteer or Selenium setup to avoid being rate-limited or blocked.

"captchas by pguardiario" is only a frontend interface—it doesn’t solve CAPTCHAs on its own. CaptchaAI provides the actual CAPTCHA-solving power behind the scenes, with support for high concurrency, fast reCAPTCHA v2 solving, and a stable API. Without CaptchaAI or a similar provider, the module cannot function.

Out of the box, this package offers no solving logic, error handling, or smart retries. It depends entirely on the API service. CaptchaAI fills this gap with robust solving infrastructure, proper error feedback (CAPCHA_NOT_READY, ERROR_WRONG_GOOGLEKEY, etc.), and proven support for production loads.

This means the solution is still being processed. You should implement polling with delays before rechecking the status using the CaptchaAI response ID. CaptchaAI’s API docs outline the proper approach.