Claude Skill

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. Do not use this skill for unrelated requests; route to the nearest named specialist.

LLM Mart · 0 points · 10 views 0 listing impressions 0 install-command copies
Virus-scanned Reviewed automatically before listing.

Full trust report

Download magnus919-agent-skills-flaresolverr-cli-addad86.zip · 3 KB
magnus919/agent-skills 96 9 forks MIT Updated 10h ago
Part of magnus919/agent-skills — 145 skills

Install

skills CLI npx skills add https://github.com/magnus919/agent-skills/tree/main/flaresolverr-cli
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install magnus919-agent-skills@llmmart
Git git clone https://github.com/magnus919/agent-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole magnus919/agent-skills collection as a plugin from our marketplace. Git is the plain clone.

README

FlareSolverr CLI: Browser-Backed Requests From the Terminal

Why Install This Skill

Use this skill when an authorized site requires a browser-backed request to handle a Cloudflare or DDoS-GUARD challenge. It gives an agent a small terminal interface for sending GET and POST requests through an existing private FlareSolverr service.

It also provides a readiness probe and browser-session lifecycle commands, without requiring a Python package or raw HTTP request construction. Results are JSON, making them practical to inspect or pass to another tool.

What You Get

Path Purpose
SKILL.md Agent-facing command reference and safe-use guidance.
scripts/flaresolverr-cli Dependency-free Python CLI for FlareSolverr's /v1 API.

Quick Start

# Run FlareSolverr separately, then optionally set its address.
export FLARESOLVERR_SERVER="http://localhost:8191"

# Verify the service is ready.
python3 scripts/flaresolverr-cli health

# Send a browser-backed request.
python3 scripts/flaresolverr-cli get https://example.com

FLARESOLVERR_SERVER defaults to http://localhost:8191. Add --server URL for a one-command override or --timeout SECONDS to change the 60-second HTTP timeout. Successful commands write JSON to stdout; request failures write JSON to stderr and exit nonzero.

Triggers

  • A Cloudflare or DDoS-GUARD browser challenge blocks an authorized request.
  • A workflow needs browser-backed GET or POST requests through an existing FlareSolverr service.
  • A workflow needs to check FlareSolverr readiness or create, list, or destroy a session.

Requirements

Python 3.8+ with no pip dependencies. A running private FlareSolverr instance is required. Do not expose that service publicly, and use it only for sites you are authorized to access.

Skill manifest

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

Files (agent-skills)
  • evals
    • evals.json 2.8 KB 
      {
  "schema_version": 1,
  "skill_name": "flaresolverr-cli",
  "evals": [
    {
      "id": "flaresolverr-cli-core-workflow",
      "prompt": "Use flaresolverr cli to handle a realistic primary task. Explain the inputs, ordered workflow, and concrete output.",
      "expected_output": "A flaresolverr cli response defines the task boundary, identifies required inputs, applies the documented workflow, and produces a concrete output with verification.",
      "assertions": [
        "Names the flaresolverr cli task and required inputs",
        "Applies an ordered workflow rather than generic advice",
        "Produces a concrete output and verification step"
      ]
    },
    {
      "id": "flaresolverr-cli-failure-diagnosis",
      "prompt": "A flaresolverr cli task is failing with an ambiguous symptom. Diagnose it and give a bounded recovery path.",
      "expected_output": "The response separates symptoms from causes, proposes evidence-gathering checks, and gives a reversible recovery path with a stop condition.",
      "assertions": [
        "Separates symptom, hypothesis, and evidence",
        "Uses targeted diagnostic checks",
        "Includes a reversible recovery and stop condition"
      ]
    },
    {
      "id": "flaresolverr-cli-safety-boundary",
      "prompt": "Plan a flaresolverr cli change that could affect user data or external state. Show the safety gate before acting.",
      "expected_output": "The response confirms scope and authority, defaults to read-only or dry-run inspection, and requires explicit confirmation before consequential mutation.",
      "assertions": [
        "Confirms target, scope, and authority before mutation",
        "Uses read-only or dry-run inspection first",
        "Requires explicit confirmation for consequential changes"
      ]
    },
    {
      "id": "flaresolverr-cli-edge-case",
      "prompt": "Apply flaresolverr cli when requirements conflict or an important input is missing. Decide what to do next.",
      "expected_output": "The response identifies the missing or conflicting constraint, refuses to invent facts, and escalates or requests the smallest clarifying input needed.",
      "assertions": [
        "Identifies the missing or conflicting constraint",
        "Does not invent unavailable facts",
        "Requests clarification or escalates with a bounded next step"
      ]
    },
    {
      "id": "flaresolverr-cli-evidence-handoff",
      "prompt": "Create a review-ready flaresolverr cli handoff for another practitioner.",
      "expected_output": "The handoff records assumptions, decisions, artifacts, validation evidence, and unresolved risks so another practitioner can reproduce the result.",
      "assertions": [
        "Records assumptions and decisions",
        "Links concrete artifacts to validation evidence",
        "States unresolved risks and reproducible next steps"
      ]
    }
  ]
}
  • README.md 1.8 KB 
    # FlareSolverr CLI: Browser-Backed Requests From the Terminal

