Package Health Score

72 / 100

security
Security review needed
popularity
Recognized
maintenance
Healthy
community
Sustainable

Popularity

Recognized

GitHub Stars: 261
Forks: 53
Contributors: 20

Direct Usage Popularity

Based on project statistics from the GitHub repository for the PyPI package free-proxy, we found that it has been starred 261 times.

Security

Security review needed

Security and license risk for latest version

Release Date: Nov 7, 2024
Direct Vulnerabilities: 0
C
0
H
0
M
0
L
Indirect Vulnerabilities: 0
C
0
H
0
M
0
L
License Risk: 0
H
1
M
0
L

All security vulnerabilities belong to production dependencies of direct and indirect packages.

License

MIT

Security Policy

We found a way for you to contribute to the project! Looks like free-proxy is missing a security policy.

You can connect your project's repository to Snyk to stay up to date on security alerts and receive automatic fix pull requests.

Keep your project free of vulnerabilities with Snyk

Maintenance

Healthy

Commit Frequency

Open Issues: 8
Open PR: 3
Last Release: 1 month ago
Last Commit: 1 month ago

Further analysis of the maintenance status of free-proxy based on released PyPI versions cadence, the repository activity, and other data points determined that its maintenance is Healthy.

We found that free-proxy demonstrates a positive version release cadence with at least one new version released in the past 3 months.

As a healthy sign for on-going project maintenance, we found that the GitHub repository had at least 1 pull request or issue interacted with by the community.

Community

Sustainable

Readme: Yes
Contributing.md: No
Code of Conduct: No
Contributors: 20
Funding: No

With more than 10 contributors for the free-proxy repository, this is possibly a sign for a growing and inviting community.

We found a way for you to contribute to the project! Looks like free-proxy is missing a Code of Conduct.

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Python Versions Compatibility: >=3.6

Age: 6 years
Latest Release: 1 month ago
Dependencies: N/A
Versions: 11
Maintainers: 1
Wheels: No

Readme

Free-proxy

Get free working proxies from , , and and use them in your script

The FreeProxy class scrapes proxies from , , , and and checks to make sure that it works. You can filter proxies by country, and specify an acceptable timeout. You can also randomize the list of proxies, rather than going in the order that they are scraped in.

You can use this to send requests through a custom proxy, with Selenium, or with anything else.

Returns proxy as string:

'http://113.160.218.14:8888'

Requirements

Installation

pip install free-proxy

Usage examples

First import Free Proxy that way:

from fp.fp import FreeProxy

Options

Parameter	Type	Example	Default value
country_id	list	['US', 'BR']	None
timeout	float > 0	0.1	0.5
rand	bool	True	False
anonym	bool	True	False
elite	bool	True	False
google	bool,None	False	None
https	bool	True	False
url	str	''	google.com

No parameters Get the first working proxy from . If no proxies are working, try again pulling from

proxy = FreeProxy().get()

country_id parameter Get the first working proxy from a specified list of countries (from ). If no proxies are working check all countries pulling from .

proxy = FreeProxy(country_id=['US', 'BR']).get()

country_id for US and GB You can set the country_id to US or GB to get a proxy from the United States or the United Kingdom respectively. Proxies will be scrapped from (US) or (GB). If there are no working proxies in the specified list check all countries

proxy = FreeProxy(country_id=['US']).get()
proxy = FreeProxy(country_id=['GB']).get()

timeout parameter Timeout is the parameter for checking if a proxy is valid. If the server does not respond in specified time, the script will mark the proxy as invalid. Default timeout=0.5. You can change it by specifying a timeout eg. timeout=1.

proxy = FreeProxy(timeout=1).get()

rand parameter Shuffles the order of the proxy list from instead of going from newest to oldest (as listed on the website). Defaults to rand=False

proxy = FreeProxy(rand=True).get()

anonym parameter Return only proxies marked as anonymous. Defaults to anonym=False

proxy = FreeProxy(anonym=True).get()

elite parameter Return only proxies marked as 'elite proxy'. Defaults to elite=False.

proxy = FreeProxy(elite=True).get()

Please note: elite proxies are always anonymous. If you set elite=True, you will also be eliminating any non-anonymous proxies.

