rcs

ReCAPTCHA v2 Solver API

A powerful, autonomous ReCAPTCHA v2 solver using Camoufox (Firefox-based stealth browser) and Faster-Whisper for high-accuracy audio transcription. Designed to run on servers (VPS) with optional GUI support via Xvfb.

Features

• Stealth: Uses Camoufox to bypass advanced bot detection.
• Accuracy: Powered by OpenAI's Whisper (Faster-Whisper implementation) for audio challenges.
• Robust: Includes auto-retry and proxy rotation logic.
• API Ready: Flask-based REST API for remote solving.
• Dockerized: Ready for deployment on VPS or Hugging Face Spaces.

Prerequisites (System Dependencies)

If running without Docker, ensure your VPS has:

sudo apt update
sudo apt install -y firefox-geckodriver xvfb ffmpeg flac libdbus-glib-1-2 libxt6

Installation (Local/VPS)

1. Set up environment:

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   

Docker Usage

1. Build the image:

   docker build -t recaptcha-solver .
   

2. Run the container:

   docker run -p 8002:8002 recaptcha-solver
   

API Endpoints

• POST /solve: Send {"url": "site_url"} to start solving.
• GET /status/<job_id>: Retrieve the solved g-recaptcha-response token.

Hugging Face Spaces

This project is configured for Hugging Face Spaces using the Docker SDK. Simply upload the files to a new Space, and it will automatically build and run.