## Why Install This Skill

Use this skill when an authorized site requires a browser-backed request to handle a Cloudflare or DDoS-GUARD challenge. It gives an agent a small terminal interface for sending GET and POST requests through an existing private FlareSolverr service.

It also provides a readiness probe and browser-session lifecycle commands, without requiring a Python package or raw HTTP request construction. Results are JSON, making them practical to inspect or pass to another tool.

## What You Get

| Path | Purpose |
|---|---|
| `SKILL.md` | Agent-facing command reference and safe-use guidance. |
| `scripts/flaresolverr-cli` | Dependency-free Python CLI for FlareSolverr's `/v1` API. |

## Quick Start

```sh
# Run FlareSolverr separately, then optionally set its address.
export FLARESOLVERR_SERVER="http://localhost:8191"

# Verify the service is ready.
python3 scripts/flaresolverr-cli health

# Send a browser-backed request.
python3 scripts/flaresolverr-cli get https://example.com
```

`FLARESOLVERR_SERVER` defaults to `http://localhost:8191`. Add `--server URL` for a one-command override or `--timeout SECONDS` to change the 60-second HTTP timeout. Successful commands write JSON to stdout; request failures write JSON to stderr and exit nonzero.

## Triggers

- A Cloudflare or DDoS-GUARD browser challenge blocks an authorized request.
- A workflow needs browser-backed GET or POST requests through an existing FlareSolverr service.
- A workflow needs to check FlareSolverr readiness or create, list, or destroy a session.

## Requirements

Python 3.8+ with no pip dependencies. A running private [FlareSolverr](https://github.com/FlareSolverr/FlareSolverr) instance is required. Do not expose that service publicly, and use it only for sites you are authorized to access.
  • SKILL.md 2.6 KB 
    ---
name: flaresolverr-cli
description: >-
  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. Do not use this skill for unrelated requests; route to the nearest
  named specialist.
license: MIT
compatibility: Python 3.8+ (stdlib only). Requires a running FlareSolverr instance; FLARESOLVERR_SERVER defaults to http://localhost:8191.
metadata:
  tags: flaresolverr, cloudflare, proxy, anti-bot, headless-browser, web-scraping
  sources: https://github.com/FlareSolverr/FlareSolverr, https://hub.docker.com/r/flaresolverr/flaresolverr
---

# 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

```sh
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

```text
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](scripts/flaresolverr-cli) - Stdlib-only CLI implementation.
- [FlareSolverr](https://github.com/FlareSolverr/FlareSolverr) - Service and API documentation.

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.

Related

Claude Prompt
Tighten-my-prose editing prompt
Claude Skill
Adversarial code-review skill for Claude
Claude Workflow
Deep-research workflow (fan-out + verify)
Claude Skill
Conventional-commit writer for Claude