# 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.
---
Raw data
{
"_id": null,
"home_page": "https://github.com/wipodev/Recaptcha_Cracker",
"name": "recaptcha-cracker",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "python, captcha, speech recognition, selenium, web automation",
"author": "Wipodev",
"author_email": "ajwipo@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/19/b2/c3e5a0542149225bca9ea8eb8e47c0ac613b911d0e87e7e69c47a54fcc2d/recaptcha_cracker-0.0.1.tar.gz",
"platform": null,
"description": "# Recaptcha Cracker [![Python](https://img.shields.io/pypi/v/recaptcha-cracker.svg)](https://pypi.org/project/recaptcha-cracker/)\r\n\r\n## Description\r\n\r\nRecaptchaCracker is a tool designed to automate reCAPTCHA v2 resolution on web pages using Selenium.\r\nAllows you to resolve audio captchas, making it easy to integrate into web automation workflows.\r\n\r\n## Features\r\n\r\n- Automated resolution of reCAPTCHA captchas on web pages.\r\n- Flexible configuration of the number of attempts for solving audio captchas.\r\n- Easy integration into web automation workflows.\r\n\r\n## Requirements\r\n\r\n- Python 3.10+\r\n- Seleniumbase\r\n- Pydub\r\n- SpeechRecognition\r\n\r\nIf you're getting an error related to FFmpeg not being installed or in your PATH, get it here: https://ffmpeg.org/download.html\r\nIf the error persists, make sure FFmpeg is properly installed for your OS and in your PATH.\r\n\r\n## Installation\r\n\r\n```bash\r\npip install recaptcha-cracker\r\n```\r\n\r\n## Usage\r\n\r\n1. Import the RecaptchaCracker class into your Python script:\r\n\r\n```python\r\nfrom recaptcha_cracker import RecaptchaCracker\r\n```\r\n\r\n2. Initialize a RecaptchaCracker object with a SeleniumBase Driver object:\r\n\r\n```python\r\nfrom seleniumbase import Driver\r\n\r\n# Inicializa el objeto Driver\r\ndriver = Driver()\r\n\r\n# Carga la p\u00c3\u00a1gina web\r\ndriver.get(\"https://www.google.com/recaptcha/api2/demo\")\r\n\r\n# Inicializa el objeto RecaptchaCracker\r\ncracker = RecaptchaCracker(driver)\r\n\r\n```\r\n\r\n3. Use the click_recaptcha() method to resolve a reCAPTCHA on a web page:\r\n\r\n```python\r\nchecked_status = cracker.click_recaptcha(selector='//*[@id=\"recaptcha-demo\"]/div/div/iframe')\r\n```\r\n\r\n4. If the reCAPTCHA is successfully resolved, the method will return True. Otherwise, it will return False.\r\n\r\n## Contributions\r\n\r\nIf you'd like to contribute, please see the [CONTRIBUTING.md](CONTRIBUTING.md) file.\r\n\r\n## License\r\n\r\nThis project is under the MIT License. See the [LICENSE](https://github.com/wipodev/Recaptcha_Cracker/blob/main/LICENSE) file for more details.\r\n\r\n## Inspiration\r\n\r\nThis 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.\r\n\r\nI thank the team behind selenium-recaptcha-solver for their excellent work and contributions to the open source community.\r\n\r\n---\r\n",
"bugtrack_url": null,
"license": "MIT",
"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.",
"version": "0.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/wipodev/Recaptcha_Cracker/issues",
"Documentation": "https://github.com/wipodev/Recaptcha_Cracker/blob/main/README.md",
"Homepage": "https://github.com/wipodev/Recaptcha_Cracker",
"Source": "https://github.com/wipodev/Recaptcha_Cracker"
},
"split_keywords": [
"python",
" captcha",
" speech recognition",
" selenium",
" web automation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1d3e9df4ecb7a2b10b351ee004c254d075eb8d3ffa18fa7357d14de74b8b472c",
"md5": "3d0b84dff3201f761569c3cc499f534b",
"sha256": "62219603257fdaddb32b94236b58ca996206c8c5f360610d9f87334ef33ef32c"
},
"downloads": -1,
"filename": "recaptcha_cracker-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3d0b84dff3201f761569c3cc499f534b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 5689,
"upload_time": "2024-04-26T01:31:41",
"upload_time_iso_8601": "2024-04-26T01:31:41.091158Z",
"url": "https://files.pythonhosted.org/packages/1d/3e/9df4ecb7a2b10b351ee004c254d075eb8d3ffa18fa7357d14de74b8b472c/recaptcha_cracker-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "19b2c3e5a0542149225bca9ea8eb8e47c0ac613b911d0e87e7e69c47a54fcc2d",
"md5": "82e9eb85d4f56443982d8614c126b07b",
"sha256": "93d745141827e43170ebaf741813cde609a1060b4442c8bebb4da749d6689e89"
},
"downloads": -1,
"filename": "recaptcha_cracker-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "82e9eb85d4f56443982d8614c126b07b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 5230,
"upload_time": "2024-04-26T01:31:42",
"upload_time_iso_8601": "2024-04-26T01:31:42.938320Z",
"url": "https://files.pythonhosted.org/packages/19/b2/c3e5a0542149225bca9ea8eb8e47c0ac613b911d0e87e7e69c47a54fcc2d/recaptcha_cracker-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-26 01:31:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "wipodev",
"github_project": "Recaptcha_Cracker",
"github_not_found": true,
"lcname": "recaptcha-cracker"
}