Metadata-Version: 2.4
Name: v3cap
Version: 0.0.3
Summary: reCAPTCHA v3 solver package
Author-email: TanmoyTheBoT <tanmoysarkershuvo@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/TanmoyTheBoT/v3cap
Project-URL: Issues, https://github.com/TanmoyTheBoT/v3cap/issues
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: fastapi>=0.115.12
Requires-Dist: requests>=2.32.3
Requires-Dist: seleniumbase>=4.38.3
Requires-Dist: uvicorn>=0.34.2
Dynamic: license-file

# v3cap

<div align="center">

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![PyPI version](https://badge.fury.io/py/v3cap.svg)](https://badge.fury.io/py/v3cap) [![PyPI Downloads](https://static.pepy.tech/badge/v3cap)](https://pepy.tech/projects/v3cap)

</div>

Solve reCAPTCHA v3 challenges automatically - Python package with API support.

## ⚡ Installation
```bash
pip install v3cap
```

## 🚀 Usage

### Python Package
```python
from v3cap import get_recaptcha_token

token = get_recaptcha_token(
    site_key="6LcwvFgrAAAAAG5UjzyiOkNe-3ekjPHJv0FUzeVy",
    page_url="https://demo-v3cap.vercel.app",
    action="demo/v3cap"
)
print(token)
```

### API Server
```bash
# Start server
v3cap

# Alternative
python -m v3cap
```
Server runs on http://0.0.0.0:8000

### API Endpoints
- `POST /solve_recaptcha/`
  - Parameters: `site_key`, `page_url`, `action`
  - Returns: JSON with token

### Docker
```bash
docker build -t v3cap .
docker run -p 8000:8000 v3cap
```

## 📋 Requirements
- Python 3.10+
- Chrome
- ChromeDriver

## ⚠️ Disclaimer
This tool is intended for educational and testing purposes only. Using this tool to circumvent reCAPTCHA on websites may violate their terms of service. Users are responsible for ensuring they have proper authorization to use this tool on any website. The author takes no responsibility for misuse of this software.

## 📄 License
MIT
