Shodan
Tool manual · Kali & common usage
OSINT · Intermediate · OSINT lane
What is Shodan?
Shodan searches internet-connected devices and banners.
Find exposed services on assets you own; never abuse for unauthorized scanning.
Official website: Shodan · Documentation
When do you use it?
- You need Find internet-exposed services on IPs and org footprints (monitor assets you own).
- You are following a CYNARKS lab or authorized engagement that calls for Shodan.
- You already tried simpler checks and need this tool’s deeper capability.
When not to use it
- Do not use results to attack third parties. Follow law and Shodan ToS.
Who uses it?
- OSINT analysts
- Investigators (lawful use)
- Red teamers (authorized recon)
How do you use it? (typical flow)
- Install Shodan using the steps below (prefer Kali package or official installer).
- Confirm you have authorization for the target (lab VM, own system, or written scope).
- Run --help / man (or the Help section) to see current flags for your version.
- Start with a safe example from Basic commands against localhost or an authorized lab target.
- Record what you ran, what you observed, and any follow-up (filter, report, remediation).
Help & manual (like man / --help)
Every serious tool has a built-in way to look up flags. Learn these first so you are not stuck memorizing every option.
1. Help
shodan --help
2. Site
https://www.shodan.io/
Kali Linux
CLI (shodan) via pip + API key; web UI available.
1. Installation
| OS | Installation |
|---|---|
Kali Linux | CLI (shodan) via pip + API key; web UI available. |
Web | https://account.shodan.io/register |
2. Basic commands
1. Review unexpected ports
Search your org name
Review unexpected ports
2. Show help
Search --help
List flags for your installed version (same habit as man/--help).
3. Short help
Search -h
Alternate help flag when supported.
4. Set alerts for your netblocks
alert
Set alerts for your netblocks
Options / flags
| Option | Purpose |
|---|---|
alert | Set alerts for your netblocks |
5. Useful features
- Filters
- Org search
- Alerts
6. Practical examples
Example 1: Review unexpected ports
Search your org name
Review unexpected ports
Example 2: Show help
Search --help
List flags for your installed version (same habit as man/--help).
Example 3: Short help
Search -h
Alternate help flag when supported.
Example 4: Set alerts for your netblocks
alert
Set alerts for your netblocks
7. Important notes
- Monitoring your attack surface — not scanning arbitrary targets.
- Authorized targets only — labs, systems you own, or written permission.
- Prefer reading --help / man / official docs for your installed version; flags change over time.
Related course: ethical hacking penetration testing · soc analyst blue team · Commands: /osint