--- id: free-proxy version: "1.2.2" license: unclear license_treatment: permissive maintenance: active --- # free-proxy — Proxy scraper for further use License: permissive · Maintenance: active · Downloads: 479.4K/mo ## What it is and what it does Free-proxy is a web scraper that fetches free proxy addresses from public proxy list websites and validates them by testing connectivity. It returns a single working proxy as a string that you can pass to requests, Selenium, or other HTTP clients. The package scrapes from multiple sources, falling back to alternate sources if the primary list fails. You can filter proxies by country, anonymity level, protocol, and Google compatibility. You can also randomize the order, set validation timeouts, and specify a custom test URL. If no working proxies match your criteria, it raises FreeProxyException. The package depends on lxml for HTML parsing and requests for HTTP operations. Use it for: - Scrape websites that block or rate-limit direct requests by rotating through free proxies. - Test web applications or APIs from different geographic regions using country-filtered proxies. - Automate data collection tasks that require IP rotation to avoid detection or bans. - Route Selenium browser automation through proxies to mask the origin of automated tests. - Validate proxy availability and response times before using them in production scripts. ## Worth the install? AI-flagged interpretation of the facts above — verify before relying. Scrapes working free proxies from public proxy lists and returns them as strings for use in HTTP requests, with filtering by country, anonymity level, and protocol support. Yes, if you need free proxies for legitimate automation or testing. The package is actively maintained, has low install friction, and no known vulnerabilities. However, free proxies are inherently unreliable; consider whether a paid proxy service better fits your use case. Verify that your intended use complies with the terms of service of both the proxy sources and the websites you access through them. ## Install pip install free-proxy uv add free-proxy poetry add free-proxy ## Installing free-proxy Before you install: Low friction install with only two runtime dependencies (lxml and requests). Actively maintained with recent fixes; last release 40 days ago and last commit 2026-07-08. Minimum Python 3.8 required. License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely in commercial or private projects with minimal restrictions. Quickstart: pip install free-proxy from fp.fp import FreeProxy proxy = FreeProxy().get() print(proxy) Requires Python 3.8 or later. Depends on lxml and requests to parse and validate proxies. Verify before relying: - Reliability and uptime of the scraped proxy sources over time. - How often proxies become stale or non-functional after retrieval. - Whether the package handles rate-limiting or IP blocking from proxy source websites. - Actual success rate when filtering by country_id, anonym, elite, or https parameters. ## Package facts - License: not declared (permissive) - Python support: supports_current - Install friction: low - Maintenance: active - Downloads: 479.4K/month (top 15,000 on PyPI) - Known vulnerabilities: none known ## Tags free proxy scraper, get working proxies, proxy list fetcher, http proxy resolver, anonymous proxy finder, web-scraping, proxy-rotation, http-client [View on SkillFed](https://skillfed.io/packages/free-proxy) · [View on PyPI](https://pypi.org/project/free-proxy/)