proxy-checker

CLI tool to check HTTP/HTTPS/SOCKS5 proxies — liveness, latency, exit IP, speed, geo enrichment, rotation detection, and DNSBL blacklist checks.

Install

pip install proxycheck-cli

Requires Python 3.11+.

Quick start

# Check proxies from file
proxycheck check proxies.txt

# Single proxy
proxycheck check http://user:pass@localhost:8888

# With geo, speed & blacklist
proxycheck check proxies.txt --geo --speed --blacklist

# Export results
proxycheck check proxies.txt -o results.json -f json

Options

Metrics per proxy

• Status — alive / dead
• Latency — response time in ms
• Exit IP — detected exit IP address
• Country / City / ASN — via ip-api.com (when --geo)
• Proxy type — residential, datacenter, mobile (when --geo)
• Speed — download speed in Mbps (when --speed)
• Blacklisted — status per DNSBL provider (when --blacklist)
• Matches — ✓ if exit IP matches expected country/type, ✗ if mismatch

Input formats

One proxy per line. Comments (#) and blank lines are ignored.

host:port
user:pass@host:port
http://host:port
http://user:pass@host:port
https://host:port
socks5://host:port

Privacy

Passwords are masked (user:***@host:port) in all output — table, CSV, and JSON.

DNSBL providers

• zen.spamhaus.org
• bl.blocklist.de
• dnsbl.dronebl.org

Contributing

PRs welcome. Run tests before submitting:

pip install -e ".[dev]"
ruff check
ruff format --check
python -m pytest

License

MIT