🔍 Shodan IP Extractor

A powerful Python-based CLI tool to extract IP addresses from Shodan search results using the official Shodan API.

---

Features

• ✅ Extract IPs using your own Shodan API key
• ✅ Search using advanced queries (e.g., port, country, product, org)
• ✅ Collect thousands of IPs using pagination
• ✅ Save output to a file
• ✅ Delay support to avoid API rate limits
• ✅ CLI-based and easy to use

---

Requirements

• Python 3.x
• Shodan Python Library

Install the library via pip:

pip install shodan

---

Usage

python3 Shodan-IP-Extractor.py -k YOUR_API_KEY -q "your query" [options]

---

⚙️ Command Line Arguments

Argument	Description
-k, --api-key	Shodan API key (required)
-q, --query	Shodan search query string
-p, --pages	Number of result pages to fetch (default: 1)
-d, --delay	Delay between API requests in seconds (default: 1.0)
-o, --output	Output file to save found IPs

---

Examples

Basic usage (single page):

python3 Shodan-IP-Extractor.py -k YOUR_API_KEY -q "apache"

Save results to file:

python3 Shodan-IP-Extractor.py -k YOUR_API_KEY -q "nginx" -o nginx_ips.txt

Extract 50 pages (5000 results max):

python3 Shodan-IP-Extractor.py -k YOUR_API_KEY -q "port:22 country:US" -p 50 -d 1 -o ssh_us_ips.txt

---

Example Queries

Goal	Query
Apache servers	apache
Open SSH in US	port:22 country:US
MongoDB with no auth	product:MongoDB port:27017
RDP in Germany	port:3389 country:DE

🔗 More at: Shodan Search Guide

---

Shodan API Key

You can get your API key from the Shodan account dashboard.

Free accounts have search and usage limits. For large-scale scans, use a Shodan Membership or API plan.

---

Output

The script saves results as a plain text file like:

192.168.0.1
45.77.23.99
203.0.113.15
...

You can process this list with tools like nmap, masscan, or custom scripts.