--- name: shodan-reconnaissance-and-pentesting-62f236cf85dc description: This skill should be used when the user asks to "search for exposed devices on the internet," "perform Shodan reconnaissance," "find vulnerable services using Shodan," "scan IP ranges with Shodan," or "discover IoT devices and open ports." It provides comprehensive guidance for using Shodan's search engine, CLI, and API for penetration testing reconnaissance. metadata: author: zebbern version: 4.1.0-fractal --- # Shodan Reconnaissance and Pentesting ## Purpose Provide systematic methodologies for leveraging Shodan as a reconnaissance tool during penetration testing engagements. This skill covers the Shodan web interface, command-line interface (CLI), REST API, search filters, on-demand scanning, and network monitoring capabilities for discovering exposed services, vulnerable systems, and IoT devices. ## Inputs / Prerequisites - **Shodan Account**: Free or paid account at shodan.io - **API Key**: Obtained from Shodan account dashboard - **Target Information**: IP addresses, domains, or network ranges to investigate - **Shodan CLI**: Python-based command-line tool installed - **Authorization**: Written permission for reconnaissance on target networks ## Outputs / Deliverables - **Asset Inventory**: List of discovered hosts, ports, and services - **Vulnerability Report**: Identified CVEs and exposed vulnerable services - **Banner Data**: Service banners revealing software versions - **Network Mapping**: Geographic and organizational distribution of assets - **Screenshot Gallery**: Visual reconnaissance of exposed interfaces - **Exported Data**: JSON/CSV files for further analysis ## Core Workflow ## 🧠 Knowledge Modules (Fractal Skills) ### 1. [1. Setup and Configuration](./sub-skills/1-setup-and-configuration.md) ### 2. [2. Basic Host Reconnaissance](./sub-skills/2-basic-host-reconnaissance.md) ### 3. [3. Search Queries](./sub-skills/3-search-queries.md) ### 4. [4. Search Filters Reference](./sub-skills/4-search-filters-reference.md) ### 5. [5. On-Demand Scanning](./sub-skills/5-on-demand-scanning.md) ### 6. [6. Statistics and Analysis](./sub-skills/6-statistics-and-analysis.md) ### 7. [7. Network Monitoring](./sub-skills/7-network-monitoring.md) ### 8. [8. REST API Usage](./sub-skills/8-rest-api-usage.md) ### 9. [Essential CLI Commands](./sub-skills/essential-cli-commands.md) ### 10. [Common Search Queries](./sub-skills/common-search-queries.md) ### 11. [Useful Filter Combinations](./sub-skills/useful-filter-combinations.md) ### 12. [Credit System](./sub-skills/credit-system.md) ### 13. [Operational Boundaries](./sub-skills/operational-boundaries.md) ### 14. [Data Freshness](./sub-skills/data-freshness.md) ### 15. [Legal Requirements](./sub-skills/legal-requirements.md) ### 16. [Example 1: Organization Reconnaissance](./sub-skills/example-1-organization-reconnaissance.md) ### 17. [Example 2: Vulnerable Service Discovery](./sub-skills/example-2-vulnerable-service-discovery.md) ### 18. [Example 3: IoT Device Discovery](./sub-skills/example-3-iot-device-discovery.md) ### 19. [Example 4: SSL/TLS Certificate Analysis](./sub-skills/example-4-ssltls-certificate-analysis.md) ### 20. [Example 5: Python Automation Script](./sub-skills/example-5-python-automation-script.md) ### 21. [Example 6: Network Range Assessment](./sub-skills/example-6-network-range-assessment.md) --- Source attribution: Dokhacgiakhoa Original project: https://github.com/Dokhacgiakhoa/antigravity-ide/blob/c4a059bbf7a8d6b2162071f0fbfe74053faa6d20/.agent/skills/shodan-reconnaissance/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Dokhacgiakhoa Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ================================================================================ UNIVERSAL ACKNOWLEDGEMENTS & REFERENCES ================================================================================ This project is authored and maintained by Dokhacgiakhoa. Antigravity IDE (Enhanced Edition) draws significant inspiration and inherits open-source knowledge from the following masters and repositories: 1. Antigravity Kit (Core Reference) - Original Author: vudovn - Link: https://github.com/vudovn/antigravity-kit 2. Antigravity Awesome Skills (Skill Metadata Reference) - Original Author: sickn33 - Link: https://github.com/sickn33/antigravity-awesome-skills 3. UI/UX Pro Max (Design Philosophy Reference) - Original Author: sickn33 - Link: https://github.com/sickn33/ui-ux-pro-max 4. Model Context Protocol (MCP) standards - Authors: Anthropic & Ecosystem Contributors - Link: https://modelcontextprotocol.io/ 5. High-Performance Web Standards - Inspiration: Vercel Engineering & Anthony Fu (antfu) 6. Strategic Knowledge Extraction - Inspiration: Fabric Patterns (danielmiessler) *Note: All trademarks and copyrights belong to their respective owners. The references above reflect research-level inspiration and antecedent contributions. These parties are not involved in the management of this repository.* # Mega AI Hub resource metadata Creator / publisher: Dokhacgiakhoa Original project: https://github.com/Dokhacgiakhoa/antigravity-ide/blob/c4a059bbf7a8d6b2162071f0fbfe74053faa6d20/.agent/skills/shodan-reconnaissance/SKILL.md Attribution basis: Source repository record Fields of work: Data & Analytics, Development & Engineering Roles: Data Analyst, Security Engineer Specialties: API Tools: Shodan Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 864dd7f9a99476630ed53d57a8211c33e11c9777013505058ca3e91513039c9b