network-scanner
by florianbeer
Apple Apps & ServicesBrief
Scan networks to discover devices, gather MAC addresses.
Description
What This Skill Does
Scans local networks using nmap to discover connected devices and collect their IP addresses, MAC addresses, vendor names, and hostnames via reverse DNS. Blocks scanning of public IP ranges and blocklisted networks to prevent accidental abuse.
Built-in public IP and blocklist checks prevent the accidental scans of non-private ranges that a raw nmap command would allow.
When to Use It
- Check what devices are connected to your home network
- Identify an unknown device by its MAC address and vendor
- Generate a device inventory table for network documentation
- Detect new devices joining an office network
- Run automated presence detection for home automation
Example Workflow
User asks: scan my home network and show me all devices
- 1
Run python3 scripts/scan.py home to target the configured home network CIDR
- 2
nmap scans 192.168.1.0/24 with sudo for ARP-based MAC discovery
- 3
dig performs reverse DNS lookups on each responding IP
- 4
Script maps MAC prefixes to vendor names
- 5
Format results as a markdown table with IP, hostname, MAC, and vendor columns
Markdown table listing each device with its IP, hostname (e.g. router.local), MAC address, and vendor (e.g. Ubiquiti, Synology), plus a device count summary
Requirements
- nmap installed (apt install nmap or brew install nmap)
- sudo access for MAC address discovery
Installation
clawhub install florianbeer/network-scannerRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.