performing-ip-reputation-analysis-with-shodan

Analyze IP address reputation using the Shodan API for threat intelligence enrichment.

954|172|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/xalgord/xalgorix --skill performing-ip-reputation-analysis-with-shodan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performing-ip-reputation-analysis-with-shodan
Source: https://github.com/xalgord/xalgorix/tree/main/internal/tools/skills/data/threat-intelligence/performing-ip-reputation-analysis-with-shodan
Command: npx skills add https://github.com/xalgord/xalgorix --skill performing-ip-reputation-analysis-with-shodan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires shodan, requests.

What problem does it solve?

Security analysts triaging alerts need fast, reliable context on suspicious IP addresses, but manually checking open ports, services, and known vulnerabilities across sources is slow and error-prone. This Skill automates IP reputation analysis with the Shodan API and the free InternetDB API, producing scored, structured enrichment data for SOC triage and threat intelligence workflows.

Core Features & Use Cases

  • Full IP Enrichment: Query the Shodan host API to retrieve open ports, service banners, SSL certificate details, CVEs, ASN, geolocation, and tags for any IP address.
  • Reputation Scoring: Automatically score IPs based on vulnerability counts, suspicious ports, tags, and excessive exposed services, classifying them as low, medium, high, or critical.
  • Batch Processing & Infrastructure Correlation: Enrich lists of IPs with rate limiting, and pivot on organization or SSL certificate attributes to find related infrastructure.
  • Use Case: A SOC analyst receives an alert involving 50 external IPs. Use this Skill to batch-enrich all of them, sort by reputation score, and escalate only the critical ones for blocking.

Quick Start

Use the Shodan IP reputation skill to enrich the IP address 203.0.113.1 and report its open ports, vulnerabilities, and reputation level.

Frequently Asked Questions about performing-ip-reputation-analysis-with-shodan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check IP reputation with the Shodan API in Python?

Install the shodan Python library, initialize it with your API key, and call api.host(ip) to retrieve ports, services, vulnerabilities, and geolocation. The skill's ShodanEnricher class wraps this and adds automatic reputation scoring.

What is the difference between Shodan API and InternetDB?

InternetDB (internetdb.shodan.io) is a free, unauthenticated API returning ports, hostnames, tags, CPEs, and CVEs, ideal for bulk triage. The full Shodan API requires a key but adds banners, SSL details, timestamps, and search capabilities.

Can I use Shodan IP enrichment without an API key?

Yes, the InternetDB endpoint at internetdb.shodan.io works without authentication and returns a reduced dataset. It lacks banners and timestamps, so it should not be the sole basis for a verdict.

Why can Shodan vulnerability data be inaccurate for triage?

Shodan results reflect the last scan, not the current state, so hosts may be remediated or banners spoofed. Always check the last_update field and corroborate with sources like VirusTotal or GreyNoise before escalating.

How do I avoid false positives from honeypots in Shodan results?

Check the tags field for honeypot or ics-honeypot markers and look for implausible combinations like mass open ports with conflicting banners. Do not score a host critical solely for having many open ports.