Skip to content
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
aeondave/shodanRecon and OSINT

shodan

⁨Auth/lab ref: Shodan CLI for passive internet-wide host and service discovery.⁩

v2026.11.13-21cd5683 installs+3 in 7 days39 StarsMITsynced 10 hours ago

Install

No NotHoly CLI yet? Install it first.

$ curl -fsSL https://notholy.com/install.sh | sh
$ notholy skills install aeondave/shodan

Writes to ⁦~/.notholy/skills⁩ after checking the signature and the SHA-256.

SignatureSigned, ed25519
1v1bxfDNpn…Mu2YLDBg==The CLI checks the SHA-256 and the signature before it writes a file.
Package016090c2…bd251949
016090c29dd6…1f99bd2519492 files · ⁦2.7 KB⁩
ScanLow1 finding
  • Links to outside domains
See the full scan
Sourcegithub.com/AeonDave/malskill/tree/main/offensive-tools/recon/shodan@21cd568

Passive reconnaissance via Shodan — internet-wide host/service discovery without touching targets.

Quick Start

bash
# Initialize with API key
shodan init YOUR_API_KEY

# Search for a service/banner
shodan search "apache 2.4.49"

# Host lookup
shodan host 203.0.113.10

# Account info / credits
shodan info

Core Commands

Command Description
shodan search <query> Search Shodan index
shodan host <ip> Detailed host info (open ports, banners, vulns)
shodan count <query> Count results (no credits consumed)
shodan download <file> <query> Download results to compressed JSON
shodan parse <file> Parse downloaded results
shodan domain <domain> Domain intelligence
shodan alert Manage monitoring alerts
shodan stats <query> Statistics for a query
shodan honeyscore <ip> Honeypot score (0-1)
shodan myip Your public IP

Search Filters

Filter Example
hostname: hostname:example.com
ip: ip:1.2.3.0/24
org: org:"Target Corp"
port: port:8080
product: product:Apache
version: version:2.4.49
country: country:IT
os: os:Windows
vuln: vuln:CVE-2021-44228
http.title: http.title:"Login"
html: html:"admin panel"
ssl: ssl:"example.com"
asn: asn:AS12345
net: net:192.168.0.0/16

Common Workflows

bash
# Find infrastructure for an org
shodan search org:"Target Corp" --fields ip_str,port,product

# Download and parse org results
shodan download results.json.gz org:"Target Corp"
shodan parse --fields ip_str,port,product results.json.gz

# Find exposed login panels
shodan search http.title:"administration" org:"Target"

# CVE-based research
shodan search vuln:CVE-2021-44228

# SSL cert pivot — find all hosts sharing a cert
shodan search ssl:"example.com"

# Count without consuming query credits
shodan count org:"Target Corp"

# Reverse lookup / host details
shodan host 8.8.8.8
bash
# Get favicon mmh3 hash via httpx
httpx -u https://target.com -favicon
# Outputs: [mmh3:<HASH>]

# Search Shodan for all hosts with same favicon (same product/brand)
shodan search "http.favicon.hash:<HASH>"

Monitor Target (Alerts)

bash
# Create alert for new hosts in an org
shodan alert create "Target Corp Monitor" org:"Target Corp"

# List alerts
shodan alert list

# Download results when triggered
shodan alert download <alert_id>

Resources

File When to load
references/search-filters.md Full filter reference, dork recipes, favicon hash lookup, API Python integration

Files in this version

Permissions

PermissionDeclaredFound by the scan
Reads filesNoNo
Writes filesNoNo
Runs shell commandsYesYes
Uses the networkYesYes
Uses connectorsNoNo
Drives a browserNoNo

Scan findings

Reviewed on Nov 13, 2026

  1. InfoLink · Links to outside domains

A clean scan lowers the risk but does not prove a package is safe. Read what you install.

VersionPublishedCommitSHA-256SignaturePermission change
v2026.11.13-21cd568Nov 13, 202621cd568016090c2Signed–

Ask anything your scope allows.

Create an account, add credits and ask the first question in the chat or the terminal.

  1. 1/3

    Create the account

    Individual or company. You can switch to a company later without losing balance or keys.

    IndividualCompany
  2. 2/3

    Add credits

    By card. Pay per token, no subscription.

    $5.00minimum deposit
  3. 3/3

    Ask

    In the chat, or install the CLI and run notholy login in your terminal.

    $ notholy login