puppeteer-extra-plugin-capsolver

manage to solve captcha challenges with puppeteer

• ❗ API key it's required Get here

Install

npm i puppeteer puppeteer-extra puppeteer-extra-plugin-capsolver

Usage

• Import puppeteer-extra and the plugin package

1const puppeteer = require("puppeteer-extra");
2const {
3  SolverPlugin,
4  SolverPluginError,
5  SolverError,
6} = require("puppeteer-extra-plugin-capsolver");

Auto-load official Browser Extension

• How it works? This feature would auto-load the extension from a zipped file into static temp folder on your disk, then would load from there on demand refreshing apiKey on load.

• How to use with from the plugin?

  • Set useExtension on plugin init.
  • Control the extension with await page.waitForSolverCallback({ timeout }).

1puppeteer.use(
2  new SolverPlugin({
3    apiKey: process.env.APIKEY,
4    useExtension: true, // this will auto-load the extension and apiKey
5    useExtensionProxy: process.env.PROXYSTRING, // force proxy string on solving
6    useExtensionReCaptchaMode: "token", // click or token mode
7  })
8);
9
10// ...
11
12await page.waitForSolverCallback({
13  // timeout: 120000,
14});

Common usage: call the API

• How it works? Make use of capsolver-npm package to perform API calls for solution retrieving.

• How to use with from the plugin?

  • Call to await page.solver().<method>({}) from any Page.

1puppeteer.use(
2  new SolverPlugin({
3    apiKey: process.env.APIKEY,
4  })
5);
6
7// ...
8
9await page
10  .solver()
11  .recaptchav2classification({
12    // ... parameters
13  })
14  .then((s: any) => {
15    console.log(s);
16  })
17  .catch((e: SolverError) => {
18    console.log(`Errored task Id: ${e.errorTaskId}`);
19    console.log(`Error Code: ${e.errorCode}`);
20    console.log(`Error description: ${e.errorDescription}`);
21  });

📁 Updated examples

Figure out here.

Disclaimer

By using this package, you acknowledge and agree that:

• You are solely responsible for how you use the API and the author does not assume any liability for misuse, abuse, or violations of Capsolver’s terms of service.
• This package provides a service connector for the Capsolver API and is not affiliated.