Skip to content

iFan6oy/proxychecker-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Fast zero-dependency CLI for proxychecker.dev. Check HTTP/SOCKS proxies for liveness, latency, anonymity, and datacenter-vs-residential type. No signup.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors