flaresolverr-cli について
通常のHTTPリクエストがブラウザチャレンジに遭遇した際、稼働中のプライベートなFlareSolverrを利用するPython CLIスキルです。サービスの`/v1` APIを通じて、リクエスト、セッション管理、稼働確認を行います。
主な機能
- 01稼働確認プローブ
- 02GET・POSTリクエスト
- 03リクエストごとのセッション指定
- 04セッションの作成・一覧・削除
- 05JSON出力とエラー報告
活用シーン
- 01FlareSolverrの稼働確認
- 02許可されたリクエストをFlareSolverr経由で再試行
- 03リクエストセッションの管理
- 04POSTでのフォームデータ送信
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/flaresolverr-cliを入力して読み込まれたか確認します。
同梱ファイルevals/evals.jsonREADME.md
詳細
FlareSolverr CLI
通常の HTTP リクエストでブラウザーチャレンジが発生した場合は、稼働中のプライベートな FlareSolverr サービスとこの CLI を使用します。FlareSolverr の /v1 API に JSON コマンドを送信します。
クイックスタート
export FLARESOLVERR_SERVER="http://localhost:8191"
python3 scripts/flaresolverr-cli health
FLARESOLVERR_SERVER は省略可能で、デフォルトは http://localhost:8191 です。1 つのコマンドで上書きするには --server URL を使用し、HTTP タイムアウトを設定するには --timeout SECONDS を使用します。デフォルトは 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 を省略すると、空のセッション値が送信されます。
出力とエラー
コマンドが成功すると、1 つの JSON 結果が標準出力に表示されます。リクエストが失敗すると、JSON エラーが標準エラー出力に表示され、ゼロ以外のステータスが返されます。
要件
Python 3.8 以降（pip 依存関係なし）と、稼働中の FlareSolverr インスタンスが必要です。サービスはプライベートに保ち、アクセスを許可されているサイトでのみ使用してください。
参考資料
- scripts/flaresolverr-cli - 標準ライブラリのみを使用した CLI の実装です。
- FlareSolverr - サービスおよび API のドキュメントです。