proXXy is a powerful tool designed for acquiring and managing a vast quantity of proxies. It is used to gather, organize, and procure HTTP/S, SOCKS4, and SOCKS5 proxies. They can be used for web scraping, penetration testing, bypassing censorship, and many other tasks!
The software is currently capable of retrieving over 500,000 proxies from many different sources.
This project is for educational purposes only— Please do not use this for illegal activities.
- Clone the repository:
git clone https://github.com/Atropa-Solanaceae/proXXy.git
- Navigate to project directory:
cd proXXy
- Install dependencies with
poetry
:
poetry install
If you don't have poetry
installed, install it here.
- Activate the poetry shell:
poetry shell
- Running the program without flags results in only scraping, as checking is disabled by default:
python3 proXXy.py
The program will modify four files in the output/
directory with your proxies:
HTTP.txt
HTTPS.txt
SOCKS4.txt
SOCKS5.txt
with a logfile (error.log
) with warnings/errors.
Syntax for running proXXy is as follows:
usage: proXXy.py [-h] [--validate] [--update] [--version] [--src_check]
-
-V, --validate
: This flag enables proxy validation. The scraper will look to validate the scraped proxies by checking their accessibility. -
-u, --update
: This flag updates the project. Cannot be used in conjunction with any other flag. -
-h, --help
: Use this flag to spit out a help menu. -
-v, --version
: Use this flag to spit outproXXy.py
's version. -
-s, --src_check
: Use this flag to categorize the sources according to how many proxies they provide.
usage: proXXy.py [-h] [--validate] [--update] [--version] [--src_check]
A super simple asynchronous multithreaded proxy scraper;
scraping & checking ~500k HTTP, HTTPS, SOCKS4, & SOCKS5 proxies.
options:
-h, --help show this help message and exit
--validate, -v Flag to validate proxies after scraping (default: False)
--update, -u Flag to run the update script and then exit
--version, -V Print the version of the script and exit
--src_check, -s Flag to verify sources
- Add URL rotation
- Fix Unix-like compatibility errors.
proXXy
currently does not support unix-like verification. - Allow the user to choose the number of threads they'd like to use with flags, & provide the user recommended values based on their hardware.
- Implement SOCKS4 & SOCKS5 testing.
- Proxy sorting instead of hardcoding.
- Discerning between Elite, Anonymous, and Transparent anonymity classes of proxies.
Need help and can't get it to run correctly? Open an issue or contact me here.
If you like what I do, buy me boba so I can continue developing this tool and others! Ko-Fi
- Full changelog: https://github.com/0xSolanaceae/proXXy/compare/v2.5...v2.6
This project is licensed under the GNU General Public License v3.0 License. See the LICENSE
file for more information.