<a name="readme-top"></a>
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
[![LinkedIn][linkedin-shield]][linkedin-url]
<!-- PROJECT LOGO -->
<br />
<div align="center">
<a href="https://github.com/Hex2424/ProxyRipper">
<img src="./images/logo.png" alt="Logo" width="400" height="400">
</a>
<h3 align="center">ProxyRipper</h3>
<p align="center">
A Open-source tool for searching various websites for proxies and doing realtime validation - so THEY WILL REALLY WORK
<br />
<!-- <br>
<a href="https://github.com/Hex2424/ProxyRipper">View Demo</a>
· -->
<a href="https://github.com/Hex2424/ProxyRipper/issues">Report Bug</a>
·
<a href="https://github.com/Hex2424/ProxyRipper/issues">Request Feature</a>
</p>
</div>
<!-- TABLE OF CONTENTS -->
<details>
<summary>Table of Contents</summary>
<ol>
<li>
<a href="#about-the-project">About The Project</a>
<ul>
<li><a href="#built-with">Built With</a></li>
</ul>
</li>
<li>
<a href="#getting-started">Getting Started</a>
<ul>
<li><a href="#prerequisites">Prerequisites</a></li>
<li><a href="#installation">Installation</a></li>
</ul>
</li>
<li><a href="#usage">Usage</a></li>
<li><a href="#roadmap">Roadmap</a></li>
<li><a href="#contributing">Contributing</a></li>
<li><a href="#license">License</a></li>
<li><a href="#contact">Contact</a></li>
<li><a href="#acknowledgments">Acknowledgments</a></li>
</ol>
</details>
<!-- ABOUT THE PROJECT -->
## About The Project
Proxies, is a safe and pretty fast way to hide your IP online, but finding one online sounds easier than it really is, online websites are overfilled with proxies IPs but actually working ones at that moment is existing only a few, so I decided create a tool for ripping all these websites and finding **REALLY VALID PROXIES**
<p align="right">(<a href="#readme-top">back to top</a>)</p>
### Built With:
* 
* 
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- GETTING STARTED -->
## Getting Started
Project is uploaded to PYPI, so you can install it pretty easily using pip tool.
### Installation
1. Install package using pip command
```sh
pip install ProxyRipper
```
2. Congrats, thats all, package is installed
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- USAGE EXAMPLES -->
## Usage
To use this tool with default settings simply type this in your terminal:
```sh
ProxyRipper
```
<br>**Additional arguments:**
<br>Displaying all possible parameters:
```sh
ProxyRipper --help
```
Changing proxy check timeout:
```sh
ProxyRipper --timeout <TIMEOUT>
```
Changing proxy retries until proxy considered died:
```sh
ProxyRipper --attempts <ATTEMPTS>
```
Changing tool threads count used for proxy checking:
```sh
ProxyRipper --threads <THREAD_COUNT>
```
By default tool caches last session working proxies, and firstly checking them, then searching internet for new ones, you can disable this by including this parameter:
```sh
ProxyRipper --disable-cache
```
Tool uses python requests module for checking if proxy do a job properly, by default it tries reach https://myip.com, you can change default checking url by this option.
```sh
ProxyRipper --check-url https://www.example.com
```
Getting version of this tool
```sh
ProxyRipper --version
```
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- ROADMAP -->
## Roadmap
- [ ] Adding more API endpoints for ripping
- [ ] Adding feature to generate PROXY addresses itself
- [ ] Auto proxy revalidation
See the [open issues](https://github.com/Hex2424/ProxyRipper/issues) for a full list of proposed features (and known issues).
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- CONTRIBUTING -->
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
Project has flexible python API object inheritence from parent API scrapping object, need more API Endpoints for scrapping in "api" folder, template is ProxyEngine.py file, which is template reference for other classes.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- LICENSE -->
## License
Distributed under the MIT License. See `LICENSE.txt` for more information.
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- CONTACT -->
## Contact
* Markas Vielavičius - markas.vielavicius@gmail.com
* Discord - Hex24#8712
Project Link: [https://github.com/Hex2424/ProxyRipper](https://github.com/Hex2424/ProxyRipper)
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- ACKNOWLEDGMENTS -->
## Acknowledgments
* [https://stackoverflow.com/](https://stackoverflow.com/)
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- MARKDOWN LINKS & IMAGES -->
<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
[contributors-shield]: https://img.shields.io/github/contributors/Hex2424/ProxyRipper.svg?style=for-the-badge
[contributors-url]: https://github.com/Hex2424/ProxyRipper/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/Hex2424/ProxyRipper.svg?style=for-the-badge
[forks-url]: https://github.com/Hex2424/ProxyRipper/network/members
[stars-shield]: https://img.shields.io/github/stars/Hex2424/ProxyRipper.svg?style=for-the-badge
[stars-url]: https://github.com/Hex2424/ProxyRipper/stargazers
[issues-shield]: https://img.shields.io/github/issues/Hex2424/ProxyRipper.svg?style=for-the-badge
[issues-url]: https://github.com/Hex2424/ProxyRipper/issues
[license-shield]: https://img.shields.io/github/license/Hex2424/ProxyRipper.svg?style=for-the-badge
[license-url]: https://github.com/Hex2424/ProxyRipper/blob/master/LICENSE.txt
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
[linkedin-url]: https://linkedin.com/in/markas-vielavičius-503827254
[product-screenshot]: images/screenshot.png
Raw data
{
"_id": null,
"home_page": "",
"name": "ProxyRipper",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python,proxy,scrapper,ripper,api,proxies",
"author": "Hex24 (Markas Vielavi\u010dius)",
"author_email": "<markas.vielavicius@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/4f/f0/54d5419de86bd0fdd17f2ff9a4c4b3bce027edb11d9e449601270654f117/ProxyRipper-1.1.4.tar.gz",
"platform": null,
"description": "\n\n<a name=\"readme-top\"></a>\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n[![LinkedIn][linkedin-shield]][linkedin-url]\n\n\n\n<!-- PROJECT LOGO -->\n<br />\n<div align=\"center\">\n <a href=\"https://github.com/Hex2424/ProxyRipper\">\n <img src=\"./images/logo.png\" alt=\"Logo\" width=\"400\" height=\"400\">\n </a>\n\n<h3 align=\"center\">ProxyRipper</h3>\n\n <p align=\"center\">\n A Open-source tool for searching various websites for proxies and doing realtime validation - so THEY WILL REALLY WORK\n <br />\n <!-- <br>\n <a href=\"https://github.com/Hex2424/ProxyRipper\">View Demo</a>\n \u00b7 -->\n <a href=\"https://github.com/Hex2424/ProxyRipper/issues\">Report Bug</a>\n \u00b7\n <a href=\"https://github.com/Hex2424/ProxyRipper/issues\">Request Feature</a>\n </p>\n</div>\n\n\n\n<!-- TABLE OF CONTENTS -->\n<details>\n <summary>Table of Contents</summary>\n <ol>\n <li>\n <a href=\"#about-the-project\">About The Project</a>\n <ul>\n <li><a href=\"#built-with\">Built With</a></li>\n </ul>\n </li>\n <li>\n <a href=\"#getting-started\">Getting Started</a>\n <ul>\n <li><a href=\"#prerequisites\">Prerequisites</a></li>\n <li><a href=\"#installation\">Installation</a></li>\n </ul>\n </li>\n <li><a href=\"#usage\">Usage</a></li>\n <li><a href=\"#roadmap\">Roadmap</a></li>\n <li><a href=\"#contributing\">Contributing</a></li>\n <li><a href=\"#license\">License</a></li>\n <li><a href=\"#contact\">Contact</a></li>\n <li><a href=\"#acknowledgments\">Acknowledgments</a></li>\n </ol>\n</details>\n\n\n\n<!-- ABOUT THE PROJECT -->\n## About The Project\n\n\n\nProxies, is a safe and pretty fast way to hide your IP online, but finding one online sounds easier than it really is, online websites are overfilled with proxies IPs but actually working ones at that moment is existing only a few, so I decided create a tool for ripping all these websites and finding **REALLY VALID PROXIES**\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n\n### Built With:\n\n* \n* \n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n\n<!-- GETTING STARTED -->\n## Getting Started\n\nProject is uploaded to PYPI, so you can install it pretty easily using pip tool.\n\n### Installation\n\n1. Install package using pip command\n ```sh\n pip install ProxyRipper\n ```\n2. Congrats, thats all, package is installed\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n<!-- USAGE EXAMPLES -->\n## Usage\n\nTo use this tool with default settings simply type this in your terminal:\n```sh\nProxyRipper\n```\n<br>**Additional arguments:**\n<br>Displaying all possible parameters:\n```sh\nProxyRipper --help\n```\nChanging proxy check timeout:\n```sh\nProxyRipper --timeout <TIMEOUT>\n```\nChanging proxy retries until proxy considered died:\n```sh\nProxyRipper --attempts <ATTEMPTS>\n```\nChanging tool threads count used for proxy checking:\n```sh\nProxyRipper --threads <THREAD_COUNT>\n```\nBy default tool caches last session working proxies, and firstly checking them, then searching internet for new ones, you can disable this by including this parameter:\n```sh\nProxyRipper --disable-cache\n```\nTool uses python requests module for checking if proxy do a job properly, by default it tries reach https://myip.com, you can change default checking url by this option.\n```sh\nProxyRipper --check-url https://www.example.com\n```\nGetting version of this tool\n```sh\nProxyRipper --version\n```\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n\n<!-- ROADMAP -->\n## Roadmap\n\n- [ ] Adding more API endpoints for ripping\n- [ ] Adding feature to generate PROXY addresses itself\n- [ ] Auto proxy revalidation\n\nSee the [open issues](https://github.com/Hex2424/ProxyRipper/issues) for a full list of proposed features (and known issues).\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n\n<!-- CONTRIBUTING -->\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\nProject has flexible python API object inheritence from parent API scrapping object, need more API Endpoints for scrapping in \"api\" folder, template is ProxyEngine.py file, which is template reference for other classes.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n\n<!-- LICENSE -->\n## License\n\nDistributed under the MIT License. See `LICENSE.txt` for more information.\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n\n<!-- CONTACT -->\n## Contact\n\n* Markas Vielavi\u010dius - markas.vielavicius@gmail.com\n* Discord - Hex24#8712\n\nProject Link: [https://github.com/Hex2424/ProxyRipper](https://github.com/Hex2424/ProxyRipper)\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n\n<!-- ACKNOWLEDGMENTS -->\n## Acknowledgments\n\n* [https://stackoverflow.com/](https://stackoverflow.com/)\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n\n\n<!-- MARKDOWN LINKS & IMAGES -->\n<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->\n[contributors-shield]: https://img.shields.io/github/contributors/Hex2424/ProxyRipper.svg?style=for-the-badge\n[contributors-url]: https://github.com/Hex2424/ProxyRipper/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/Hex2424/ProxyRipper.svg?style=for-the-badge\n[forks-url]: https://github.com/Hex2424/ProxyRipper/network/members\n[stars-shield]: https://img.shields.io/github/stars/Hex2424/ProxyRipper.svg?style=for-the-badge\n[stars-url]: https://github.com/Hex2424/ProxyRipper/stargazers\n[issues-shield]: https://img.shields.io/github/issues/Hex2424/ProxyRipper.svg?style=for-the-badge\n[issues-url]: https://github.com/Hex2424/ProxyRipper/issues\n[license-shield]: https://img.shields.io/github/license/Hex2424/ProxyRipper.svg?style=for-the-badge\n[license-url]: https://github.com/Hex2424/ProxyRipper/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555\n[linkedin-url]: https://linkedin.com/in/markas-vielavi\u010dius-503827254\n[product-screenshot]: images/screenshot.png\n",
"bugtrack_url": null,
"license": "",
"summary": "Tool for scrapping valid proxies",
"version": "1.1.4",
"split_keywords": [
"python",
"proxy",
"scrapper",
"ripper",
"api",
"proxies"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4ff054d5419de86bd0fdd17f2ff9a4c4b3bce027edb11d9e449601270654f117",
"md5": "21bca9d6ce20e47f41808007e1169b15",
"sha256": "170171d63503aab3a36594ff735e835ba6be2fdf37c72d01ec60759bdfc5afb9"
},
"downloads": -1,
"filename": "ProxyRipper-1.1.4.tar.gz",
"has_sig": false,
"md5_digest": "21bca9d6ce20e47f41808007e1169b15",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14116,
"upload_time": "2023-02-03T21:07:38",
"upload_time_iso_8601": "2023-02-03T21:07:38.830318Z",
"url": "https://files.pythonhosted.org/packages/4f/f0/54d5419de86bd0fdd17f2ff9a4c4b3bce027edb11d9e449601270654f117/ProxyRipper-1.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-03 21:07:38",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "proxyripper"
}
JSON