https://github.com/theqmaks/resolver
This extension integrates popular CAPTCHA solution services into BurpSuite to process different types of CAPTCHAs without manual intervention.
https://github.com/theqmaks/resolver
2captcha anti-captcha burpsuite burpsuite-extension burpsuite-pugin capmonster montoya-api recaptcha-solver recaptcha-v2-solver recaptcha-v3-solver security-testing
Last synced: 4 months ago
JSON representation
This extension integrates popular CAPTCHA solution services into BurpSuite to process different types of CAPTCHAs without manual intervention.
- Host: GitHub
- URL: https://github.com/theqmaks/resolver
- Owner: TheQmaks
- License: mit
- Created: 2025-03-13T09:05:20.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-18T20:46:45.000Z (over 1 year ago)
- Last Synced: 2025-03-18T21:25:06.062Z (over 1 year ago)
- Topics: 2captcha, anti-captcha, burpsuite, burpsuite-extension, burpsuite-pugin, capmonster, montoya-api, recaptcha-solver, recaptcha-v2-solver, recaptcha-v3-solver, security-testing
- Language: Java
- Homepage: https://www.linkedin.com/in/ant01
- Size: 3.11 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# reSolver - CAPTCHA solver for Burp Suite
[](https://opensource.org/licenses/MIT)
[](https://www.oracle.com/java/)
[](https://portswigger.net/bappstore)
Automatically solve CAPTCHAs during web application security testing. Intercepts HTTP requests containing CAPTCHA placeholders, solves them via external providers, and injects the tokens — seamlessly integrating with Repeater, Intruder, and other Burp tools.
## Features
- **8 CAPTCHA types**: reCAPTCHA v2/v3 (incl. invisible & enterprise), hCaptcha, Cloudflare Turnstile, FunCaptcha, GeeTest v3/v4, AWS WAF
- **6 providers**: [2Captcha](https://2captcha.com/), [RuCaptcha](https://rucaptcha.com/), [Anti-Captcha](https://anti-captcha.com/), [CapMonster Cloud](https://capmonster.cloud/), [CapSolver](https://capsolver.com/), [SolveCaptcha](https://solvecaptcha.com/)
- **Auto-Detection**: passively scans HTTP responses for embedded CAPTCHAs and generates ready-to-use placeholders
- **Smart failover**: priority-based provider selection with circuit breaker
- **Statistics**: per-provider success rates, solve times, and balance tracking
## Getting Started
**Requirements:** Burp Suite 2024.x+, Java 21+, account with a supported CAPTCHA solving provider.
1. Download the JAR from [GitHub Releases](https://github.com/TheQmaks/reSolver/releases)
2. In Burp Suite: Extensions > Installed > Add > select the JAR
3. Go to the **Services** tab, enter your API key(s), and enable providers
## Usage
### Placeholder Format
Insert placeholders into HTTP requests — reSolver will replace them with solved tokens:
```
{{CAPTCHA[:]TYPE[:]SITEKEY[:]URL[:][OPTIONAL_PARAMS]}}
```
The `[:]` separator avoids conflicts with colons in URLs and site keys.
### CAPTCHA Types
| Type | Code | Optional Parameters |
|------|------|-------------------|
| reCAPTCHA v2 | `recaptchav2` | `invisible`, `enterprise`, `timeout_seconds` |
| reCAPTCHA v3 | `recaptchav3` | `action`, `min_score`, `enterprise`, `timeout_seconds` |
| hCaptcha | `hcaptcha` | `timeout_seconds` |
| Cloudflare Turnstile | `turnstile` | `timeout_seconds` |
| FunCaptcha | `funcaptcha` | `timeout_seconds` |
| GeeTest v3 | `geetest` | `timeout_seconds` |
| GeeTest v4 | `geetestv4` | `timeout_seconds` |
| AWS WAF | `awswaf` | `timeout_seconds` |
### Examples
```
{{CAPTCHA[:]recaptchav2[:]6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u[:]https://example.com}}
{{CAPTCHA[:]recaptchav2[:]6LfD3PIb...[:]https://example.com[:]invisible,enterprise}}
{{CAPTCHA[:]recaptchav3[:]6LcW00EU...[:]https://example.com[:]action=login,min_score=0.7}}
{{CAPTCHA[:]hcaptcha[:]a1b2c3d4-e5f6...[:]https://example.com}}
{{CAPTCHA[:]turnstile[:]0x4AAAAAAA...[:]https://example.com}}
```
### Auto-Detection
As you browse, reSolver automatically detects CAPTCHAs in HTTP responses. Check the **Detections** tab — click **Copy Placeholder** and paste it into your request.
## Building from Source
```bash
git clone https://github.com/TheQmaks/reSolver.git
cd reSolver
./gradlew build
```
The JAR will be in `build/libs/`.
## Contributing
1. Fork the repo
2. Create a feature branch (`git checkout -b feature/my-feature`)
3. Commit and push your changes
4. Open a Pull Request
## License
[MIT](LICENSE)