Port Scanner

Name: Port Scanner
Author: aidotnet

aidotnet/moyucode

28 installs
84 repo stars
Updated January 28, 2026
aidotnet/moyucode

port-scanner is a Claude Code skill that scans network ports to check availability and detect running services on a host.

About

port-scanner is a Claude Code skill that scans network ports to check availability and detect running services. A developer runs its bundled Python script to test a single port, a port range, or a set of common ports against a host. It is built on Python's standard socket module.

Scans network ports to detect open ports and running services
Supports single-port checks, port ranges, and common-port scans
Bundled Python script built on the standard socket module

Port Scanner by the numbers

28 all-time installs (skills.sh)
Ranked #1,512 of 2,203 Security skills by installs in the Skillselion catalog
Data as of Jul 28, 2026 (Skillselion catalog sync)

At a glance

port-scanner capabilities & compatibility

Capabilities: port scanning · service detection · network scan
Use cases: security audit
Pricing: Free

From the docs

What port-scanner says it does

Scan network ports to check availability, detect running services, and find open ports.

SKILL.md

Based on Python's socket: https://github.com/python/cpython

scripts/port_scanner.py

npx skills add https://github.com/aidotnet/moyucode --skill port-scanner

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/aidotnet/moyucode/port-scanner.svg)](https://skillselion.com/skills/aidotnet/moyucode/port-scanner)

Installs	28
repo stars	★ 84
Last updated	January 28, 2026
Repository	aidotnet/moyucode ↗

What it does

Scan a host for open network ports and detect running services from the CLI.

Who is it for?

Checking which network ports are open on a host from the CLI

Skip if: Deep vulnerability assessment or exploiting discovered services

When should I use this skill?

You need to check open ports or detect running services on a host

What you get

A report of open ports and detected services on the target host

A list of open ports and detected services

By the numbers

Supports 4 scan modes: single port, port range, common ports, and availability check

Files

SKILL.mdMarkdownGitHub ↗

Port Scanner Tool

Description

Scan network ports to check availability, detect running services, and find open ports.

Trigger

/port command
User needs to check ports
User wants to scan network

Usage

# Check single port
python scripts/port_scanner.py localhost 8080

# Scan port range
python scripts/port_scanner.py 192.168.1.1 --range 80-443

# Scan common ports
python scripts/port_scanner.py example.com --common

# Check if port is available
python scripts/port_scanner.py localhost 3000 --available

Compatibility

Codex: ✅
Claude Code: ✅

#!/usr/bin/env python3
"""
Port Scanner Tool
Based on Python's socket: https://github.com/python/cpython

Usage:
    python port_scanner.py localhost 8080
    python port_scanner.py 192.168.1.1 --range 80-443
"""

import argparse
import socket
import sys
from concurrent.futures import ThreadPoolExecutor, as_completed

COMMON_PORTS = {
    21: 'FTP', 22: 'SSH', 23: 'Telnet', 25: 'SMTP', 53: 'DNS',
    80: 'HTTP', 110: 'POP3', 143: 'IMAP', 443: 'HTTPS', 465: 'SMTPS',
    587: 'SMTP', 993: 'IMAPS', 995: 'POP3S', 3306: 'MySQL', 5432: 'PostgreSQL',
    6379: 'Redis', 8080: 'HTTP-Alt', 8443: 'HTTPS-Alt', 27017: 'MongoDB'
}

def scan_port(host, port, timeout=1):
    """Scan a single port."""
    try:
        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        sock.settimeout(timeout)
        result = sock.connect_ex((host, port))
        sock.close()
        return port, result == 0
    except:
        return port, False

def scan_ports(host, ports, timeout=1, threads=50):
    """Scan multiple ports concurrently."""
    results = {}
    with ThreadPoolExecutor(max_workers=threads) as executor:
        futures = {executor.submit(scan_port, host, p, timeout): p for p in ports}
        for future in as_completed(futures):
            port, is_open = future.result()
            results[port] = is_open
    return results

def main():
    parser = argparse.ArgumentParser(description="Scan network ports")
    parser.add_argument('host', help='Target host')
    parser.add_argument('port', nargs='?', type=int, help='Single port')
    parser.add_argument('--range', '-r', help='Port range (e.g., 80-443)')
    parser.add_argument('--common', '-c', action='store_true', help='Scan common ports')
    parser.add_argument('--available', '-a', action='store_true', help='Check if available')
    parser.add_argument('--timeout', '-t', type=float, default=1, help='Timeout')
    args = parser.parse_args()
    
    # Resolve hostname
    try:
        ip = socket.gethostbyname(args.host)
        print(f"Scanning {args.host} ({ip})...")
    except socket.gaierror:
        print(f"Error: Cannot resolve {args.host}", file=sys.stderr)
        sys.exit(1)
    
    # Determine ports to scan
    if args.port:
        ports = [args.port]
    elif args.range:
        start, end = map(int, args.range.split('-'))
        ports = range(start, end + 1)
    elif args.common:
        ports = list(COMMON_PORTS.keys())
    else:
        parser.error("Specify port, --range, or --common")
    
    results = scan_ports(args.host, ports, args.timeout)
    
    open_ports = [p for p, is_open in results.items() if is_open]
    
    if args.available and args.port:
        if args.port in open_ports:
            print(f"✗ Port {args.port} is in use")
            sys.exit(1)
        else:
            print(f"✓ Port {args.port} is available")
            sys.exit(0)
    
    print(f"\nOpen ports ({len(open_ports)}):")
    for port in sorted(open_ports):
        service = COMMON_PORTS.get(port, 'Unknown')
        print(f"  {port}/tcp - {service}")
    
    if not open_ports:
        print("  No open ports found")

if __name__ == "__main__":
    main()