mcpField
F
flaresolverr

flaresolverr

github.com/magnus919開発15359 回インストール1 日前に更新
リポジトリ

flaresolverr について

flaresolverrは、通常のHTTP取得がブラウザチャレンジに阻まれる場合に、起動済みのFlareSolverrを利用する軽量なコマンドラインスキルです。ヘルスチェック、GET・POSTリクエスト、セッション操作を行い、結果をJSONで返します。

主な機能

  1. 01ヘルスチェック、GET、POSTを実行
  2. 02セッションの作成・一覧・破棄
  3. 03リクエストのタイムアウト設定
  4. 04セッションによるCookieの継続利用
  5. 05応答情報をJSONで出力

活用シーン

  1. 01FlareSolverrインスタンスの状態確認
  2. 02ブラウザチャレンジ経由でページ応答を取得
  3. 03Cookieの継続利用が必要なサイトへのリクエスト

インストール

コマンドをコピーしてターミナルで実行します。

$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 を使用してください。

セットアップ

一般的には Docker を使用して、FlareSolverr を別途実行します。

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.shシェルのスモークテストです。--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 が返した内容を報告します。ページコンテンツの解析、抽出、順位付けは行いません。
  • ブラウザーチャレンジの解決が保証されるわけではありません。サイトは引き続きブラウザーをブロックしたり、CAPTCHA を要求したり、レート制限を適用したりする場合があります。また、--timeout が制限するのはリクエストの時間であり、対象の動作ではありません。

コメント

Markdown 対応