Boterdrop-Solver

English | Bahasa Indonesia

Turnstile, cf_clearance, Recaptcha & AWS WAF Token Solver

✅ Status: Confirmed working. This project is regularly tested and updated.

Inspired by: SGAHSCAJASCJ/Turnstile-Solver (Turnstile) — verfired8975/recaptcha-v3-solver (Recaptcha V3)

A high-performance solver for Cloudflare Turnstile CAPTCHA, cf_clearance, Recaptcha V3, and AWS WAF Tokens, built with FastAPI and asynchronous browser technology (Camoufox), providing a ready-to-use RESTful API service.

---

✨ Key Features

• 4 Solver Endpoints: /turnstile, /clearance, /aws-token, /recaptchaV3
• Auto Install & Fetch: Python dependencies and Camoufox are installed automatically on first run.
• Configuration via config.json: All settings can be configured via file or interactive prompt.
• Proxy Rotation: Per-browser-instance proxy support with round-robin rotation.
• Forced Cleanup: Periodic forced memory cleanup for server stability on low-RAM VPS.
• Headless & GUI Mode: Compatible for running via Terminal/VPS (xvfb) or RDP.

---

🚀 Installation & Setup (For New VPS)

Note: Repeated installation issues (camoufox fetch errors or browser dependency issues) on a new VPS are usually caused by incomplete browser cache data. The latest script version has fixed automatic camoufox version detection.

The recommended steps on a new Linux VPS (Ubuntu/Debian):

# 1. Update system & install browser system dependencies
sudo apt update -y && sudo apt upgrade -y
sudo apt install xvfb -y
sudo apt install libasound2 -y
sudo apt install python3 -y
sudo apt install python3-pip -y
sudo apt install python3-venv -y

# 2. Clone Repository
git clone https://github.com/najibyahya/Turnstile-Solver
cd Turnstile-Solver

# 3. Create & activate virtual environment (highly recommended)
python3 -m venv venv
source venv/bin/activate

# 4. Install base Python dependencies
pip install fastapi==0.95.2 uvicorn "camoufox[fetch]" loguru psutil playwright

# 5. FETCH & INSTALL DEPENDENCIES MANUALLY (DO THIS ONCE)
# This prevents "Version information not found" & "browser dependencies" issues
python3 -m camoufox fetch
python3 -m playwright install-deps
playwright install

# 6. Run the server
python3 api_server.py

INFO: If using headless mode (false):

source venv/bin/activate
xvfb-run -a python3 api_server.py

---

⚙️ Configuration (config.json)

On first run, the script will create a config.json file. You can edit it directly:

{
    "headless":      true,
    "thread":        2,
    "page_count":    1,
    "proxy_support": false,
    "proxy_file":    "proxies.txt",
    "host":          "0.0.0.0",
    "port":          8000,
    "debug":         false,
    "cleanup_interval_minutes": 10
}

Parameter	Type	Default	Description
headless	bool	true	Browser runs without a GUI
thread	int	2	Number of browser instances (recommended max = number of CPU cores)
page_count	int	1	Number of tabs/pages per browser
proxy_support	bool	false	Whether to use the proxy list from proxies.txt
cleanup_interval_minutes	int	10	Interval for refreshing/cleaning up browser memory

---

🌐 Proxy Format (proxies.txt)

If proxy_support is enabled, add proxies to proxies.txt (one proxy per line). Supported formats:

http://ip:port
http://user:pass@ip:port
socks5://user:pass@ip:port

📖 API Endpoint Documentation

This solver works asynchronously (creating a task queue). Each endpoint blocks until a token is successfully retrieved or returned with a failed status.

1. Task Creation Endpoints

Task	Endpoint	Required Parameters
Turnstile	GET /turnstile	url (Target URL), sitekey (Turnstile Key)
cf_clearance	GET /clearance	url (Target URL), timeout (optional, seconds)
AWS WAF	GET /aws-token	url (Target URL), timeout (optional, seconds)
reCAPTCHA v3	GET or POST to /recaptchaV3	url / domain (Target URL), sitekey / siteKey (reCAPTCHA Key), action (optional, default: submit)

🌐 Example HTTP Requests (cURL) for Task Creation

A. Cloudflare Turnstile (GET /turnstile)

curl -X GET "http://127.0.0.1:8001/turnstile?url=https://target.cc/&sitekey=0x4AAAAAxxxxxxxxETLYn"

B. Cloudflare cf_clearance (GET /clearance)

curl -X GET "http://127.0.0.1:8001/clearance?url=https://target.cc/&timeout=30"

C. AWS WAF Token (GET /aws-token)

curl -X GET "http://127.0.0.1:8001/aws-token?url=https://target.cc/waitlist&timeout=30"

D. Google reCAPTCHA v3 (GET or POST to /recaptchaV3)

• Using HTTP GET:

curl -X GET "http://127.0.0.1:8001/recaptchaV3?url=https://target.cc&sitekey=6Ldqxxxxxxxxxxxxxx19Tpa1XsSZfIW&action=submit"

• Using HTTP POST (JSON Body):

curl -X POST "http://127.0.0.1:8001/recaptchaV3" \
     -H "Content-Type: application/json" \
     -d '{"url": "https://target.cc", "sitekey": "6Ldqxxxxxxxxxxxxxx19Tpa1XsSZfIW", "action": "submit"}'

Example Successful Task Creation Response (202 Accepted):

{
  "task_id": "8a31e3d4-b41e-450f-a63c-94cc8193eb41",
  "status": "accepted"
}

---

2. Result Polling Endpoint (GET /result?id=<task_id>)

You must poll this endpoint at least every 1 second using the task_id from the task creation above, until status is either success or error.

Example Polling Request (cURL):

curl -X GET "http://127.0.0.1:8001/result?id=8a31e3d4-b41e-450f-a63c-94cc8193eb41"

Example Successful Response from Turnstile / reCAPTCHA v3:

{
  "status": "success",
  "elapsed_time": 2.431,
  "value": "0.AbCdEf..."
}

Example Successful Response from cf_clearance / AWS WAF:

{
  "status": "success",
  "elapsed_time": 3.102,
  "user_agent": "Mozilla/5.0 ...",
  "cookies": "cf_clearance=abcdef...;",
  "cf_clearance": "abcdef..."
}

HTTP Status Codes:

• 200 = Success.
• 202 = Still processing, keep polling GET /result.
• 404 = Task ID expired or not found.
• 408 = Timeout (> 5 minutes elapsed).
• 500/422 = Internal error or CAPTCHA solving failed.

---

📄 License

MIT License — See LICENSE.