Skip to main content

Captcha solver

Cinephage includes a built-in Captcha Solver that automatically handles Cloudflare challenges and other anti-bot protections. No external services like FlareSolverr required.


How It Works​

The Captcha Solver uses Camoufox - a privacy-focused Firefox fork with anti-detection features:

  1. Challenge Detection - Automatically detects Cloudflare/Turnstile challenges
  2. Browser Automation - Launches headless browser to solve challenges
  3. Cookie Caching - Stores successful cookies to minimize solves
  4. Health Monitoring - Tracks success rates and adjusts automatically

Configuration​

Navigate to Settings > Integrations > Captcha Solver:

Basic settings​

SettingDescriptionDefault
EnabledTurn solver on/offEnabled
TimeoutMax time to wait for solve (seconds)60
Cache TTLHow long to keep cookies (hours)1
HeadlessRun browser without GUIEnabled

Advanced settings​

SettingDescriptionDefault
ProxyHTTP proxy for browser (optional)None

Cookies are cached per-domain to minimize repeated challenges:

  • Automatic refresh - Cookies refreshed before expiration
  • Per-domain storage - Each indexer has isolated cookies
  • Manual clearing - Clear cookies if issues occur

Clearing cookies​

Via UI: Settings > Integrations > Captcha Solver > Clear Cache


Health Monitoring​

The solver tracks its own performance:

MetricDescription
Success RatePercentage of successful solves
Average Solve TimeHow long challenges take
Cached DomainsNumber of domains with valid cookies
Last ErrorMost recent failure reason

Troubleshooting​

Challenges not being solved​

  1. Check solver is enabled - Settings > Integrations > Captcha Solver
  2. Increase timeout - Some challenges take 30+ seconds
  3. Check logs - Look for "captcha" or "camoufox" errors
  4. Clear cookie cache - Corrupted cookies can cause failures

High failure rate​

  1. Disable headless mode - Temporarily to debug (requires display)
  2. Check proxy settings - If using proxy, verify it works
  3. Update Camoufox - Solver uses latest browser version automatically

Indexer still blocked​

Not all protection is Cloudflare:

  • DataDome - Currently not supported
  • PerimeterX - May work, not guaranteed
  • Custom challenges - Varies by site

Try alternative indexers if one is consistently blocked.


Performance Impact​

  • Memory: ~200MB per browser instance
  • CPU: Minimal when idle, spikes during solves
  • Disk: Cookies cached in database (~1KB per domain)

See Also​