google parameter If True it will only return proxies marked as "google". If False, it will not return proxies marked as "google". Defaults to google=None, which returns all proxies.

proxy = FreeProxy(google=True).get()

https parameter If True it will only return proxies marked as HTTPS. Defaults to https=False - i.e. HTTP proxy (for HTTP websites).

Please note: HTTPS proxies work for both HTTP and HTTPS websites.

proxy = FreeProxy(https=True).get()

You can combine parameters:

proxy = FreeProxy(country_id=['US', 'BR'], timeout=0.3, rand=True).get()

If there are no working proxies with the provided parameters, the script will raise FreeProxyException with the message There are no working proxies at this time..

url parameter The url parameter allows you to set a custom URL for testing purposes. If left empty, it defaults to 'https://www.google.com'.

Using default URL:

proxy = FreeProxy().get()

Using custom URL, if test on different endpoint is needed:

proxy = FreeProxy(url='http://httpbin.org/get').get()

CHANGELOG

[1.1.3] - 2024-11-07

Added url paramameter

[1.1.2] - 2024-09-07

Updated lxml to version 5.3.0
Updated pip-chill to version 1.0.3
Updated requests to version 2.32.3

[1.1.1] - 2023-02-18

Fixed https parameter error
Fixed additional loop issue when no proxy was found

[1.1.0] - 2022-11-12

Added new website to get proxies from
Added new website to get proxies from
Added new website to get proxies from
Change lxml version to 4.9.1

[1.0.6] - 2022-01-23

Added google parameter
Added https parameter

[1.0.5] - 2022-01-07

Added elite parameter
Add exception class and raise exception instead of system exit
Change lxml version to 4.6.5

[1.0.4] - 2021-11-13

Fix proxy list default length

[1.0.3] - 2021-08-18

Change XPatch due to SSL proxies page update
Change lxml version

[1.0.2] - 2020-09-03

Added anonym parameter

[1.0.1] - 2020-03-19

Fix typos in readme
Fix urrlib3 exception urllib3.exceptions.ProxySchemeUnknown: Not supported proxy scheme None,
Fix imports

[1.0.0] - 2019-02-04

Initial release

Disclaimer

The authors of this repository are not responsible for any consequences, damages or losses arising from the use or misuse of this repository or content. Users are solely responsible for their actions and any consequences that may follow.

License

MIT

Free Software!

FAQs

What is free-proxy?

Proxy scraper for further use. Visit Snyk Advisor to see a full health score report for free-proxy, including popularity, security, maintenance & community analysis.

Is free-proxy popular?

The python package free-proxy receives a total of 15,439 weekly downloads. As such, free-proxy popularity was classified as a recognized. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is free-proxy well maintained?

We found that free-proxy demonstrated a healthy version release cadence and project activity. It has a community of 20 open source contributors collaborating on the project. See the full package health analysis to learn more about the package maintenance status.

Is free-proxy safe to use?

While scanning the latest version of free-proxy, we found that a security review is needed. A total of 0 vulnerabilities or license issues were detected. See the full security scan results.

Last updated on 22 December-2024, at 02:01 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP

Package Health Score

Direct Usage Popularity

Security and license risk for latest version

Commit Frequency

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Snyk Vulnerability Scanner

Readme

Free-proxy

Get free working proxies from , , and and use them in your script

Requirements

Installation

Usage examples

Options

CHANGELOG

[1.1.3] - 2024-11-07

[1.1.2] - 2024-09-07

[1.1.1] - 2023-02-18

[1.1.0] - 2022-11-12

[1.0.6] - 2022-01-23

[1.0.5] - 2022-01-07

[1.0.4] - 2021-11-13

[1.0.3] - 2021-08-18

[1.0.2] - 2020-09-03

[1.0.1] - 2020-03-19

[1.0.0] - 2019-02-04

Disclaimer

License

FAQs

What is free-proxy?

Is free-proxy popular?

Is free-proxy well maintained?

Is free-proxy safe to use?

Build a secure application checklist

Select a recommended open source package

Scan your app for vulnerabilities

Source Code

Open Source

Container

Config

Fix identified vulnerabilities

Monitor for new issues