Metadata-Version: 2.1
Name: recaptcha-cracker
Version: 0.0.1
Summary: RecaptchaCracker is a tool designed to automate reCAPTCHA v2 resolution on web pages using Selenium. Allows you to resolve audio captchas, making it easy to integrate into web automation workflows.
Home-page: https://github.com/wipodev/Recaptcha_Cracker
Author: Wipodev
Author-email: ajwipo@gmail.com
License: MIT
Project-URL: Documentation, https://github.com/wipodev/Recaptcha_Cracker/blob/main/README.md
Project-URL: Source, https://github.com/wipodev/Recaptcha_Cracker
Project-URL: Bug Tracker, https://github.com/wipodev/Recaptcha_Cracker/issues
Keywords: python,captcha,speech recognition,selenium,web automation
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: seleniumbase ~=4.25.4
Requires-Dist: pydub ~=0.25.1
Requires-Dist: SpeechRecognition ~=3.10.3

# Recaptcha Cracker [![Python](https://img.shields.io/pypi/v/recaptcha-cracker.svg)](https://pypi.org/project/recaptcha-cracker/)

## Description

RecaptchaCracker is a tool designed to automate reCAPTCHA v2 resolution on web pages using Selenium.
Allows you to resolve audio captchas, making it easy to integrate into web automation workflows.

## Features

- Automated resolution of reCAPTCHA captchas on web pages.
- Flexible configuration of the number of attempts for solving audio captchas.
- Easy integration into web automation workflows.

## Requirements

- Python 3.10+
- Seleniumbase
- Pydub
- SpeechRecognition

If you're getting an error related to FFmpeg not being installed or in your PATH, get it here: https://ffmpeg.org/download.html
If the error persists, make sure FFmpeg is properly installed for your OS and in your PATH.

## Installation

```bash
pip install recaptcha-cracker
```

## Usage

1. Import the RecaptchaCracker class into your Python script:

```python
from recaptcha_cracker import RecaptchaCracker
```

2. Initialize a RecaptchaCracker object with a SeleniumBase Driver object:

```python
from seleniumbase import Driver

# Inicializa el objeto Driver
driver = Driver()

# Carga la pÃ¡gina web
driver.get("https://www.google.com/recaptcha/api2/demo")

# Inicializa el objeto RecaptchaCracker
cracker = RecaptchaCracker(driver)

```

3. Use the click_recaptcha() method to resolve a reCAPTCHA on a web page:

```python
checked_status = cracker.click_recaptcha(selector='//*[@id="recaptcha-demo"]/div/div/iframe')
```

4. If the reCAPTCHA is successfully resolved, the method will return True. Otherwise, it will return False.

## Contributions

If you'd like to contribute, please see the [CONTRIBUTING.md](CONTRIBUTING.md) file.

## License

This project is under the MIT License. See the [LICENSE](https://github.com/wipodev/Recaptcha_Cracker/blob/main/LICENSE) file for more details.

## Inspiration

This project was inspired by the project https://github.com/thicccat688/selenium-recaptcha-solver, created by user "thicccat688". The original library provides a robust solution to solve reCAPTCHA v2 challenges using Selenium and speech recognition services. By studying its implementation and design, I was able to better understand how to address captcha resolution challenges in web automation environments.

I thank the team behind selenium-recaptcha-solver for their excellent work and contributions to the open source community.

---
