proxy-optimizer

name	proxy-optimizer
version	2.0
description	Optimize your Webshare proxy pool for a specific target website. Tests all proxies against the target, identifies blocked IPs by country/ASN/subnet using data from the webshare CLI, and replaces them via the Webshare MCP. Use when proxies are failing on a site, when setting up a new scraping target, or when you want to tune your proxy pool. Invoke with a target URL as argument.
license	MIT
allowed-tools	Read, Write, Bash(webshare *), Bash(python *), Bash(python3 *)
argument-hint	[target-url]
metadata	{"category":"proxy-management","long-description":"A target-site tuner for your Webshare proxy pool. It probes every proxy in a plan against the site you care about, maps the failures to countries, ASNs and /24 subnets to expose patterns (\"this ASN is 100% blocked here\"), and then walks you through replacing exactly the blocked IPs — dry-run first, explicit confirmation, and a re-test to prove the fix. Plan and proxy data come from the webshare CLI; the targeted replacement itself runs through the Webshare MCP, since per-IP replacement is not in the CLI yet.\n","tags":["proxies","blocking","replacement","asn","scraping-targets"],"install":"npx skills add webshare-proxy/skills --skill proxy-optimizer","example-prompts":["My proxies keep failing on example.com — figure out which ones and fix it","Optimize my proxy pool for https://www.example.com","Which of my proxies are blocked on this site, grouped by ASN?"],"related":["proxy-manager","scraper"]}

Target Site Proxy Optimizer

Optimize a Webshare proxy pool for a specific target website by testing, analyzing, and replacing blocked proxies.

Invocation

/proxy-optimizer https://www.example.com

The argument is the target URL to optimize proxies for.

What this skill does / needs / will not do

Does: probes every proxy against the target, ranks failures by country/ASN/subnet, and drives a confirmed, dry-run-first replacement of the blocked IPs.

Needs:

1. The webshare CLI (brew install webshare-proxy/tap/webshare) with WEBSHARE_API_KEY exported — the script pulls plans and proxies through it. Verify with webshare whoami.
2. Python 3.10+.
3. For the replacement step only: the Webshare MCP server connected (claude mcp add --transport http webshare https://mcp.webshare.io/ -H "Authorization: Token $WEBSHARE_API_KEY") and an active paid plan with replacement credits. Targeted per-IP replacement is not in the CLI yet, so the MCP's create_proxy_replacement is used for exactly this step.

Will not do:

• Replace proxies without a dry run and your explicit confirmation.
• Whole-pool refreshes — that is webshare proxies refresh territory (see the proxy-manager skill) and consumes an on-demand refresh.
• Test residential rotating pools per-IP (they have no fixed per-proxy address).

Workflow

Step 1: Check proxy count and ask about sampling

Find the plan and its size:

webshare plans list --json

If the plan has more than 50 proxies, ask the user:

"Your plan has N proxies. Test all of them or a sample?"

Options:

• All N proxies (takes longer)
• Sample of 20 (quick check)
• Sample of 50

If 50 or fewer, skip this question and test all.

Step 2: Run the optimizer script

Run the script from this skill's directory:

python3 scripts/optimize_proxies.py --target <TARGET_URL> --workers 10 --timeout 15

If the user chose a sample, add --sample N. To pin a plan, add --plan-id <id>. The script pulls the plan and proxy list via the CLI, outputs progress to stderr and structured JSON to stdout. Parse the JSON output.