关于 flaresolverr-cli
一个 Python 命令行技能,在普通 HTTP 请求遇到浏览器挑战时调用正在运行的私有 FlareSolverr 服务。它通过服务的 `/v1` API 支持请求、会话管理和就绪检查。
主要功能
- 01服务就绪探测
- 02GET 与 POST 请求
- 03请求可选指定会话
- 04创建、列出和销毁会话
- 05JSON 输出与错误报告
适用场景
- 01检查 FlareSolverr 服务是否就绪
- 02通过 FlareSolverr 重试获准访问的请求
- 03维护请求会话
- 04使用 POST 请求发送表单数据
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ magnus919/ agent-skills --skill flaresolverr-cli安装后在 Claude Code 中输入/flaresolverr-cli确认已加载。
附带文件evals/evals.jsonREADME.md
详细介绍
FlareSolverr 命令行工具
当普通 HTTP 请求遇到浏览器验证时,可使用此命令行工具连接正在运行的私有 FlareSolverr 服务。它会向 FlareSolverr 的 /v1 API 发送 JSON 命令。
快速开始
export FLARESOLVERR_SERVER="http://localhost:8191"
python3 scripts/flaresolverr-cli health
FLARESOLVERR_SERVER 为可选项,默认值为 http://localhost:8191。使用 --server URL 可为单条命令指定其他服务地址,使用 --timeout SECONDS 可设置 HTTP 超时时间;默认值为 60 秒。
命令
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 是就绪探测,会向 /v1 发送 sessions.list JSON 命令;它不会调用 GET /health。
get 会发送 request.get。post 会发送 request.post,并在提供 --data 时将 FORM_BODY 作为 postData 传入。--session ID 会将指定会话添加到任一请求中。会话命令用于创建、列出或销毁 FlareSolverr 会话;在 session destroy 中省略 SESSION_ID 时,会发送空会话值。
输出和错误
成功的命令会将一个 JSON 结果输出到 stdout。请求失败时,会将 JSON 错误输出到 stderr,并返回非零状态码。
要求
Python 3.8+,无需 pip 依赖,并且需要有正在运行的 FlareSolverr 实例。请将服务保持为私有服务,且仅用于访问你获准访问的网站。
参考资料
- scripts/flaresolverr-cli - 仅使用标准库实现的命令行工具。
- FlareSolverr - 服务和 API 文档。