achillean/shodan-python

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

2950 stars · 688 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

The official Python library and command-line interface for the Shodan search engine, which indexes Internet-connected devices and services. It provides programmatic access to Shodan's search, IP lookup, streaming, DNS database, and exploit search APIs.

Use cases

• search for exposed internet-connected devices
• look up open ports and services for an IP address
• monitor my network's attack surface
• stream real-time Shodan banner data
• find devices running vulnerable software versions
• query DNS records for a domain
• search for exploits by CVE

When to choose

• you need programmatic access to Shodan data from Python
• you want a ready-made CLI for querying Shodan without writing scripts
• you're building security tooling that integrates Shodan intelligence
• you need real-time streaming of Shodan's firehose data

When to avoid

• you need a search engine for websites rather than devices
• you don't have a Shodan API key or subscription
• you want to scan networks yourself rather than query Shodan's collected data
• you need a client in a language other than Python

Facets

library · maturity stable

search-engine http-client cli security osint networking security osint networking developer-tools python cli cross-platform shodan api-client internet-scanning attack-surface streaming-api cybersecurity reconnaissance search command-line

Member repositories

For agents

markdown · JSON · MCP: product_card(name="achillean/shodan-python")