Google Recapctha v2 solver with puppeteer. You can simply use it in your project by passing to the constructor your
Pageobject. The solver is using SpeechToText recognition, you can use one of our integrated solvers with your API key or to provide your own solving function. You can also integrate your own logger.
This is an academic project, it is not intended to be used in production. It is not recommended to use this project for any other purpose than educational. The author is not responsible for any misuse of this project.
demo.mp4
This project requires NodeJS (version 8 or later) and NPM. Node and NPM are really easy to install.
These instructions will help to you install the package in your project, set it and use it. See Contributing for notes on how to help and contribute this project.
BEFORE YOU INSTALL: please read the prerequisites
To install and set up the library, run:
$ npm install puppeteer-recaptcha-solverTo use, simply create the object and execute the solve command.
Example:
(async () => {
const browser = await puppeteer.launch({
headless: false,
});
const page = await browser.newPage();
const solver = new ReCaptchaSolver({
page,
maxRetries: 3,
transcriber: Transcribers.witAI,
apiKey: 'YOUR_API_KEY'
});
await page.goto(
'https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php'
);
const solved = await solver.solve();
console.log('Captcha solved: ', solved);
await page.screenshot({ path: 'example/example.png' });
await browser.close();
})(); const solver = new ReCaptchaSolver({
page,
log,
maxRetries: 3,
transcriber: Transcribers.witAI,
apiKey: 'YOUR_API_KEY'
});A constructor to the object.
Supported options for the constructor field are listed below.
| Field | Type | Default value | Required | Description |
|---|---|---|---|---|
| page | Page | Yes | puppeteer page object | |
| log | Logger | console.log |
No | A logger that the solver will use. You can also use the default logger or noopLogger to disable the logs |
| transcriber | Transcriber | witAI | No | A transcriber that the solver will use to transcriber the audio to text. You can can choose between witAI or googleSpeechToText by passing Transcribers.witAI or Transcribers.googeSpeechToText or passing you own Transcriber function. |
| maxRetries | number | 3 | No | Total number of retries until the captcha is solved |
| apiKey | string | No | API key to your transcribe service |
const solved: boolean = await solver.solve();A command that will start the solving process.
Returns a Promise<boolean> to indicate if the captcha successfully solved.
| Type | Signature | Description |
|---|---|---|
| Logger | interface Logger { |
A logger object that the solver will use. |
| Transcriber | type Transcriber = ( |
A transcribe function that gets an ArrayBuffer and should return the text |
const defaultLogger: Logger = {
log: (message: string) => console.log('[LOG]', message),
error: (message: string) => console.error('[ERROR]', message),
warn: (message: string) => console.warn('[WARN]', message),
info: (message: string) => console.info('[INFO]', message),
debug: (message: string) => console.debug('[DEBUG]', message),
};const witAI: Transcriber = async (
audioBuffer: ArrayBuffer,
apiKey?: string
) => {
if (!apiKey) {
throw new Error('witAI transcriber requires API key');
}
const { data } = await axios.post<string>(
'https://api.wit.ai/speech?v=20220622',
audioBuffer,
{
headers: {
Authorization: `Bearer ${apiKey}`,
'Content-Type': 'audio/mpeg3',
},
}
);
const parsed =
typeof data === 'string'
? JSON.parse(data.split('\r\n').slice(-1)[0] || '{}')
: data;
return parsed?.text;
}const googleSpeechToText: Transcriber = async (
audioBuffer: ArrayBuffer,
apiKey?: string
) => {
if (!apiKey) {
throw new Error('googleSpeechToText transcriber requires API key');
}
const { data } = await axios.post<string>(
`https://speech.googleapis.com/v1p1beta1/speech:recognize?key=${apiKey}`,
{
config: {
encoding: 'MP3',
sampleRateHertz: 16000,
languageCode: 'en-US',
},
audio: {
content: Buffer.from(audioBuffer).toString('base64'),
},
}
);
const parsed =
typeof data === 'string'
? JSON.parse(data.split('\r\n').slice(-1)[0] || '{}')
: data;
return parsed?.results?.[0]?.alternatives?.[0]?.transcript;
};Start with cloning this repo on your local machine:
$ git clone https://github.com/dore51/puppeteer-captcha-solver.git
$ cd puppeteer-captcha-solverTo install and set up the library, run:
$ npm install$ npm run example$ npm test$ npm run buildThis task will create a distribution version of the project
inside your local lib/ folder
$ npm publishPlease read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Add your changes:
git add . - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request 😎
This package has the following dependencies:
- Axios: A promise-based HTTP client for the browser and Node.js. Axios is used to make HTTP requests in the package.
The following dependencies are only required for development and testing purposes:
- Node.js: A JavaScript runtime built on Chrome's V8 JavaScript engine. Node.js is required to run the package.
- Puppeteer: A Node library that provides a high-level API to control Chrome or Chromium over the DevTools Protocol. Puppeteer is used to automate and control the browser in order to solve the reCAPTCHA challenge.
- Prettier: A code formatter that enforces a consistent style across the codebase.
- Jest: A testing framework for JavaScript.
- puppeteer-screen-recorder: A utility for recording screencasts of a Puppeteer page.
- TSLint: A static analysis tool that checks TypeScript code for readability, maintainability, and functionality errors.
- Dor Eitan - Github
See also the list of contributors who participated in this project.
MIT License © Dor Eitan