proxy-scraper

<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/banner-dark.svg"> <source media="(prefers-color-scheme: light)" srcset="docs/banner-light.svg"> <img src="docs/banner-dark.svg" alt="proxy-scraper – free proxies that actually work" width="100%"> </picture>

<a href="https://maximilianfeix.github.io/proxy-scraper/"><img src="https://img.shields.io/badge/Browse_the_live_list-D4F77A?style=for-the-badge&labelColor=121113" alt="Browse the live list"></a> <a href="https://github.com/maximilianfeix/free-proxy-list"><img src="https://img.shields.io/badge/Just_the_lists-121113?style=for-the-badge" alt="Just the lists: free-proxy-list"></a> <a href="#install"><img src="https://img.shields.io/badge/Install-121113?style=for-the-badge" alt="Install"></a> <a href="#from-python"><img src="https://img.shields.io/badge/Python_API-121113?style=for-the-badge" alt="Python API"></a> <a href="#mcp"><img src="https://img.shields.io/badge/MCP_server-121113?style=for-the-badge" alt="MCP server for AI agents"></a> <a href="bot/"><img src="https://img.shields.io/badge/Discord_bot-121113?style=for-the-badge" alt="Discord bot"></a>

English · 简体中文 · Español

Install · Live list · For AI agents · Proxy server · How it works · Recipes · Options · FAQ

</div>

---

Most free proxy lists are 95 % dead, and a good part of the rest are honeypots or proxies that inject scripts into your pages. proxy-scraper collects public HTTP, SOCKS4 and SOCKS5 proxies from 700+ sources and keeps only the ones that pass every check. It learns with every run which sources are worth it, and it can turn the result into a single rotating proxy.

In numbers: in one day it checked 3.6 million free proxies – 1.1 % worked, and more than half of the ones that answered failed a second request. What's actually out there →

Used by: the hourly list is a built-in source of monosans/proxy-scraper-checker and gfpcom/free-proxy-list.

Try it – no install, about five seconds:

uvx proxy-scraper-cli --pick 5 --types socks5     # 5 checked proxies

# or just the plain list
curl -s https://maximilianfeix.github.io/proxy-scraper/socks5.txt | head

uvx comes with uv; pipx run proxy-scraper-cli --pick 5 does the same.

<div align="center"> <img src="docs/demo.svg" alt="Animated demo: the live dashboard during a check, the report, the setup wizard and collecting" width="880"> </div>

Who runs free proxies – and is it safe to use them? Mostly nobody on purpose: misconfigured servers with an open port, a few deliberately open ones, infected machines, and traps that log or rewrite your traffic. That's why every proxy here has to pass five checks, and why they're for public data and testing – never for logins, payments or anything personal. More on where they come from →

<details> <summary><b>Table of contents</b></summary>

• Install
• Live proxy list
• For AI agents (MCP)
• Features · Why not just download a list?
• Examples
• Recipes
• Rotating proxy server
• Discord and Telegram bot
• How it works
• Output
• Options
• GitHub Actions
• FAQ
• Roadmap · Contributing · Community · Acknowledgements

</details>

<a id="install"></a>

Install

With pipx (recommended – gives you a proxy-scraper command in its own environment):

pipx install proxy-scraper-cli
proxy-scraper

The package is called proxy-scraper-cli on PyPI (the plain name is taken), the command is proxy-scraper.

With Homebrew on macOS and Linux:

brew install maximilianfeix/tap/proxy-scraper

The formula follows each release within about a day.

<details> <summary><b>Other ways: Docker, pip, a faster event loop, or straight from the repo</b></summary> <br>

# Docker – learned state and results stay in two folders next to you
mkdir -p proxy-data results
docker run --rm --user "$(id -u):$(id -g)" -v "$PWD/proxy-data:/data" -v "$PWD/results:/work/results" \
  ghcr.io/maximilianfeix/proxy-scraper --want 50 --https-only

# pip into the current environment
pip install proxy-scraper-cli

# optional: faster event loop on macOS/Linux
pipx install "proxy-scraper-cli[fast]"

# the latest main instead of the latest release
pipx install git+https://github.com/maximilianfeix/proxy-scraper.git

