feat: FlareSolverr CLI tool + skill for bypassing Cloudflare/DDoS-GUARD #61

New issue

Closed

opened 2026-06-05 14:08:26 -04:00 by jasper · 0 comments

jasper commented

2026-06-05 14:08:26 -04:00

Contributor

Summary

Add a FlareSolverr CLI tool and companion skill to the agent-skills catalog.

What is FlareSolverr?

FlareSolverr (github.com/FlareSolverr/FlareSolverr) is a proxy server that bypasses Cloudflare and DDoS-GUARD protection. It spins up a headless browser (Selenium with stealth plugins) to solve JavaScript challenge pages, then proxies the real response back. It runs as a Docker container and exposes a simple HTTP JSON API.

API Surface (v1)

Single endpoint: POST /v1
Commands: request.get, request.post, sessions.create, sessions.list, sessions.destroy
Request: { "cmd": "request.get", "url": "...", "session": "" }
Response: { "status": "ok", "solution": { "url": "...", "status": 200, "headers": {...}, "response": "<HTML>" } }
Sessions persist cookies/state across requests

Architecture Question: Standalone CLI or integrated into arr-cli?

FlareSolverr is best as its own standalone tool, not bolted into arr-cli:

Broader scope -- FlareSolverr is useful beyond the *arr stack: groktocrawl scraping, research pipelines, any web content behind Cloudflare. It is a general-purpose proxy, not a media-management tool.
Different domain -- arr-cli is for querying Radarr/Sonarr APIs. The *arr integration path for FlareSolverr is via Prowlarr proxy config (which already supports it), not via a CLI wrapping arr APIs.
Simple API -- ~4 commands maps cleanly to a standalone CLI.

Proposed CLI Shape

flaresolverr get GET a URL through FlareSolverr
flaresolverr post -d ... POST to a URL through FlareSolverr
flaresolverr session create Create a new browser session
flaresolverr session list List active sessions
flaresolverr session destroy Destroy a session
flaresolverr health Check server status

Global: --server URL (default http://localhost:8191), --max-timeout (default 60000)

Skill

Companion skill at skills/scraping/flaresolverr/ with:

SKILL.md -- trigger conditions, basic usage
references/setup.md -- Docker Compose config, environment variables
references/arr-integration.md -- Prowlarr proxy config

Filed by Jasper (AI agent on behalf of Magnus Hedemark)

## Summary Add a FlareSolverr CLI tool and companion skill to the agent-skills catalog. ## What is FlareSolverr? FlareSolverr (github.com/FlareSolverr/FlareSolverr) is a proxy server that bypasses Cloudflare and DDoS-GUARD protection. It spins up a headless browser (Selenium with stealth plugins) to solve JavaScript challenge pages, then proxies the real response back. It runs as a Docker container and exposes a simple HTTP JSON API. ## API Surface (v1) - Single endpoint: POST /v1 - Commands: request.get, request.post, sessions.create, sessions.list, sessions.destroy - Request: { "cmd": "request.get", "url": "...", "session": "<optional>" } - Response: { "status": "ok", "solution": { "url": "...", "status": 200, "headers": {...}, "response": "<HTML>" } } - Sessions persist cookies/state across requests ## Architecture Question: Standalone CLI or integrated into arr-cli? FlareSolverr is best as its own standalone tool, not bolted into arr-cli: 1. Broader scope -- FlareSolverr is useful beyond the *arr stack: groktocrawl scraping, research pipelines, any web content behind Cloudflare. It is a general-purpose proxy, not a media-management tool. 2. Different domain -- arr-cli is for querying Radarr/Sonarr APIs. The *arr integration path for FlareSolverr is via Prowlarr proxy config (which already supports it), not via a CLI wrapping arr APIs. 3. Simple API -- ~4 commands maps cleanly to a standalone CLI. ## Proposed CLI Shape flaresolverr get <url> GET a URL through FlareSolverr flaresolverr post <url> -d ... POST to a URL through FlareSolverr flaresolverr session create Create a new browser session flaresolverr session list List active sessions flaresolverr session destroy Destroy a session flaresolverr health Check server status Global: --server URL (default http://localhost:8191), --max-timeout (default 60000) ## Skill Companion skill at skills/scraping/flaresolverr/ with: - SKILL.md -- trigger conditions, basic usage - references/setup.md -- Docker Compose config, environment variables - references/arr-integration.md -- Prowlarr proxy config Filed by Jasper (AI agent on behalf of Magnus Hedemark)

jasper referenced this issue from a pull request that will close it,

2026-07-11 17:01:17 -04:00

feat(flaresolverr): add browser challenge CLI skill #104