mcpField
F
flaresolverr-cli

flaresolverr-cli

github.com/magnus919Development15357 installsUpdated today
Repository

About flaresolverr-cli

A Python CLI skill for using a running private FlareSolverr service when standard HTTP requests face browser challenges. It supports request commands, session management, and readiness checks through the service's `/v1` API.

Key features

  1. 01Health readiness probe
  2. 02GET and POST requests
  3. 03Optional session per request
  4. 04Create, list, and destroy sessions
  5. 05JSON output and error reporting

Use cases

  1. 01Checking FlareSolverr service readiness
  2. 02Retrying authorized requests through FlareSolverr
  3. 03Maintaining request sessions
  4. 04Sending form data with POST requests

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/magnus919/agent-skills --skill flaresolverr-cli

After installing, type/flaresolverr-cliin Claude Code to confirm it loaded.

Bundled filesevals/evals.jsonREADME.md

Details

From the project README

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

Comments

Markdown supported