# no install at all
git clone https://github.com/maximilianfeix/proxy-scraper.git
cd proxy-scraper
pip install -r requirements.txt
python3 proxy_scraper.py

Every release also ships a wheel you can install with pip install <file>.whl, and a multi-arch image (amd64/arm64) on ghcr.io. In the container the wizard never shows up, it runs straight away. For the proxy server use --serve --serve-host 0.0.0.0 with -p 127.0.0.1:8899:8899, so the port is only open on your own machine.

Tab completion for bash, zsh, fish and PowerShell:

eval "$(proxy-scraper --completion zsh)"     # in ~/.zshrc (after compinit), same for bash in ~/.bashrc
proxy-scraper --completion fish > ~/.config/fish/completions/proxy-scraper.fish
proxy-scraper --completion powershell | Out-String | Invoke-Expression   # in $PROFILE

Installed, the learned state lives in your user data folder (~/Library/Application Support/proxy-scraper, %LOCALAPPDATA%\proxy-scraper or ~/.local/share/proxy-scraper; override with PROXY_SCRAPER_HOME) and results go to ./results. Run from a clone, both stay inside the project. After the second run that finds proxies it asks once for a GitHub star; PROXY_SCRAPER_NO_STAR_HINT=1 turns that off (it never shows in CI).

</details>

Started without arguments, a wizard asks what you are looking for:

<div align="center"> <img src="docs/wizard.svg" alt="Setup wizard" width="760"> </div>

| Preset | What it does | |---|---| | Find everything | all protocols, maximum yield | | Browsing & web | HTTP + SOCKS5, HTTPS-capable, at least anonymous, under 3 s | | Maximum anonymity | elite SOCKS5 with HTTPS only | | Fast & stable | proxies under 1 s only | | A few right now | stops after 25 hits | | Recheck the last hits | no collecting, takes seconds | | Proxy server right away | recheck the last hits, then serve them on :8899 | | Same as last time | your previous choice | | Custom … | protocols, countries, anonymity, HTTPS, target site, latency, amount, check mode |

Keys: <kbd>↑</kbd><kbd>↓</kbd> select · <kbd>Space</kbd> toggle · <kbd>1</kbd>–<kbd>9</kbd> jump · <kbd>Enter</kbd> next · <kbd>Esc</kbd> back · <kbd>q</kbd> quit. In scripts and cron jobs the wizard never shows up – pass options or -y.

<a id="live-list"></a>

Live proxy list

Don't want to scan yourself? Every hour GitHub Actions runs the tool and publishes the hits to the proxy-list branch – every entry worked in the last run, best first: fast ones that are likely to still be up come on top.

Just want the lists? They also live in a repository of their own, maximilianfeix/free-proxy-list – one list per protocol, per country and per site, updated every hour, with the numbers of the last run on the front page. Watch or star it to keep it at hand. Other tools pull it too: monosans/proxy-scraper-checker and gfpcom/free-proxy-list use it as a built-in source.

<a href="https://maximilianfeix.github.io/proxy-scraper/"><picture> <source media="(prefers-color-scheme: dark)" srcset="https://maximilianfeix.github.io/proxy-scraper/chart-dark.svg"> <source media="(prefers-color-scheme: light)" srcset="https://maximilianfeix.github.io/proxy-scraper/chart-light.svg"> <img src="https://maximilianfeix.github.io/proxy-scraper/chart-dark.svg" alt="Working proxies over the last days, stacked by protocol – redrawn with every run" width="100%"> </picture></a>

→ Browse it on the website – search, filter by type, country, HTTPS, provider and latency, see how long each proxy has been up and how often it was on the list this week, copy or download exactly the proxies you need.

Every protocol and country also has its own page with a plain download, e.g. SOCKS5 or Germany (country/de/proxies.txt).

<div align="center"><a href="https://maximilianfeix.github.io/proxy-scraper/"><img src="docs/website.png" alt="The live list website" width="860"></a></div> <div align="center">

</div>

| List | Format | Link | |---|---|---| | All | socks5://1.2.3.4:1080 | [all.txt](https://raw.githubusercontent.com/maximilianfeix/proxy