Logo of «2Captcha»To home page
Captcha bypass tutorials

Was this helpful?

How to solve reCAPTCHA with a browser extension

Gregory Fisher
Gregory Fisher

Technical engineer

Introduction

Not every task requires writing a complex Selenium or Puppeteer script. Sometimes you are just a QA engineer manually testing a checkout flow, a developer debugging a stubborn API endpoint, or someone who needs to submit a form on a website protected by reCAPTCHA. Extracting sitekeys and injecting tokens via code for every random website you visit is a massive waste of time.

This is exactly where the 2Captcha Browser Extension saves the day. It brings the power of the solving API directly into your browser, allowing you to bypass captchas with a single click, completely without code.

How the Extension Works

The extension acts as a bridge between the webpage you are viewing and the 2Captcha solving infrastructure. Here is what happens under the hood when you use it:

  1. The extension scans the DOM for known CAPTCHA containers, such as the reCAPTCHA iframe or the invisible v3 script.
  2. It automatically extracts the sitekey, the page action, and the current URL.
  3. It sends a background request to the 2Captcha API to create a solving task.
  4. Once the workers or AI solve the challenge, the extension injects the token into the correct hidden field and triggers the callback, making the page think a real human just solved it.

Installation and Initial Setup

Getting started takes less than a minute.

First, you need to install the extension. You can download and install it directly from the official page: https://2captcha.com/captcha-bypass-extension. It is compatible with all Chromium-based browsers like Chrome, Edge, and Brave.

After installation, you need to link it to your account:

  • Click on the extension icon in your browser toolbar.
  • Open the settings or preferences menu.
  • Paste your 2Captcha API key into the designated field.
  • Save the settings.

Make sure your account has a positive balance. The extension communicates directly with the API, so it will not be able to fetch solutions if your balance is zero.

Solving reCAPTCHA v2 (The Checkbox)

When you land on a page with the standard "I'm not a robot" checkbox, the extension recognizes it immediately. The extension icon in your toolbar will typically light up or display a badge indicating that a captcha is present.

You can solve it manually by clicking the extension icon in the browser toolbar and hitting the Solve button in the popup. Alternatively, you can enable the auto-solve mode in the extension settings. In this case, it will automatically detect and solve the captcha the moment it appears on the page, completely hands-free.

Within a few seconds, the checkbox will turn green, the hidden token field will be populated, and you can safely submit your form.

Solving reCAPTCHA v3 (Invisible)

Version 3 is tricky because there is no visual widget to click. The token is generated in the background based on user behavior and browser fingerprints, usually right when a form is submitted.

The extension handles this seamlessly. When you click Submit on the target form, the extension intercepts the action. It fetches the v3 token in the background, injects it into the hidden g-recaptcha-response field, and then lets the form submission proceed normally. You do not need to do anything differently; just fill out the form and click submit as you normally would.

Why This is a Game Changer for QA and Debugging

Using a browser extension offers several unique advantages over writing custom automation scripts:

Speed and Convenience
You do not need to spin up a headless browser, configure drivers, or write a custom script just to test one specific page. You just open the page and click solve.

Flexibility in Testing
You can navigate through complex, multi-step workflows manually. If a CAPTCHA pops up unexpectedly on the third page of a registration flow, the extension handles it instantly without breaking your manual testing session.

Hybrid Workflows
Many developers use a hybrid approach. They use the browser extension to manually pass the login or registration phase, and then switch to their Python or Node.js scripts for the actual data extraction or heavy automation.

Important Nuances to Keep in Mind

While the extension is incredibly convenient, there are a few things you should know to get the best results.

When the Extension Might Not Work

It is important to understand that the extension is not a magic bullet for every situation. It works great with standard reCAPTCHA implementations, but in reality, every captcha on every website can be integrated differently. Developers often use custom wrappers, non-standard callback functions, Enterprise versions with additional checks, or even hide the widget in the shadow DOM. In such cases, the extension might simply not recognize the captcha or fail to inject the token correctly.

If you run into a situation where the extension does not see the captcha or the site rejects the solution, do not worry. That is when the full 2Captcha API comes to the rescue. With it, you can write your own script that extracts the necessary parameters, sends them for solving, and injects the token exactly the way the specific site requires. It takes a bit more effort, but gives you full control over the process.

The API documentation is available at: https://2captcha.com/api-docs. There you will find code examples in all popular programming languages, descriptions of all task types, and detailed integration instructions.

Balance Monitoring

Since every solved CAPTCHA costs a fraction of a cent, keep an eye on your dashboard. You do not want to get interrupted in the middle of a critical testing session because your balance hit zero.

Reporting Errors

Sometimes a website might reject the token, especially if it enforces strict Enterprise-level security rules or if the session has expired. It is important to note that you cannot submit a report for an incorrect solution (reportIncorrect) directly from the extension's interface. But that's not an issue — you can easily do this in two other ways:

  1. Via the dashboard. Go to the upload statistics section at https://2captcha.com/statistics/uploads. You will see a list of all your recent tasks. Find the relevant one and click the "Report incorrect" button right next to it. This is the quickest method if you've just run into an issue.
  2. Via the API. If you are automating the process or want to send reports directly from your script, use the reportIncorrect and reportCorrect endpoints. Simply pass your API key and the taskId of the task you want to report. This is highly convenient if you already have an API integration in place and want the reports to be sent automatically.

Submitting reports helps the system learn and improves accuracy for your future requests.

Browser Permissions

If the extension fails to detect a CAPTCHA, check your browser's site access permissions. Sometimes browsers restrict content scripts from running on certain domains or in incognito mode. Ensure the extension has permission to run on the websites you are testing.

Conclusion

The 2Captcha Browser Extension perfectly bridges the gap between full-scale automation and manual browsing. It is an indispensable tool for QA teams, security testers, and developers who need to bypass reCAPTCHA quickly without writing a single line of code. By automating the extraction and injection of tokens right inside your browser, it lets you focus on the actual logic of your application instead of fighting with security widgets.

Keep in mind that the extension covers most standard scenarios, but not all. If you run into a complex or non-standard captcha implementation, you can always switch to using the 2Captcha API and implement a solution tailored to the specific site. Documentation and code examples are available at https://2captcha.com/api-docs.