Firefox browser extension

Description

With this extension, you can recognize captchas automatically directly in the browser.

The extension works in the Mozilla Firefox browser.

Automatic installation

Open the Firefox Add-ons Web Store.
Click Add to Firefox.
Confirm adding the extension by clicking the Add button in the modal window.

To get started with the extension, click on its icon to the right of the address bar. Go to the settings.

If for some reason it was not possible to install the extension from the Firefox Add-ons Web Store, use the instructions for manual installation.

Manual installation

Download the archive with the extension.
Open the Firefox browser and go to work with extensions:
Go to Manage Your Extensions, click the gear button, and in the dropdown list that opens, select Install Add-on From File…
Select the downloaded archive with the extension.
After the extension is loaded, go to Manage extensions and click the installed extension.
Go to the Permissions tab and make sure that all permissions have been granted.

If errors occur during the standard installation, use the add-on debugging mode:

Go to Manage Your Extensions, click the gear button, and in the dropdown list that opens, select Debug Add-ons
In the window that opens, click Load Temporary Add-on and select the downloaded archive with the extension.

Manual update of the extension

If you are installing the extension over the previous version, then when you update the original extension files, you also need to click the update button on the Extensions page (how to open this page is described above in the Manual installation section).

Settings

How to pin the extension

By default, a newly installed extension is automatically pinned to the browser panel.

After launching the extension you’ll see this window:

API key

Enter API key in the corresponding field(1), press Save button(2). If you entered the correct key, your balance will be displayed below(3).

Automated captcha solving

Here you can select the types of captchas that the extension will recognize automatically.

You may need to reload the page with captcha for the changes to take effect!

Repeat captcha solving in case of an error

If the first attempt to solve the captcha is failed, the extension will send repeated tasks until the captcha is not solved, or until the limit specified in this setting will not be reached.

Proxy

In this section, you can specify a proxy that will be passed along with the recognition task.

The Login and Password fields are optional. The extension also supports proxies with IPv6.

Blacklist control

Using the blacklist you can configure the extension to ignore captchas on specific websites.

After enabling this option, a field for entering sites will appear:

Domains must be specified along with the protocol (https:// or http://). You can use masks:

? - any one character except period
* - any number of any characters

Examples:

Filter	Description
`https://zennolab.com`	Prohibition of the extension on the site `https://zennolab.com`
`https://*.zennolab.com`	Prohibition of the extension on all subdomains `https://zennolab.com`
`https://www.google.*`	Prohibiting the extension from working on Google in all zones (ru, com, com.ua, etc.)

When errors occur in solving captchas, see the error glossary.

Captcha parameter mapping

The CapMonster Cloud extension provides a convenient way to view the parameters of various captcha types required for correct task submission and successful solving. The displayed data helps ensure the accuracy of the parameters you send and can be used as an example when forming your API requests.

Supported captcha types and their parameters

Captcha type	Displayed parameters
reCAPTCHA V2 (Click)	`class`, `imageUrls`, `Task` (inside `metadata`), `Grid` (inside `metadata`), `recognizingThreshold`, `userAgent`, `type`
reCAPTCHA V2 (Token)	`websiteURL`, `websiteKey`, `userAgent`, `type`
reCAPTCHA V2 Invisible	`class`, `imageUrls`, `Task` (inside `metadata`), `Grid` (inside `metadata`), `recognizingThreshold`, `userAgent`, `type`
reCAPTCHA V2 Enterprise (Click)	`class`, `imageUrls`, `Task` (inside `metadata`), `Grid` (inside `metadata`), `recognizingThreshold`, `userAgent`, `type`
reCAPTCHA V2 Enterprise (Token)	`websiteURL`, `websiteKey`, `userAgent`, `recaptchaDataSValue`, `type`
reCAPTCHA V3	`websiteURL`, `websiteKey`, `pageAction`, `minScore`, `type`
GeeTest v3	`websiteURL`, `gt`, `challenge`, `userAgent`, `type`
GeeTest v4	`websiteURL`, `gt` (`captcha_id`), `userAgent`, `version`, `type`
Cloudflare Turnstile	`websiteURL`, `websiteKey`, `userAgent`, `type`
Cloudflare Challenge	`websiteURL`, `websiteKey`, `userAgent`, `pageAction`, `data`, `pageData`, `cloudflareTaskType`, `type`
ImageToText	`body` (in `base64` format), `type`
BLS	`class`, `imagesBase64`, `Task` (inside `metadata`), `TaskArgument` (inside `metadata`), `type`
Binance	`websiteURL`, `websiteKey`, `validateId`, `userAgent`, `type`

To use this feature, enable the extension, specify your API key in the settings, and make sure there are funds on your balance. Then open the page with the captcha, check that its type is supported and selected for solving, and follow these steps:

Open Developer Tools and go to the Capmonster Cloud tab:
Reload the page.

Important

For API requests, use an up-to-date userAgent supported by our service.

Captcha parameters will be displayed automatically:

Description​

Automatic installation​

Settings​

API key​

Automated captcha solving​

Repeat captcha solving in case of an error​

Proxy​

Blacklist control​

Captcha parameter mapping​

Supported captcha types and their parameters​