Florian Beer

Network Scanner

IT Ops & Securityv1.1.0
By Florian BeerUpdated 2026-05-182 versions · latest released 2026-02-01network-scanner@clawhub_florianbeer/network-scanner
Server OpsSecurity Scanning

According to AlphaMoat, as of 2026-10, Network Scanner has 7,784 downloads and 1 stars — ranked by downloads #3,567 among 10,914 AI skills in this ranking, and #106 of 502 in IT Ops & Security.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
7.8K
Stars
1
Overall download rank
#3,567
Top 33% overall · Top 22% in IT Ops & Security
PlatformDownloadsStarsComments
ClawHub ↗6.3K--
SkillHub ↗7.8K1—

Platforms count differently and update at different times.

What this skill does

It ships three safety checks against accidental scanning: networks in the blocklist config are always blocked, scanning public (non-RFC1918) IP ranges is stopped, and ad-hoc CIDRs get route verification over private gateways, while trusted networks explicitly configured in networks.json skip route verification. It depends on nmap and dig, recommends sudo for MAC address discovery (nmap needs privileges for ARP), and also supports --no-sudo (MAC addresses may be missed). Usage: python3 scripts/scan.py auto-detects and scans the current network, or takes a CIDR such as 192.168.1.0/24, a custom --dns server, --json output, --init-config to create an example config, and --list to show configured networks; named networks and the blocklist live in ~/.config/network-scanner/networks.json. Default output is a Markdown device table (IP/name/MAC/vendor) and JSON output includes device_count. Use cases: device inventory, security audits for unknown devices, network documentation, and home-automation presence detection. the skill's security evidence reports unsafe command execution in the scanner and weaker-than-advertised public-scan protections, especially around configured networks, so review the script, limit targets to authorized private ranges, and prefer --no-sudo.

Profile published 2026-10-29

What you can do with it

  • Inventory all devices on a home or office network
  • Find unknown devices during a security audit
  • Generate network documentation or feed home automation

When to use it

  • When device discovery and inventory is needed on authorized local or private networks

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Scan my home network segment and list all devices
Check which unknown devices are on the current network
Output this scan result as JSON

Monthly Trend

Downloads7.8K
5.0K6.5K8.0K2026-05 · Downloads 5.2K2026-06 · Downloads 5.4K2026-07 · Downloads 5.7K2026-08 · Downloads 6.0K2026-09 · Downloads 6.3K2026-10 · Downloads 7.8K26-0526-0926-10
Stars1
0112026-05 · Stars -2026-06 · Stars -2026-07 · Stars 12026-08 · Stars 12026-09 · Stars 12026-10 · Stars 126-0526-0926-10

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-107.8K—1
2026-096.3K—1
2026-086.0K+4.1%1
2026-075.7K+6.6%1
2026-065.4K+4.3%-
2026-055.2K—-

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

4.0 KB · ClawHub v1.1.0
---
name: network-scanner
description: Scan networks to discover devices, gather MAC addresses, vendors, and hostnames. Includes safety checks to prevent accidental scanning of public networks.
homepage: https://clawhub.com/skills/network-scanner
metadata:
  openclaw:
    emoji: "🔍"
    requires:
      bins: ["nmap", "dig"]
    tags:
Show all (164 lines)
      - network
      - discovery
      - devices
      - nmap
      - security
---

# Network Scanner

Discover and identify devices on local or remote networks using nmap. Gathers IP addresses, hostnames (via reverse DNS), MAC addresses, and vendor identification.

**Safety First:** Includes built-in protection against accidentally scanning public IP ranges or networks without proper private routing — preventing abuse reports from hosting providers.

## Requirements

- `nmap` - Network scanning (`apt install nmap` or `brew install nmap`)
- `dig` - DNS lookups (usually pre-installed)
- `sudo` access recommended for MAC address discovery

## Quick Start

```bash
# Auto-detect and scan current network
python3 scripts/scan.py

# Scan a specific CIDR
python3 scripts/scan.py 192.168.1.0/24

# Scan with custom DNS server for reverse lookups
python3 scripts/scan.py 192.168.1.0/24 --dns 192.168.1.1

# Output as JSON
python3 scripts/scan.py --json
```

## Configuration

Configure named networks in `~/.config/network-scanner/networks.json`:

```json
{
  "networks": {
    "home": {
      "cidr": "192.168.1.0/24",
      "dns": "192.168.1.1",
      "description": "Home Network"
    },
    "office": {
      "cidr": "10.0.0.0/24",
      "dns": "10.0.0.1",
      "description": "Office Network"
    }
  },
  "blocklist": [
    {
      "cidr": "10.99.0.0/24",
      "reason": "No private route from this host"
    }
  ]
}
```

Then scan by name:

```bash
python3 scripts/scan.py home
python3 scripts/scan.py office --json
```

## Safety Features

The scanner includes multiple safety checks to prevent accidental abuse:

1. **Blocklist** — Networks in the `blocklist` config array are always blocked
2. **Public IP check** — Scanning public (non-RFC1918) IP ranges is blocked
3. **Route verification** — For ad-hoc CIDRs, verifies the route uses private gateways

**Trusted networks** (configured in `networks.json`) skip route verification since you've explicitly approved them.

```bash
# Blocked - public IP range
$ python3 scripts/scan.py 8.8.8.0/24
❌ BLOCKED: Target 8.8.8.0/24 is a PUBLIC IP range

# Blocked - in blocklist  
$ python3 scripts/scan.py 10.99.0.0/24
❌ BLOCKED: 10.99.0.0/24 is blocklisted

# Allowed - configured trusted network
$ python3 scripts/scan.py home
✓ Scanning 192.168.1.0/24...
```

