mcpField
W
wsdiscovery

wsdiscovery

github.com/brownfinesecurity安全87546 次安装21 周前更新
代码仓库

关于 wsdiscovery

wsdiscovery 使用 WS-Discovery 协议发现网络设备，常用于查找 ONVIF 摄像机、NVR 和其他物联网设备。它可呈现设备标识、厂商、型号及服务端点等信息。

主要功能

  1. 01通过 WS-Discovery 发现设备
  2. 02显示地址、端口和设备类型
  3. 03提取厂商、型号及固件信息
  4. 04查看服务端点和元数据
  5. 05支持文本、JSON 和精简输出

适用场景

  1. 01发现网络中的 ONVIF 摄像机
  2. 02枚举支持 WS-Discovery 的设备
  3. 03查看设备服务端点以便后续测试

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/brownfinesecurity/iothackbot --skill wsdiscovery

安装后在 Claude Code 中输入/wsdiscovery确认已加载。

详细介绍

Wsdiscovery - WS-Discovery 协议扫描器

使用 wsdiscovery 工具，帮助用户通过 WS-Discovery 协议发现和枚举设备（该协议常用于 ONVIF 摄像头和 IoT 设备）。

工具概览

Wsdiscovery 实现了 WS-Discovery 协议，可发现支持此标准的网络设备。它特别适合查找通过 WS-Discovery 播发自身信息的 ONVIF 摄像头、网络视频录像机（NVR）和其他 IoT 设备。

说明

当用户要求发现 ONVIF 设备、查找网络摄像头或扫描 WS-Discovery 设备时：

  1. 了解目标：

    • 询问目标主机名或 IP 地址
    • 确认用户是否需要详细输出（完整 XML 响应）
    • 确定输出格式

  2. 执行扫描：

    • 使用 iothackbot bin 目录中的 wsdiscovery 命令
    • 基本用法：wsdiscovery <hostname_or_ip>
    • 详细输出：wsdiscovery <hostname_or_ip> -v
    • JSON 输出：wsdiscovery <hostname_or_ip> --format json

  3. 输出格式：

    • --format text（默认）：以彩色输出呈现易读的设备详情
    • --format json：机器可读的 JSON
    • --format quiet：最简输出

可发现的信息

该工具会提取并显示：

  • IP 地址和端口
  • 端点引用（设备 UUID）
  • 设备类型
  • 制造商信息
  • 设备名称和型号
  • 硬件版本
  • 序列号
  • 固件版本
  • 位置信息
  • 服务端点（XAddrs）——设备管理 URL
  • 元数据版本

示例

发现特定主机上的设备：

wsdiscovery 192.168.1.100

查看包含完整 XML 响应的发现结果：

wsdiscovery 192.168.1.100 -v

以 JSON 格式输出设备信息：

wsdiscovery 192.168.1.100 --format json

扫描网络广播地址以查找所有设备：

wsdiscovery 239.255.255.250

重要说明

  • WS-Discovery 使用多播／广播发现机制
  • 设备必须支持 WS-Discovery 协议才能被发现
  • 常见于 ONVIF 摄像头、打印机和网络媒体设备
  • 服务端点（XAddrs）可与 onvifscan 搭配使用，以进行进一步测试
  • 如果可用，该工具会解析 ONVIF 特定的范围信息

评论

支持 Markdown