← Back to Skills Marketplace
148
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install shodan-skills
Description
查询 Shodan 物联网搜索引擎获取设备信息、安全数据和网络资产;当用户需要进行 IP 地址分析、设备搜索、DNS 查询、网络安全评估或获取物联网设备信息时使用
Usage Guidance
This skill appears coherent and implements Shodan API calls as described, but consider the following before installing: (1) Protect your SHODAN_API_KEY — store it securely and avoid sharing logs that include it. The script sends the key as a query parameter (Shodan's documented method), which can appear in logs or proxies. (2) Be mindful of legal/ethical constraints: querying or enumerating devices you do not own or have permission to test can be unlawful. (3) Observe Shodan rate limits and use count/facets to reduce quota usage. (4) Ensure Python and the requests dependency are installed from trusted sources. (5) If you need stronger assurance, review the included scripts yourself (they are small and readable) or use a read-only / limited Shodan key if available.
Capability Analysis
Type: OpenClaw Skill
Name: shodan-skills
Version: 1.0.0
The 'shodan-skills' bundle is a legitimate tool for interacting with the Shodan API. The Python script (scripts/shodan_api.py) correctly implements standard Shodan endpoints (host, search, DNS) using the requests library and securely retrieves the API key from environment variables. The documentation (SKILL.md and references/api-reference.md) provides clear, helpful instructions for the AI agent without any evidence of prompt injection, data exfiltration, or malicious intent.
Capability Assessment
Purpose & Capability
Name/description, declared primaryEnv (SHODAN_API_KEY), SKILL.md usage, and the included scripts all align: the skill queries Shodan endpoints for host/search/count/dns/etc. The single required credential is exactly what Shodan API access needs.
Instruction Scope
SKILL.md instructs the agent to run the bundled scripts which only read SHODAN_API_KEY from the environment and call api.shodan.io endpoints. There are no instructions to read unrelated files, other env vars, or to exfiltrate data to third‑party endpoints.
Install Mechanism
This is instruction-plus-source (no install spec). The only dependency is requests==2.28.0 as declared in SKILL.md; no external downloads, URL shorteners, or archive extraction are used. Risk from install is low but the runtime needs the Python requests package available.
Credentials
Only SHODAN_API_KEY is required and is justified by the skill's purpose. The code reads that env var and sends it to api.shodan.io as a query parameter (expected for Shodan). No other credentials or config paths are requested.
Persistence & Privilege
always is false and the skill does not request system-wide configuration changes or persistent elevated privileges. Autonomous invocation is allowed by default but combined with limited scope and single API key this is expected.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install shodan-skills - After installation, invoke the skill by name or use
/shodan-skills - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Shodan API integration skill.
- Provides device information, security data, and network asset queries via Shodan.
- Supports host lookup, device search, DNS/domain queries, port/service info, and result statistics.
- Requires configuration of the SHODAN_API_KEY environment variable.
- Returns structured data for analysis, security assessment, and reporting.
- Includes sample usage and best practice guidance.
Metadata
Frequently Asked Questions
What is shodan-skills?
查询 Shodan 物联网搜索引擎获取设备信息、安全数据和网络资产;当用户需要进行 IP 地址分析、设备搜索、DNS 查询、网络安全评估或获取物联网设备信息时使用. It is an AI Agent Skill for Claude Code / OpenClaw, with 148 downloads so far.
How do I install shodan-skills?
Run "/install shodan-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is shodan-skills free?
Yes, shodan-skills is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does shodan-skills support?
shodan-skills is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created shodan-skills?
It is built and maintained by 末心 (@moxin1044); the current version is v1.0.0.
More Skills