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
- Enable the CapSolver plugin.
- Press the F12 key to open the browser’s developer tools and switch to the
Capsolver Captcha Detector
window. - 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
- How to identify reCAPTCHA v2 parameters | Using Capsolver Extension to obtain task parameters
- How to identify reCAPTCHA v2 invisible parameters | Using Capsolver Extension to obtain parameters
- How to identify reCAPTCHA v3 parameters | Using Capsolver Extension to obtain task parameters
- How to identify the HCaptcha parameters | Using Capsolver Extension to obtain task parameters
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
- Download the CapSolver extension latest zip installation package.
- Extract the package, go into the folder, and find the configuration file:
/assets/config.js
. - Open
config.js
and modify the settings as needed, such as adding an API key. - Remove the previously installed CapSolver Extension from the browser. If not installed before, skip this step.
- Go to the extension management page, click on Load unpacked, and select the folder where you just extracted the files.
Configurable Settings
Key | Type | Description |
---|---|---|
apiKey | String | API key |
appId | String | Your developer appId, apply for it in the developer interface of your account panel |
useCapsolver | Boolean | Whether the extension is enabled by default |
manualSolving | Boolean | Whether to manually solve captchas |
solvedCallback | String | Callback function name for solving captchas |
useProxy | Boolean | Whether to use a proxy |
proxyType | String | Proxy type: http, https, or socks5 |
hostOrIp | String | Proxy domain |
port | String | Proxy port |
proxyLogin | String | Proxy username |
proxyPassword | String | Proxy password |
enabledForBlacklistControl | Boolean | Whether to enable the blacklist |
blackUrlList | Array<String> | List of URLs to blacklist |
enabledForRecaptcha | Boolean | Whether to enable RecaptchaV2 |
enabledForRecaptchaV3 | Boolean | Whether to enable RecaptchaV3 |
enabledForHCaptcha | Boolean | Whether to enable HCaptcha |
enabledForImageToText | Boolean | Whether to enable ImageToText |
enabledForAwsCaptcha | Boolean | Whether to enable AwsCaptcha |
reCaptchaMode | String | ReCaptcha mode: click or token |
hCaptchaMode | String | HCaptcha mode: click or token |
reCaptchaDelayTime | Number | Delay time before solving ReCaptcha |
hCaptchaDelayTime | Number | Delay time before solving HCaptcha |
textCaptchaDelayTime | Number | Delay time before solving ImageToText |
awsDelayTime | Number | Delay time before solving AwsCaptcha |
reCaptchaRepeatTimes | Number | Number of retry attempts after failing to solve ReCaptchaV2 |
reCaptcha3RepeatTimes | Number | Number of retry attempts after failing to solve ReCaptchaV3 |
hCaptchaRepeatTimes | Number | Number of retry attempts after failing to solve HCaptcha |
textCaptchaRepeatTimes | Number | Number of retry attempts after failing to solve ImageToText |
awsRepeatTimes | Number | Number of retry attempts after failing to solve AwsCaptcha |
textCaptchaSourceAttribute | String | HTML element attribute name of the original image for ImageToText |
textCaptchaResultAttribute | String | HTML 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
- Download the CapSolver extension latest zip installation package.
- Unzip the package, go into the folder, and find the configuration file:
/assets/config.js
. - Open
config.js
and modify the settings as needed, such as adding an API key. - If you are using Selenium, compress the extracted files back into a zip. If using Puppeteer, this step is not necessary.
- 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/")