proxycheck

Fast proxy checker for the command line. Test HTTP, HTTPS, SOCKS4, and SOCKS5 proxies for liveness, latency, anonymity, and datacenter-vs-residential type. No signup, no ads, no sketchy binary.

Powered by proxychecker.dev.

npx proxychecker-dev proxies.txt

  ALIVE  45.12.30.9:8080     http    datacenter   142ms  US  Cloudflare
  ALIVE  98.162.25.7:31654   socks5  residential  380ms  DE  Deutsche Telekom
  DEAD   9.9.9.9:3128        http    -            -      -   timeout

  2 alive · 1 dead · avg 261ms · 1 dc · 1 res

Why

If you buy proxies for scraping, half the list is usually dead, slow, or a datacenter IP being sold as "residential." Checking them by hand or hacking together a curl loop is a waste of a morning. This does it in one command, tells you which are actually alive, how fast, and what type they really are.

Install

Run it with no install:

npx proxychecker-dev proxies.txt

Or install globally for the short proxycheck command:

npm install -g proxychecker-dev
proxycheck proxies.txt

Requires Node.js 18+.

Usage

# from a file (one proxy per line, # comments ignored)
proxycheck proxies.txt

# inline
proxycheck 1.2.3.4:8080 socks5://5.6.7.8:1080

# from stdin
cat proxies.txt | proxycheck

# only the live ones, as JSON, piped to jq
proxycheck proxies.txt --alive --json | jq -r '.results[].input'

# export a CSV
proxycheck proxies.txt --csv > results.csv

Accepted formats

One per line. Lines starting with # are ignored.

ip:port
ip:port:user:pass
user:pass@ip:port
socks5://ip:port

Protocols: http, https, socks4, socks5.

Options

| Flag | Description | |------|-------------| | -k, --key <pck_...> | API key for 5,000 proxies/call + auto-chunking (or set PROXYCHECK_KEY) | | -t, --timeout <ms> | Per-proxy timeout, 3000-30000 (default 10000) | | -a, --alive | Only output proxies that are alive | | --json | Output raw JSON (pipe to jq) | | --csv | Output CSV | | --fail-if-none | Exit non-zero if zero proxies are alive (useful in CI) | | -h, --help | Show help | | -v, --version | Show version |

Free vs. keyed

The free tier checks 50 proxies per call with no key and no signup. That covers casual use forever.

Got a big list? A key unlocks 5,000 proxies per call, and the CLI automatically splits larger jobs into chunks and merges the results, so proxycheck huge-list.txt --key pck_... just works.

Keys are a one-time $5 (5,000 proxies) or $15/mo for ongoing bulk + API access: proxychecker.dev/pricing. Set it once:

export PROXYCHECK_KEY=pck_live_xxxxx
proxycheck huge-list.txt

What you get per proxy

• status — alive or dead
• protocol — http / https / socks4 / socks5
• type — datacenter, residential, or mobile
• latency — round-trip in ms
• country / city / ISP / ASN — geo + network
• suspected_fake_residential — flags datacenter IPs being sold as residential

API

The CLI is a thin wrapper over the proxychecker.dev API. POST a JSON array of proxies to /api/check with Authorization: Bearer pck_... and get JSON or CSV back. Use whichever you like.

License

MIT © Flash AI Solutions