For any questions, issues, or feature requests, feel free to open an issue or contact me at:
This project isn't fully finished right now, I need to train a lot more the AI. I'll let you know...
This repository provides an advanced solution for solving Google's reCAPTCHA v2/v3. The system is designed for developers who need to bypass reCAPTCHA and BotGuard challenges in an automated, reliable, and efficient manner.
The solver works by mimicking real user interactions with reCAPTCHA services, bypassing security mechanisms using server-side requests and reverse-engineering techniques. This tool is particularly useful for automating tasks in environments where CAPTCHA protection is present, such as form submissions, web scraping, and automated testing.
- Google reCAPTCHA v2 & v3 Solving: Efficiently solve both reCAPTCHA v2 and reCAPTCHA v3 challenges using request-based mechanisms.
- 100% requests based: Works only with requests, no browser shit !
- BotGuard Reverse Engineered Solver: Bypass BotGuard protections that are designed to prevent bot traffic.
- Easy Integration: Provides a simple API for integrating CAPTCHA solving into your scripts or applications.
- Automated Interaction Simulation: Simulates human-like interaction to solve CAPTCHA challenges based on request analysis.
- Request-based Solving: Completely server-side and API-based, requiring no manual interaction.
- Proxy Support: Supports rotating proxies to avoid IP bans and to simulate multiple users.
- High Success Rate: Implements intelligent fallback mechanisms to increase the solving success rate for reCAPTCHA and BotGuard.
- google.com
- gmail.com
- youtube.com
- spotify.com
- dev.to
- Many more...
- Windows 10 / Windows 11 / Linux / MacOS
- Python 3.10 or any modern version of Python.
- Requests Library: For making HTTP requests to interact with CAPTCHA services.
To get started, simply clone the repository and install the required dependencies.
-
Clone this repository:
git clone https://github.com/catcha8/recaptcha-solver.git cd recaptcha-solver -
Install dependencies:
pip install -r requirements.txt
-
Initialize the solver:
from recaptcha_solver import ReCaptchaSolver solver = ReCaptchaSolver(api_key="your_api_key")
-
Solve a reCAPTCHA v2:
response = solver.solve_recaptcha_v2(site_key="your_site_key", page_url="https://example.com") print("Captcha Response: ", response)
-
Solve a reCAPTCHA v3:
response = solver.solve_recaptcha_v3(site_key="your_site_key", page_url="https://example.com") print("Captcha Response: ", response)
This project uses an API key for CAPTCHA solving. You'll need to obtain an API key from our CAPTCHA-solving service.
- Put your API key in the settings file (
config.json). - You can configure proxy settings in
config.jsontoo if you'd like to use rotating proxies.
- Proxy Rotation: Use rotating proxies to avoid IP bans.
- Error Handling: Robust error handling for failed CAPTCHA solving attempts.
- Logging: Detailed logs for debugging and monitoring solving attempts.
- Captcha Timeout Management: Handle timeouts and retries for CAPTCHA-solving.
Contributions to this project are welcome! If you'd like to improve the solver or add new features, feel free to fork the repository and submit a pull request.
- Fork this repository.
- Create a new branch (
git checkout -b feature-name). - Make your changes and commit them (
git commit -am 'Add new feature'). - Push to the branch (
git push origin feature-name). - Create a new Pull Request.
This project is not affiliated with Google or any CAPTCHA service. It is designed as a tool for educational purposes and should only be used responsibly. Using this tool to circumvent CAPTCHA protections may violate the terms of service of various websites. Always ensure you're in compliance with legal and ethical standards before using such tools.
This project is licensed under the MIT License - see the LICENSE file for details.
Please read your emails...