mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-15 05:26:28 +03:00
45 lines
2.3 KiB
Markdown
45 lines
2.3 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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](https://github.com/FlareSolverr/FlareSolverr) instance (Docker: `ghcr.io/flaresolverr/flaresolverr`). Set `FLARESOLVERR_URL` to the server address (defaults to `http://localhost:8191`).
|