## Commands

```bash
# Create example config
python3 scripts/scan.py --init-config

# List configured networks
python3 scripts/scan.py --list

# Scan without sudo (may miss MAC addresses)
python3 scripts/scan.py home --no-sudo
```

## Output Formats

**Markdown (default):**
```
### Home Network
*Last scan: 2026-01-28 00:10*

| IP | Name | MAC | Vendor |
|----|------|-----|--------|
| 192.168.1.1 | router.local | AA:BB:CC:DD:EE:FF | Ubiquiti |
| 192.168.1.100 | nas.local | 11:22:33:44:55:66 | Synology |

*2 devices found*
```

**JSON (--json):**
```json
{
  "network": "Home Network",
  "cidr": "192.168.1.0/24",
  "devices": [
    {
      "ip": "192.168.1.1",
      "hostname": "router.local",
      "mac": "AA:BB:CC:DD:EE:FF",
      "vendor": "Ubiquiti"
    }
  ],
  "scanned_at": "2026-01-28T00:10:00",
  "device_count": 2
}
```

## Use Cases

- **Device inventory**: Keep track of all devices on your network
- **Security audits**: Identify unknown devices
- **Documentation**: Generate network maps for documentation
- **Automation**: Integrate with home automation to detect device presence

## Tips

- Use `sudo` for accurate MAC address detection (nmap needs privileges for ARP)
- Configure your local DNS server for better hostname resolution
- Add configured networks to skip route verification on every scan
- Add networks you can't reach privately to the blocklist to prevent accidents
- Extend `MAC_VENDORS` in the script for better device identification

Popular in IT Ops & Security

钟馗.skillIT Ops & Security

钟馗.Skill——会更新漏洞库的安全审查专家。直来直去、快刀斩乱麻,三层审查(静态审计/行为模拟/供应链溯源)覆盖12类风险,输出结构化安全裁定(✅干净/⚠️可疑/🚫恶意)。Use when 用户说"审查这个Skill"、"安全检查"、"钟馗看下"、"审一下"、"查一下这个skill"、安装Skill前的安全评估、或需要审计SKILL.md的恶意载荷。

↓ 336.9K★ 17user_741dc82b
SkillScanIT Ops & Security

Scans skill packages for risk before use and gates installation on the verdict.

↓ 183.2K★ 41tokauthai
Free Ride - Unlimited free AIIT Ops & Security

A tool that configures free OpenRouter models and a fallback chain for OpenClaw.

↓ 134.1K★ 492Shaishav Pidadi
a ca s ca s c ca s cIT Ops & Security

Parse, search, and analyze application logs across formats. Use when debugging from log files, setting up structured logging, analyzing error patterns, correlating events across services, parsing stack traces, or monitoring log output in real time.

↓ 124.9K★ -user_60e896a0
Skill ScannerIT Ops & Security

Security checks for installing skills, packages, or plugins. Use BEFORE any npm install, openclaw plugins install, clawhub install, or similar install...

↓ 93.2K★ 4sudhindrat
网安技能IT Ops & Security

网络安全与SRC漏洞掘金实战技能。融合「系统学习路径」与「SRC实战掘金」双模式: ①学习模式=法律→基础→工具→靶场→攻防→就业全流程; ②实战模式=直接指导在腾讯TSRC、阿里ASRC、百度BSRC等平台挖掘高价值漏洞变现。 当用户提出以下问题时触发: "我想学网络安全怎么入门""SRC漏洞怎么挖能赚钱""渗透测试需要学什么" "Web安全漏洞原理是什么""怎么准备CTF比赛""护网面试会问什么" "云安全怎么学""挖漏洞赚钱的方法""端口扫描脚本怎么写" "SQL注入怎么检测""子域名怎么枚举""XSS漏洞怎么找" "靶场怎么搭建""Kali Linux怎么用""Metasploit怎么入门" "等保测评是什么""代码审计怎么做""内网渗透怎么学" "信息泄露漏洞怎么挖""越权漏洞怎么测试""逻辑漏洞挖掘技巧" "简历怎么写才能进安全公司""安全行业面试题有哪些" "Burp Suite怎么用""DVWA怎么安装""Pikachu靶场搭建" "Vulhub漏洞复现""网络安全法有什么规定""CTF夺旗赛怎么参加" "AWD比赛是什么""应急响应怎么做""攻击溯源怎么搞" "数据安全怎么保障""公有云安全怎么防护""私有云攻防怎么做" "云原生安全是什么"。

↓ 80.5K★ 16user_d2cc4baf
人人都能成为黑客v2.0(Lvan)IT Ops & Security

Unified Web penetration testing and SRC vulnerability hunting Skill. Model-driven threat modeling (12 dimensions), JSON 字段规范 state persistence, SRC/补天 compliant reporting with confirmed gate (3-layer determination). Use when user asks for authorized penetration testing, vulnerability assessment, SRC hunting (补天/Butian/vendor SRC/CNVD/众测), bug bounty, security evaluation with explicit target URL, or wants operational Recon→PoC→Report workflow. Do NOT use for CTF challenges, unauthorized testing, mobile app testing, infrastructure scanning, or social engineering.

↓ 56.8K★ 37user_a730098d
skill-vetterIT Ops & Security

Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.

↓ 54.0K★ -user_814dbe54

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.