Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/Liberty91LTD/cti-skillsnpx agentmods add skills/liberty91ltd/cti-skills/lookup-shodanWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/liberty91ltd/cti-skills/lookup-shodan)<a href="https://agentmods.dev/skills/liberty91ltd/cti-skills/lookup-shodan"><img src="https://agentmods.dev/badge/skills/liberty91ltd/cti-skills/lookup-shodan/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/liberty91ltd/cti-skills/lookup-shodan"><img src="https://agentmods.dev/badge/skills/liberty91ltd/cti-skills/lookup-shodan.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00056 | $0.01380 |
| Opus 5 | $0.00028 | $0.00690 |
| Sonnet 5 | $0.00011 | $0.00276 |
| Haiku 4.5 | $0.00006 | $0.00138 |
Grade A, and why
lookup-shodan scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 133 lines — stays where its author put it; the contents beside it link to each section on GitHub.
lookup-shodan
Queries Shodan for host reconnaissance data on IPs. For domains, resolves DNS first then queries the resolved IP. Retrieval only — do not interpret results.
When to invoke
- User asks what ports/services an IP exposes
- Investigation skill needs infrastructure fingerprinting
- Vulnerability scan context (CVEs on exposed services)
How to invoke
Two CLIs are provided. Pick by capability needed:
Basic host lookup — Node CLI (zero deps)
node tools/clis/shodan.js ip <ip>
node tools/clis/shodan.js domain <domain> # resolves DNS first, then queries IP
Hits the host endpoint only. Best for fast retrieval inside an investigation chain. Throttles at 1 req/sec.
Full search + DNS surface — Python CLI (uses official shodan-python SDK)
python3 tools/clis/shodan.py host <ip> [--history] [--minify]
python3 tools/clis/shodan.py search "<query>" [--limit N] [--page N] [--facets F1:N,F2:N]
python3 tools/clis/shodan.py count "<query>" [--facets F1:N,F2:N]
python3 tools/clis/shodan.py dns resolve <hostname[,hostname]>
python3 tools/clis/shodan.py dns reverse <ip[,ip]>
python3 tools/clis/shodan.py dns domain <domain>
python3 tools/clis/shodan.py info
python3 tools/clis/shodan.py ports
python3 tools/clis/shodan.py services
Self-bootstraps a private venv at tools/clis/.venv-shodan/ on first run.
Capabilities the Node CLI doesn't have, ordered by CTI value:
- Search — the killer pivot. Find every host on the internet matching a banner, certificate, JARM, favicon hash, HTTP title, exposed product+version, or geolocation+org combination. This is how you go from one piece of attacker infrastructure to the rest of the cluster.
- Count — get the total result count for a query without burning result credits. Use this BEFORE a search to estimate scope and avoid query-credit waste on broad queries.
- Facets — group result counts by
country,org,port,product,asn,tag,vuln, etc. Single call gives you the breakdown. - Domain info — subdomains + DNS records for a domain in one call.
- Reverse DNS for one or many IPs.
- Account info — see remaining query credits BEFORE a campaign.
- History — historical banner observations on a host (paid plans).
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 12d ago First seen · 133 lines · 56 tokens per session scan A cd6cd16b0438
lookup-shodan is a skill published in the GitHub repository Liberty91LTD/cti-skills (18 stars, last pushed 1mo ago), licensed MIT. It adds 56 tokens to every session and 1,380 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
ai-ad-copy-compliance-review
A risk-review assistant for advertising and sales copy. It examines provided material for possible concerns and suggests actions.
ai-agent-browser
A business-diagnosis assistant for marketing, operations, product, and sales questions. It breaks down a goal and produces a summary, findings, action suggestions, and reusable deliverables.
ai-article
A Chinese-language assistant for turning source material into article and content-operation deliverables. It is aimed at creators, marketers, technical teams, and media publishers.
ai-brand-voice-review
A business-diagnosis assistant for marketing, operations, services, and sales questions.
ai-browser-use
A business-diagnosis assistant for marketing, operations, product, and sales questions about how to approach a task.
ai-content-material-audit
A Chinese-language copy-review assistant for creators, marketers, operators, and media teams.