shodan-reconnaissance — Claude Code skill: setup and features
Guides Claude Code through network reconnaissance using Shodan CLI and API. Helpful for discovering exposed internet hosts, open ports, and known service vulnerabilities.
npx claude-code-templates@latest --skill security/shodan-reconnaissanceWhat shodan-reconnaissance does
This skill directs Claude Code on structuring reconnaissance workflows with the Shodan search engine. It details syntax for querying individual target IP addresses, inspecting banners, and evaluating hosts with the honeyscore check. Structured CLI commands show how to pull filtered records by country, organization, or port, and save exports as JSON or CSV files.
The instructions also outline on-demand scans via shodan scan submit alongside direct REST API endpoints. You must configure an API key through shodan init beforehand, or the commands will fail. Several search filters and scan operations also deduct account credits.
What it helps with
- inventory open network ports and services across target IPs
- identify internet-facing hosts affected by specific CVEs
- export Shodan search query results into JSON or CSV files
- verify whether a target host behaves as a honeypot
Example prompts for the agent
- Inspect IP 1.1.1.1 with Shodan and list open network ports
- Gather statistics on nginx installations in New York using the Shodan CLI
- Submit host 192.168.1.100 for scanning and store output in
scan_results.json.gz
How to install shodan-reconnaissance
1claude-code-templates
npx claude-code-templates@latest --skill security/shodan-reconnaissance2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill shodan-reconnaissance -a claude-code3Manually: put the files in place
~/.claude/skills/shodan-reconnaissance/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shodan-reconnaissance/
Manually: put the files in place
.agents/skills/shodan-reconnaissance/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/shodan-reconnaissance/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates shodan-reconnaissance2Manually: put the files in place
.github/skills/shodan-reconnaissance/SKILL.mdPlatform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/security/shodan-reconnaissanceManually: put the files in place
.devin/skills/shodan-reconnaissance/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about shodan-reconnaissance
How to install shodan-reconnaissance in Claude Code?
Run npx claude-code-templates@latest --skill security/shodan-reconnaissance in your terminal.
What does the shodan-reconnaissance skill do?
It provides instructions and command syntax for interacting with Shodan via CLI and REST API. The assistant learns how to query hosts, parse banners, and filter network assets.
Does this skill require a paid Shodan account?
Basic queries work with free accounts, but running on-demand scans and complex filtered searches consumes Shodan query or scan credits.