mcpField
P
proxy-manager

proxy-manager

github.com/webshare-proxy云与 DevOps7646 次安装3 周前更新
代码仓库

关于 proxy-manager

proxy-manager 是通过 `webshare` CLI 管理 Webshare 代理账户的技能，涵盖代理操作、用量查看、配置和通过浏览器购买容量。

主要功能

  1. 01查看计划和代理
  2. 02下载代理列表
  3. 03生成代理连接 URL
  4. 04管理认证和设置
  5. 05查看用量及失败请求
  6. 06刷新代理池并准备购买

适用场景

  1. 01检查不同 Webshare 计划的代理
  2. 02导出供其他工具使用的代理凭据
  3. 03监控用量和失败请求
  4. 04刷新代理池或准备购买

安装

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

$npx skills add https://github.com/webshare-proxy/skills --skill proxy-manager

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

附带文件references/CLI.mdscripts/express_checkout.py

详细介绍

Webshare 代理管理器

通过 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>。如果恰好只有一个套餐，可以跳过询问，但仍应显式传入 --plan，以便在命令历史中清楚表明操作意图。webshare plans show <plan-id> 可显示完整详情。

第 2 步：执行操作

询问用户需要执行哪项操作（如果不明确，请使用 AskUserQuestion）：

  • 套餐 — webshare plans list / webshare plans show <plan-id>
  • 列出 — webshare proxies list --plan <id>（筛选条件：--country us,fr、 --limit N、--mode direct|backbone；格式：--format txt|csv|json）
  • 下载 — webshare proxies list --plan <id> > proxies.txt 会写入大多数工具都接受的标准 address:port:username:password 格式行。 webshare proxies download 则会获取服务器渲染的列表 （适用于 IP 身份验证设置的 --auth sourceip）。
  • 代理 URL — webshare proxy-url 可构建可直接使用的连接 URL： --country us --rotate 用于按请求轮换，--sessions 5 用于创建粘性会话工作池，--session <id> 用于固定一个会话。
  • 配置 — webshare config show / webshare config set（--username、 --password、--request-timeout、--idle-timeout）
  • IP 身份验证 — webshare ipauth list / webshare ipauth add --current（或指定 IP）/ webshare ipauth remove <id-or-ip>
  • 统计信息 — webshare stats --since 24h（或 --hourly）； webshare activity list --error '*' 可显示近期失败的请求
  • 刷新 — webshare proxies refresh 会替换整个列表； webshare proxies replaced 可显示过往替换记录及后续代理
  • 购买 — 在浏览器中打开快速结账 URL（见下文）

完整的标志参考和 JSON 输出说明请参阅 references/CLI.md。

购买代理（快速结账）

使用 scripts/express_checkout.py。该脚本会构建带有正确查询字符串的控制面板 URL，并在默认浏览器中打开。支持六种预设：

  • 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。

评论

支持 Markdown