Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 1.77 KB

README.md

File metadata and controls

49 lines (33 loc) · 1.77 KB

AbuseIPDB Scanner

This is a python script that will parse IP addresses from files or manually interact with AbuseIPDB API. It will return the information about the IP into standard out in various outputs.

Installation

git clone https://github.com/mikebanks/AbuseIPdbSCAN.git

Requirements

pip3 install -r requirements.txt

AbuseIPDB API Key

In order to use the script you will need an API key. The AbuseIPDB API key information can be found here: https://www.abuseipdb.com/api.html (deprecated, V2: https://docs.abuseipdb.com/)

Usage

Short Form Long Form Description
-b --block lookup an IP block
-c --csv outputs items in comma seperated values
-d --days take in the number of days in history to go back for IP reports. Default: 30 Days
-f --file parses IP Addresses from a single given file
-i --ip lookup a single IP address
-j --json outputs items in json format (reccomended)
-l --jsonl outputs items in jsonl format (reccomended)
-t --tsv outputs items in tab seperated values (Default)
-x --translate by default categories are numbers, with this flag it will convert them to text
-v --version displays version information
-cc --countrycode select a country code to check IP range

Examples

  • To search for reports on an IP address:

python3 AbuseIPDB.py -i 1.1.1.1

  • To search for reports on an IP Block:

python3 AbuseIPDB.py -b 1.1.1.0/24

  • To search a whole country IP range and translate the categories to names:

python3 AbuseIPDB.py -cc nz -x