magnus919_agent-skills/flaresolverr-cli

Cloudflare Bypass Proxy from the Terminal

Drive a FlareSolverr instance from the command line. FlareSolverr is an open-source proxy server that launches a headless Chrome browser to solve Cloudflare and DDoS-GUARD JavaScript challenges, returning the unblocked HTML and cookies to your client.

Why Install This Skill

When your agent loads this skill, it can interact with any FlareSolverr proxy server without writing raw HTTP requests. That means:

• Check server health — verify the FlareSolverr instance is running and ready before sending traffic
• Manage browser sessions — create, list, and destroy persistent headless Chrome sessions for fast, stateful scraping
• Solve Cloudflare challenges — fetch pages behind Cloudflare and DDoS-GUARD protection with a single command, getting back unblocked HTML, cookies, and user-agent strings
• Structured output — every command supports --json for piping into scripts and --dry-run for previewing API calls before making them

FlareSolverr is widely used in the *arr ecosystem (Prowlarr, Jackett) and by anyone who needs reliable access to Cloudflare-protected sites. This CLI makes it first-class for agent workflows.

What You Get

Directory	Purpose
SKILL.md	Complete command reference with flag tables, examples, and gotchas
scripts/flaresolverr-cli	Single-file Python CLI (stdlib only, zero pip dependencies)
tests/test_cli.py	Deterministic smoke tests covering all commands in dry-run mode

Quick Start

# Start FlareSolverr (one-time setup)
docker run -d --name=flaresolverr -p 8191:8191 ghcr.io/flaresolverr/flaresolverr:latest

# Point the CLI at it
export FLARESOLVERR_URL="http://localhost:8191"

# Verify it works
./scripts/flaresolverr-cli health
./scripts/flaresolverr-cli info

Triggers

Load this when the user mentions FlareSolverr, Cloudflare bypass, anti-bot proxy, headless browser proxy, or needs to fetch a page behind Cloudflare or DDoS-GUARD protection.

Requirements

Python 3.8+ (stdlib only, no pip installs needed). A running FlareSolverr instance (Docker: ghcr.io/flaresolverr/flaresolverr). Set FLARESOLVERR_URL to the server address (defaults to http://localhost:8191).