Metadata-Version: 2.1
Name: reborn2022
Version: 1.4
Summary: Paket python untuk menyelesaikan recaptchav2
Home-page: https://github.com/xnoxs-dev/reborn2022
Author: PetapaGenit
Author-email: khaerudin2119@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: aiohttp==3.10.10
Requires-Dist: selenium==4.28.1
Requires-Dist: Quart==0.19.9
Requires-Dist: pydub==0.25.1
Requires-Dist: SpeechRecognition==3.10.4
Requires-Dist: Flask==3.1.0

# **Solver reCAPTCHA v2**  

**Modul Python untuk menyelesaikan reCAPTCHA v2 secara otomatis menggunakan Selenium dan pengenalan suara.** Modul ini dirancang untuk bekerja dengan tantangan audio reCAPTCHA.  

## **Fitur**  
- Mengotomatisasi interaksi dengan reCAPTCHA v2.  
- Mendukung penyelesaian tantangan audio reCAPTCHA.  
- Menggunakan **Selenium**, **pydub**, dan **SpeechRecognition** untuk menyelesaikan CAPTCHA secara otomatis.  

---  

## **Instalasi**  

### **Persyaratan:**  
1. Pastikan Python **3.8+** sudah terinstal di sistem Anda.  
2. Siapkan virtual environment untuk mengisolasi dependensi:  
   ```bash
   python3 -m venv venv
   source venv/bin/activate  # Linux/macOS
   venv\Scripts\activate     # Windows
   ```
3. Instal modul menggunakan pip:  
   ```bash
   pip install reborn2022
   ```  

---  

## **Penggunaan**  

### **1. Menggunakan Fungsi Langsung di Kode Python**  

1. Pastikan Anda memiliki **driver Selenium** yang sesuai dengan browser yang digunakan (misalnya, ChromeDriver untuk Google Chrome) dan letakkan di dalam direktori `/usr/bin/` atau di lokasi yang ada di sistem PATH Anda.  
2. Impor modul dan gunakan fungsinya dalam kode Python Anda:  
   ```python
   from reborn2022.recaptcha import solve_recaptcha

   url = "https://www.google.com/recaptcha/api2/demo"
   token = solve_recaptcha(url, headless=True)  # headless default True

   print(token)
   ```
3. Fungsi `solve_recaptcha` akan secara otomatis membuka halaman reCAPTCHA, berinteraksi dengan tantangan audio, dan mengembalikan token hasil penyelesaiannya.  

---  

### **2. Menggunakan API Lokal (Server Lokal)**  

Anda juga dapat menjalankan solver reCAPTCHA sebagai **server lokal** dengan menggunakan **Quart**, lalu mengaksesnya melalui request API.  

#### **Menjalankan Server Lokal**  

Buat file Python (misalnya `run_server.py`) dengan isi berikut:  

```python
import asyncio
from reborn2022.api_solver import start_api

host = "127.0.0.1"  # Jalankan di localhost
port = 5000         # Gunakan port 5000
debug = False       # Matikan mode debug untuk produksi

start_api(host=host, port=port, debug=debug)
```

Jalankan server dengan perintah berikut di terminal:  

```bash
python run_server.py
```

Jika server berjalan dengan benar, Anda akan melihat bahwa API tersedia di `http://127.0.0.1:5000/solve`.  

#### **Menggunakan API Solver di File Terpisah**  

Setelah server berjalan, buat file Python baru (misalnya `solve_captcha.py`) dan gunakan kode berikut untuk mengirim permintaan ke server:  

```python
import asyncio
from reborn2022.test_solver import test_solver

async def main():
    token = await test_solver(
        "https://www.google.com/recaptcha/api2/demo"
    )
    print(token)

asyncio.run(main())
```

Jalankan file ini di terminal lain untuk mendapatkan token reCAPTCHA:  

```bash
python solve_captcha.py
```

Jika berhasil, Anda akan mendapatkan token hasil penyelesaian CAPTCHA dalam output terminal.  

---  

## **Dependensi**  

Modul ini bergantung pada pustaka berikut, yang akan diinstal secara otomatis:  
- **Selenium** – untuk mengotomatisasi interaksi dengan browser.  
- **pydub** – untuk memproses file audio dari tantangan reCAPTCHA.  
- **SpeechRecognition** – untuk mengenali teks dari audio CAPTCHA.  
- **Quart** – untuk menjalankan solver sebagai server API.  
- **aiohttp** – untuk membuat permintaan HTTP asinkron ke API solver.  

---  

## **Masalah yang Diketahui**  
- Modul ini **hanya** mendukung tantangan audio reCAPTCHA v2, **tidak** untuk tantangan berbasis gambar.  
- Beberapa situs web mungkin memiliki perlindungan tambahan yang dapat memblokir otomatisasi ini.  

---  

## **Kontribusi**  
Kami menyambut kontribusi dari komunitas! Jika Anda ingin berkontribusi pada pengembangan modul ini, silakan:  
1. Buat **pull request** dengan perubahan atau perbaikan yang diusulkan.  
2. Laporkan masalah atau ajukan saran melalui **issue** di repository proyek.  

---  

## **Lisensi**  
Proyek ini dilisensikan di bawah **[MIT License](LICENSE)**, yang memungkinkan penggunaan bebas dengan batasan minimal.  






