Flaresolverr cli

Skill magnus919/agent-skills/flaresolverr-cli

Use a small FlareSolverr JSON CLI for browser-backed GET and POST requests, readiness checks, and session lifecycle management when a site requires Cloudflare or DDoS-GUARD challenge handling.From its SKILL.md

Install

npx -y skills add magnus919/agent-skills --skill flaresolverr-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.5 KB, 483 tokens by cl100k_base, as published. Nobody here has run it

FlareSolverr CLI

Use this CLI with a running private FlareSolverr service when ordinary HTTP requests encounter a browser challenge. It sends JSON commands to FlareSolverr's /v1 API.

Quick Start

export FLARESOLVERR_SERVER="http://localhost:8191"
python3 scripts/flaresolverr-cli health

FLARESOLVERR_SERVER is optional and defaults to http://localhost:8191. Use --server URL to override it for one command and --timeout SECONDS to set the HTTP timeout; the default is 60 seconds.

Commands

flaresolverr-cli [--server URL] [--timeout SECONDS] health
flaresolverr-cli [--server URL] [--timeout SECONDS] get URL [--session ID]
flaresolverr-cli [--server URL] [--timeout SECONDS] post URL [--session ID] [--data FORM_BODY]
flaresolverr-cli [--server URL] [--timeout SECONDS] session create
flaresolverr-cli [--server URL] [--timeout SECONDS] session list
flaresolverr-cli [--server URL] [--timeout SECONDS] session destroy [SESSION_ID]

health is a readiness probe that sends the sessions.list JSON command to /v1; it does not call GET /health.

get sends request.get. post sends request.post and includes FORM_BODY as postData when --data is supplied. --session ID adds the given session to either request. Session commands create, list, or destroy FlareSolverr sessions; omitting SESSION_ID from session destroy sends an empty session value.

Output And Errors

Successful commands print one JSON result to stdout. Request failures print a JSON error to stderr and return a nonzero status.

Requirements

Python 3.8+ with no pip dependencies and a running FlareSolverr instance. Keep the service private and use it only for sites you are authorized to access.

References

scripts/flaresolverr-cli - Stdlib-only CLI implementation.
FlareSolverr - Service and API documentation.

What ships with it: 2 files

1.9 KB alongside SKILL.md

scripts/

flaresolverr-cli39 B

README.md1.8 KB