This repository contains a script to download search results from Shodan and filter specific fields from the results. The script extracts and simplifies the output, keeping only essential information. Additionally, it allows you to save the results in a JSON file and print detailed entries. The full JSON result from Shodan is always downloaded and saved locally in a GZIP compressed format.
- Shodan API key
- Python 3.x
- Shodan CLI
-
Install the Shodan CLI if you haven't already:
pip install shodan
-
Clone this repository:
git clone https://github.com/nemmusu/shodan-output-parser.git cd shodan-output-parser
The main script shodan_wrapper.py
wraps the Shodan download command and filters the results based on specified fields.
filename
: Name of the file to save the search results (file .json.gz)search_query
: Search query (e.g., "org: organization", "ip: 8.8.8.8" or "ip: 8.8.0.0-8.8.255.255, "hostname: example.com")--limit
: Maximum number of results to download (optional)-j, --json
: Save the results in a JSON file (optional)-v, --verbose
: Print detailed extracted entries (optional)
python shodan_wrapper.py results "org: yourorganization" --limit 100 -j -v