This tool queries an IP address against the proxycheck.io API and retrieves information about the IP including whether it's a proxy, VPN, its ASN and node information. It will also output abuse information via AbuseIPB.
Results are displayed in JSON format.
Multiple IPs can be queried, which will result in a sequential query for each IP, returning an individual JSON output for each one.
Example output:
- Make sure you have Git installed on your system. If not, you can install it using the following command:
sudo apt install git
- Clone the repository from GitHub using the following command:
git clone https://github.com/jacobstickney/pcheck
- Navigate into the cloned repository
cd pcheck
- Make sure you have Python installed on your system. Most Linux distributions already have Python installed by default. You can check your Python version by running
python --versionorpython3 --versionin your terminal. If it's not installed, use your distribution's package manager to install Python.
- Install
pip, which is the package installer for Python. You can do this by running the following command in your terminal:
sudo apt install python3-pip
- Install the required Python libraries. You can do this by running the following command in your terminal:
pip3 install requests pygments colorama
- Permanently the following environment variables:
API_KEY: Your API key for ProxyCheck service. It is free to obtain an API key.ABUSE_KEY: Your API key for AbuseIPDB. It is free to obtain an API key.
Open the terminal (example below is for Ubuntu Linux) and type:
nano ~/.bashrc
This will open the .bashrc file in a text editor. Scroll to the bottom of the file and add the following lines, replacing 'your_api_key' and 'your_abuse_key' with your actual keys:
export API_KEY='your_api_key'
export ABUSE_KEY='your_abuse_key'
Press CTRL + X to exit, then Y to save changes, and finally hit Enter to write the changes and close the editor.
- To ensure the variables are set, either restart the terminal or type:
source ~/.bashrc
You can verify if the variables are set by typing:
echo $API_KEY
echo $ABUSE_KEY
- Run the Python script in your terminal with the following command:
python3 pcheck.py
- Change the permissions of the script to make it executable by running
chmod +x script.pyin your terminal.
- Run your script by typing
./script.py.
- Make sure you have Python installed on your system. If not, you can download it from here. During installation, make sure to check the box that says "Add Python to PATH".
- Open the Command Prompt.
- Install
pip, which is the package installer for Python. You can do this by running the following command in your Command Prompt:
py -m ensurepip --upgrade
- Install the required Python libraries. You can do this by running the following command in your Command Prompt:
py -m pip install requests pygments colorama
- If you want to use Git to download the Python script, first make sure you have Git installed. If not, you can download it from here. Then clone the repository from GitHub using the following command:
git clone https://github.com/jacobstickney/pcheck
- Navigate into the cloned repository. For instance, if the repository is saved in the "Documents" folder, you would use:
cd Documents\pcheck
- To add the environment variables permanently through the System Properties window:
- Open the Start Search, type in "env", and choose "Edit the system environment variables":
- Click the "Environment Variables..." button.
- Under the "System variables" section, click "New...".
- Enter "API_KEY" as the Variable name and your actual API key as the Variable value.
- Click "OK", and then repeat the process for the "ABUSE_KEY".
- After adding both, click "OK" in the Environment Variables window and then in the System Properties window.
To make sure the variables are set, open a new command prompt and type:
echo %API_KEY%
echo %ABUSE_KEY%
Each command should output the respective key you set.
- Run the Python script in your Command Prompt with the following command:
pcheck.py