Guide
Browser Extension
Extension Settings

Extension Settings for Developers

Captcha Parameter Recognition Functionality

If you are unsure how to obtain the parameters of the captcha on the current webpage, you can try using the captcha parameter recognition functionality provided by the plugin. It will be very helpful and comes with the following features:

  • Automatically recognizes the type and parameters of the captcha on the current page.
  • Automatically generates JSON data required to call the CapSolver API service for you.

How to Use the Parameter Recognition Functionality

  1. Enable the CapSolver plugin.
  2. Press the F12 key to open the browser’s developer tools and switch to the Capsolver Captcha Detector window.
  3. Manually trigger the captcha, and the Extension will automatically display the detailed information of the recognized captcha, as shown in the image below:

Video Tutorial | How to identify Captcha’s task parameters with CapSolver Extension

Extension Settings

You can not only configure settings on the plugin panel but also through modifying the configuration file for additional functionality.

How to Modify the Configuration File and Install

  1. Download the CapSolver extension latest zip installation package.
  2. Extract the package, go into the folder, and find the configuration file: /assets/config.js.
  3. Open config.js and modify the settings as needed, such as adding an API key.
  4. Remove the previously installed CapSolver Extension from the browser. If not installed before, skip this step.
  5. Go to the extension management page, click on Load unpacked, and select the folder where you just extracted the files.

Configurable Settings

KeyTypeDescription
apiKeyStringAPI key
appIdStringYour developer appId, apply for it in the developer interface of your account panel
useCapsolverBooleanWhether the extension is enabled by default
manualSolvingBooleanWhether to manually solve captchas
solvedCallbackStringCallback function name for solving captchas
useProxyBooleanWhether to use a proxy
proxyTypeStringProxy type: http, https, or socks5
hostOrIpStringProxy domain
portStringProxy port
proxyLoginStringProxy username
proxyPasswordStringProxy password
enabledForBlacklistControlBooleanWhether to enable the blacklist
blackUrlListArray<String>List of URLs to blacklist
enabledForRecaptchaBooleanWhether to enable RecaptchaV2
enabledForRecaptchaV3BooleanWhether to enable RecaptchaV3
enabledForHCaptchaBooleanWhether to enable HCaptcha
enabledForImageToTextBooleanWhether to enable ImageToText
enabledForAwsCaptchaBooleanWhether to enable AwsCaptcha
reCaptchaModeStringReCaptcha mode: click or token
hCaptchaModeStringHCaptcha mode: click or token
reCaptchaDelayTimeNumberDelay time before solving ReCaptcha
hCaptchaDelayTimeNumberDelay time before solving HCaptcha
textCaptchaDelayTimeNumberDelay time before solving ImageToText
awsDelayTimeNumberDelay time before solving AwsCaptcha
reCaptchaRepeatTimesNumberNumber of retry attempts after failing to solve ReCaptchaV2
reCaptcha3RepeatTimesNumberNumber of retry attempts after failing to solve ReCaptchaV3
hCaptchaRepeatTimesNumberNumber of retry attempts after failing to solve HCaptcha
textCaptchaRepeatTimesNumberNumber of retry attempts after failing to solve ImageToText
awsRepeatTimesNumberNumber of retry attempts after failing to solve AwsCaptcha
textCaptchaSourceAttributeStringHTML element attribute name of the original image for ImageToText
textCaptchaResultAttributeStringHTML element attribute name for the answer of ImageToText
------------

How to Use the Extension in Puppeteer and Selenium

Manually Install the Extension

If you want to manually install the CapSolver Extension, follow the instructions in the tutorial above: How to Modify the Configuration File and Install

Automatically Install the Extension via Code

  1. Download the CapSolver extension latest zip installation package.
  2. Unzip the package, go into the folder, and find the configuration file: /assets/config.js.
  3. Open config.js and modify the settings as needed, such as adding an API key.
  4. If you are using Selenium, compress the extracted files back into a zip. If using Puppeteer, this step is not necessary.
  5. Load the CapSolver Extension automatically through code. Examples are provided below:
  • Puppeteer (Node.js)
const puppeteer = require('puppeteer');
 
(async () => {
  const path = 'C:/capSolver_extension';  // Folder where the Extension is unzipped 
  const browser = await puppeteer.launch({
    headless: false,
    args: [
      `--disable-extensions-except=${path}`,
      `--load-extension=${path}`,
    ],
  });
  const page = await browser.newPage();
  await page.goto("https://google.com/");
})();
  • Selenium (Python)
from selenium import webdriver

chrome_options =  webdriver.ChromeOptions()
chrome_options.add_extension("./capSolver_extension.zip")  # Path to the zip file of the plugin
driver = webdriver.Chrome(options=chrome_options)
driver.get("https://google.com/")