| name | proxy-manager |
| version | 2.0 |
| description | Manage Webshare proxies with the webshare CLI: list active proxies, dump the proxy list to a file, refresh rotating pools, read and update proxy config, manage IP allowlists, build proxy URLs, inspect subscription plans and usage, and kick off an express-checkout flow to buy more proxies. Use when the user wants to work with webshare.io proxies — not scraping, just provisioning and ops.
|
| license | MIT |
| allowed-tools | Read, Write, Edit, Bash(webshare *), Bash(python *), Bash(python3 *), Bash(open *), Bash(xdg-open *) |
| argument-hint | [action] |
| metadata | {"category":"proxy-management","long-description":"Day-to-day Webshare account operations from your agent, built on the official webshare CLI. Identify the right plan, list or download proxies in the format your tools expect, build ready-to-use proxy URLs with country targeting and sticky sessions, manage the IP allowlist for credential-less use, watch usage and failures, refresh a burned pool, and open a pre-filled express-checkout page when you need more capacity.\n","tags":["proxies","provisioning","plans","ip-auth","proxy-urls","cli"],"install":"npx skills add webshare-proxy/skills --skill proxy-manager","example-prompts":["List my Webshare proxies and save them to proxies.txt","Authorize this machine's IP so my tools can use proxies without credentials","Give me five sticky-session US proxy URLs for a worker pool","What failed in my proxy traffic over the last hour?","Refresh my proxy list — too many IPs are getting blocked","Buy 100 more dedicated datacenter proxies"],"related":["proxy-optimizer","spend-audit","scraper"]} |
Webshare Proxy Manager
You help the user manage their Webshare proxy account through the webshare
CLI: list proxies, refresh the pool, configure auth, build proxy URLs, watch
usage, and purchase more capacity via the express-checkout flow.
What this skill does / needs / will not do
Does: everything in the workflow below, through webshare CLI commands.
Needs:
- The
webshare CLI — install with brew install webshare-proxy/tap/webshare,
or download a binary from
https://github.com/webshare-proxy/webshare-cli/releases.
- A Webshare account — sign up at https://www.webshare.io/ (10 free
proxies, no card required).
- An API key from https://dashboard.webshare.io/userapi/keys, exported as
WEBSHARE_API_KEY. Verify with webshare whoami.
Will not do:
- Targeted replacement of individual proxies — the CLI has no
per-proxy replacement command.
webshare proxies refresh replaces the
entire list; for replacing specific blocked IPs point the user at the
sibling proxy-optimizer skill or the dashboard.
- Headless purchases — checkout always finishes in the browser; the
express-checkout script only pre-fills the page.
- Scraping. That's the
scraper skill.
Workflow
Step 1: Identify the target plan
Webshare accounts can own multiple plans simultaneously. Before any action
that touches proxies, config, or IP allowlists, run:
webshare plans list
If there is more than one active plan, show the list (id, type, proxy count,
status) and ask which plan to operate on (use AskUserQuestion), then pass
--plan <id> on every subsequent command. If there is exactly one plan you
can skip asking — but still pass --plan explicitly so the intent is obvious
in the command history. webshare plans show <plan-id> gives full detail.
Step 2: Run the action
Ask which action the user wants (use AskUserQuestion if unclear):
- plans —
webshare plans list / webshare plans show <plan-id>
