Skip to content

mark-hoffmann/carmen

Repository files navigation

Carmen

alternate text

Latest PyPI version Latest Travis CI build status Coverage

Carmen is a tool for proxying programmatic HTTP requests. It finds a list of free proxy servers and routes your request traffic randomly, making everyone ask the question "Where in the world [is Carmen SanDiego] are my network requests coming from?"

This can be useful for webcrawlers where sites block bots after only a few requests.

**Disclaimer: Please use responsibily. Writing a large scale scraper can have detrimental effects on a websites performance and can cost a company a lot of money. DO NOT use this maliciously. Remember, with great power comes great responsibility. **

Installation

Carmen can easily be downloaded via PyPI with the following:

pip install carmenproxy

Usage

This package connects to 'https://www.sslproxies.org/' and finds free available proxies to then cycle through, discarding those that do not initially work.

To use Carmen, simply instantiate the ProxyRotator object, get the available proxies and pass your url into the make_request method. You are then returned a Response object.

from carmen import ProxyRotator

 pr = ProxyRotator()
 pr.get_proxies()

 r = pr.make_request('http://url.com')

 r.read()

Requirements

Compatibility

carmenproxy currently supports Python 3.6

Licence

MIT

Authors

carmenproxy was written by Mark Hoffmann.

About

Tool for proxying programmatic HTTP requests

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages