proxy-manager

Webshare Proxy Manager

webshare CLI を使って、Webshare のプロキシアカウントの管理を支援します。プロキシの一覧表示、プールの更新、認証の設定、プロキシ URL の作成、使用状況の確認、エクスプレスチェックアウトによる容量の追加購入を行います。

このスキルでできること／必要なもの／行わないこと

できること： 以下のワークフローに記載された操作を、webshare CLI コマンドを通じてすべて実行します。

必要なもの：

1. webshare CLI — brew install webshare-proxy/tap/webshare でインストールするか、 https://github.com/webshare-proxy/webshare-cli/releases からバイナリをダウンロードします。
2. Webshare アカウント — https://www.webshare.io/ で登録します（カード不要で、プロキシを 10 個無料で利用できます）。
3. https://dashboard.webshare.io/userapi/keys の API キーを WEBSHARE_API_KEY としてエクスポートします。webshare whoami で確認してください。

行わないこと：

• 個別プロキシの指定置換 — CLI にはプロキシごとの置換コマンドがありません。webshare proxies refresh はリスト 全体 を置き換えます。特定のブロックされた IP を置き換える場合は、関連する proxy-optimizer スキルまたはダッシュボードを案内してください。
• ヘッドレス購入 — チェックアウトは必ずブラウザーで完了します。エクスプレスチェックアウトスクリプトはページに入力する内容を事前入力するだけです。
• スクレイピング。これは scraper スキルの対象です。

ワークフロー

ステップ 1：対象プランを特定する

Webshare アカウントでは、複数のプランを同時に保有できます。プロキシ、設定、IP 許可リストに影響する操作を行う前に、次を実行します。

webshare plans list

有効なプランが複数ある場合は、一覧（ID、種類、プロキシ数、ステータス）を表示し、どのプランを操作するか尋ねます（AskUserQuestion を使用）。その後、以降のすべてのコマンドに --plan <id> を指定します。プランが 1 つだけの場合は確認を省略できますが、コマンド履歴から意図が明確になるよう、--plan は明示的に指定してください。webshare plans show <plan-id> で詳細を確認できます。

ステップ 2：操作を実行する

ユーザーが希望する操作を尋ねます（不明な場合は AskUserQuestion を使用します）。

• plans — webshare plans list ／ webshare plans show <plan-id>
• list — webshare proxies list --plan <id>（フィルター：--country us,fr、 --limit N、--mode direct|backbone；形式：--format txt|csv|json）
• download — webshare proxies list --plan <id> > proxies.txt を実行すると、 多くのツールで受け付けられる標準形式の address:port:username:password 行が書き込まれます。 webshare proxies download は、サーバーでレンダリングされたリストを代わりに取得します （IP 認証の設定では --auth sourceip を指定します）。
• proxy-url — webshare proxy-url でそのまま使える接続 URL を作成します。 リクエストごとにローテーションするには --country us --rotate、スティッキーセッションのワーカープールには --sessions 5、1 つのセッションに固定するには --session <id> を指定します。
• config — webshare config show ／ webshare config set（--username、 --password、--request-timeout、--idle-timeout）
• ipauth — webshare ipauth list ／ webshare ipauth add --current（または明示した IP）／ webshare ipauth remove <id-or-ip>
• stats — webshare stats --since 24h（または --hourly）； webshare activity list --error '*' で最近の失敗したリクエストを表示します。
• refresh — webshare proxies refresh でリスト全体を置き換えます； webshare proxies replaced で過去の置換と後継を表示します。
• buy — ブラウザーでエクスプレスチェックアウト URL を開きます（以下を参照）。

すべてのフラグのリファレンスと JSON 出力に関する注意事項は、references/CLI.md を参照してください。

プロキシの購入（エクスプレスチェックアウト）

scripts/express_checkout.py を使用します。適切なクエリ文字列を含むダッシュボード URL を作成し、既定のブラウザーで開きます。次の 6 つのプリセットに対応しています。

• datacenter-shared ／ datacenter-semidedicated ／ datacenter-dedicated
• isp-shared ／ isp-semidedicated ／ isp-dedicated（静的レジデンシャル）
• residential（ローテーション式レジデンシャル。共有のみ）

プリセット、プロキシ数、帯域幅（GB、データセンター／ISP のみ）、国（ISO コード → 数の辞書、または任意の国を示す ZZ）をユーザーに尋ねます。例：

python scripts/express_checkout.py datacenter-dedicated \
  --count 75 --bandwidth 5000 --countries ZZ=75

スクリプトは URL を出力し、ブラウザーを開きます。ユーザーはダッシュボードで手動でチェックアウトを完了します。ヘッドレスで購入する方法はありません。

重要な原則

• API キーを決して表示しないでください。 CLI は環境変数 WEBSHARE_API_KEY を読み取ります。キーをエコーしたり、コマンドに貼り付けたりしないでください。
• 変更を加える前に確認してください。 webshare proxies refresh はオンデマンドの更新を消費し、すべてのプロキシを置き換えます。必ず事前にユーザーに確認し、CLI 独自の確認プロンプトをそのまま表示してください（ユーザーから明示的に依頼されない限り、--yes は渡さないでください）。config set、ipauth remove、subusers delete でも同様に注意してください。
• 解析が必要な場合は --json を優先してください。 すべてのコマンドで利用でき、パイプに渡した出力は自動的に機械可読になります。
• 国コードは ISO 3166-1 alpha-2 です。 ZZ は「任意の国」を意味します。
• レジデンシャルプランはバックボーン専用です。 proxies list が何も返さない場合は、--mode backbone または webshare proxy-url を試してください。