← Back to Skills Marketplace
280
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install jrv-port-scanner
Description
Fast TCP port scanner for network reconnaissance and security auditing. Scan hosts for open ports, detect common services, and identify potential attack surf...
README (SKILL.md)
Port Scanner
Lightweight, zero-dependency TCP port scanner for network recon and security auditing.
Quick Start
# Scan common ports on a host
python3 scripts/port_scan.py example.com
# Scan specific port range
python3 scripts/port_scan.py 192.168.1.1 --ports 1-1024
# Scan specific ports
python3 scripts/port_scan.py 10.0.0.1 --ports 22,80,443,3306,5432,8080
# Fast scan with short timeout
python3 scripts/port_scan.py example.com --timeout 0.5 --workers 200
# JSON output
python3 scripts/port_scan.py example.com --format json
# Scan top N most common ports
python3 scripts/port_scan.py example.com --top 100
Features
- Concurrent scanning with configurable thread count
- Common service identification (HTTP, SSH, MySQL, PostgreSQL, Redis, etc.)
- Banner grabbing for open ports
- Supports single ports, ranges, comma-separated lists, and top-N common ports
- JSON and text output formats
- No external dependencies — pure Python stdlib
Usage Guidance
This skill appears to be what it claims (a simple TCP port scanner). Before installing or running it: (1) ensure you have explicit authorization to scan the target network or host (unauthorized scanning can be illegal and disruptive); (2) consider lowering --workers and increasing --timeout on shared networks to avoid DoS-like effects; (3) you can run the included script locally to inspect behavior (it's pure Python stdlib); (4) if you don't want the agent to ever run scans autonomously, disable autonomous invocation for this skill or require explicit user approval before each run.
Capability Analysis
Type: OpenClaw Skill
Name: jrv-port-scanner
Version: 1.0.0
The skill provides a functional TCP port scanner with service detection and banner grabbing capabilities (scripts/port_scan.py). While the code is well-structured, uses only Python standard libraries, and lacks evidence of intentional malice (such as data exfiltration or backdoors), the capability for automated network reconnaissance is inherently risky. Per the provided guidelines, tools providing broad network access for their stated purpose are classified as suspicious.
Capability Assessment
Purpose & Capability
Name/description match the provided code and SKILL.md. The included script implements a TCP port scanner with service heuristics and banner grabbing; no unrelated credentials, binaries, or services are requested.
Instruction Scope
Runtime instructions simply run the bundled Python script with CLI flags. The SKILL.md and script operate only on the target host/IP provided by the user, perform DNS resolution and TCP connections, and attempt simple banner grabs (including sending a minimal HTTP HEAD to common HTTP ports). They do not read other files, environment variables, or send results to external endpoints.
Install Mechanism
No install spec or external downloads are present; this is an instruction-only skill that includes a pure-stdlib Python script. Nothing is fetched from external URLs or installed to disk at runtime beyond running the included script.
Credentials
The skill declares no required environment variables, credentials, or config paths and the code does not access secrets. Requested permissions are proportional to a network scanner.
Persistence & Privilege
always is false and there are no indications the skill modifies other skills or system settings. The skill can be invoked autonomously (platform default) which increases operational risk if you don't want autonomous network scans — this is expected behavior but worth noting.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install jrv-port-scanner - After installation, invoke the skill by name or use
/jrv-port-scanner - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Fast TCP port scanner for network reconnaissance and security auditing.
- Scans hosts for open TCP ports efficiently using concurrent threads.
- Identifies common services (e.g., HTTP, SSH, MySQL) and performs banner grabbing.
- Supports scanning single ports, ranges, lists, or the top-N most common ports.
- Outputs results in either JSON or plain text format.
- Lightweight implementation using only Python standard library with zero external dependencies.
Metadata
Frequently Asked Questions
What is Port Scanner?
Fast TCP port scanner for network reconnaissance and security auditing. Scan hosts for open ports, detect common services, and identify potential attack surf... It is an AI Agent Skill for Claude Code / OpenClaw, with 280 downloads so far.
How do I install Port Scanner?
Run "/install jrv-port-scanner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Port Scanner free?
Yes, Port Scanner is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Port Scanner support?
Port Scanner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Port Scanner?
It is built and maintained by John Wang (@johnnywang2001); the current version is v1.0.0.
More Skills