mcpField
F
flaresolverr

flaresolverr

github.com/magnus919开发15359 次安装今天更新
代码仓库

关于 flaresolverr

flaresolverr 是一个依赖已运行 FlareSolverr 实例的轻量命令行技能，用于处理普通 HTTP 请求受浏览器挑战阻挡的情形。它提供健康检查、GET、POST 和会话操作，并以 JSON 返回结果。

主要功能

  1. 01执行健康检查、GET 和 POST
  2. 02创建、列出及销毁会话
  3. 03支持请求超时设置
  4. 04支持会话 Cookie 连续性
  5. 05以 JSON 输出响应信息

适用场景

  1. 01检查 FlareSolverr 实例状态
  2. 02通过浏览器挑战获取网页响应
  3. 03需要 Cookie 连续性的站点请求

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/flaresolverr确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
evals/
evals.json
scripts/
flaresolverr
test-flaresolverr.sh

详细介绍

FlareSolverr

快速开始

python3 scripts/flaresolverr --server http://localhost:8191 health

当常规 HTTP 获取因浏览器挑战而受阻时，使用此技能。FlareSolverr 必须已在运行；此技能不会绕过身份验证，也不会授权访问受限内容。

不适用场景

当任务指定使用该 CLI、需要创建／列出／销毁命名会话、需要仅返回 Cookie 的响应或试运行规划，或需要完整的操作命令集时，请使用 flaresolverr-cli。此技能仅适用于较简单的单次健康检查、GET 或 POST 操作。

操作授权门槛

健康检查命令仅用于只读发现。GET 和 POST 会向外部目标发送流量，POST 还可能改变目标状态。

操作前，请确认目标、范围和回滚方案。只读发现无需确认即可进行。

POST 或任何旨在改变目标状态的请求，都需要用户明确指示。此技能不授权删除、更改权限、绕过身份验证或进行不可逆的清理。

CLI

python3 flaresolverr/scripts/flaresolverr --server http://localhost:8191 health
python3 flaresolverr/scripts/flaresolverr --server http://localhost:8191 get https://example.com
python3 flaresolverr/scripts/flaresolverr session create
python3 flaresolverr/scripts/flaresolverr session list
python3 flaresolverr/scripts/flaresolverr session destroy SESSION_ID

每条命令都会输出 JSON。get 和 post 使用 FlareSolverr 的 /v1 API，并保留返回的状态、URL、标头和响应正文。使用 --timeout 限制请求时长；如果网站需要保持 Cookie 连续性，则使用 --session。

设置

单独运行 FlareSolverr，通常使用 Docker：

services:
  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    ports: ["8191:8191"]
    environment:
      LOG_LEVEL: info

不要将此服务公开暴露。生产环境中优先使用固定的镜像标签，并参阅供应商文档了解浏览器和平台兼容性。

可用脚本

脚本用途调用方式
scripts/flaresolverrFlareSolverr API 的精简 JSON CLI，提供 health、get、post 和 session 子命令，以及 --server 和 --timeout 选项。对于上述单次健康检查或用于解决挑战的 GET／POST，可运行此脚本；如果网站需要保持 Cookie 连续性，也可用于短期会话的创建／列出／销毁。python3 scripts/flaresolverr --server http://localhost:8191 get https://example.com
scripts/test-flaresolverr.shShell 冒烟测试：验证 --help 输出并对 CLI 进行字节编译。修改 scripts/flaresolverr 后或审查捆绑脚本时运行。CI 会通过 scripts/check-skill-tests.py 运行此测试。sh scripts/test-flaresolverr.sh

前置条件

  • Python 3，仅使用标准库；此 CLI 没有第三方依赖。
  • 可访问的 FlareSolverr 实例（通常根据上文的设置部分通过 Docker 运行）——此 CLI 是客户端，本身不会启动任何服务。
  • FlareSolverr 实例能够访问目标网站的网络连接；此技能不会绕过身份验证，也不会授予你原本无权获取内容的访问权限。

限制

  • 此封装仅涵盖单次 health、get、post 和 session 操作；命名会话的生命周期管理、仅返回 Cookie 的响应和试运行规划应使用 flaresolverr-cli（参见“不适用场景”）。
  • 每条命令都会输出 JSON 并报告 FlareSolverr 返回的内容；它不会为你解析、提取或排序页面内容。
  • 解决浏览器挑战并不保证一定成功：网站仍可能拦截浏览器、要求完成验证码或限制速率；--timeout 只限制请求时长，不限制目标网站的行为。

评论

支持 Markdown