netgear-switch-inventory

Inventory and monitoring for Netgear Easy Smart switches via HTTP scraping.

No SNMP, no official API — the package reverse-engineers the proprietary web UI used by Netgear ProSAFE Easy Smart switches (GS116Ev2, GS108Ev3 and compatible).

Device support

* GS108Ev3 serves port state via AJAX (/getstatus.cgi). This endpoint is not yet implemented. ports returns [] for GS108Ev3. All other data (identity, features) works correctly.

Install

pip install netgear-switch-inventory
# with CLI
pip install "netgear-switch-inventory[cli]"

Or with uv:

uv add netgear-switch-inventory
uv add "netgear-switch-inventory[cli]"

Configuration

Credentials are passed directly or via environment variables. Create a .env file (never commit it):

NETGEAR_HOST="192.168.1.100"
NETGEAR_PASSWORD="password"

CLI usage

# Collect and print inventory from a switch
netgear-inventory collect --host 192.168.1.100

# Collect and save to YAML file
netgear-inventory fetch --host 192.168.1.100 --output ./inventory/

# Discover switches on the LAN via NSDP broadcast
netgear-discover

Run --help on any command for all options.

Library usage

from netgear_switch.session import SwitchSession
from netgear_switch.models import load_catalog
from netgear_switch.inventory import snapshot, persist
from pathlib import Path

catalog = load_catalog()  # ships with package

sw = SwitchSession("192.168.1.100", "password")
sw.login()
snap = snapshot(sw, catalog)

print(snap.model, snap.firmware, snap.firmware_status)
print(f"{len(snap.ports_up)} ports up")

persist(snap, Path("inventory/"))

NSDP discovery

from netgear_switch.nsdp import probe

for switch in probe(timeout=3.0):
    print(switch.get("model"), switch.get("ip"), switch.get("_from"))

Requires the process to bind to UDP 63321. On Linux, use --network host in Docker or run as root/with CAP_NET_BIND_SERVICE.

Salt grains

Copy src/netgear_switch/contrib/salt_grains.py to your Salt _grains/ directory as netgear_switch.py, then configure the minion:

# /etc/salt/minion.d/netgear_switch.conf
netgear_switch:
  host: "192.168.1.100"
  password: "password"
  catalog_path: "/etc/salt/netgear/device_catalog.yaml"  # optional
  timeout: 10

Verify:

salt-call --local grains.item switch

The grains module returns switch identity and feature flags under the switch key, mirroring Salt built-in grain names where applicable (manufacturer, productname, serialnumber, osrelease).

Known limitations

• GS108Ev3 port status: not implemented — AJAX endpoint not yet reverse-engineered. ports is always [] for this model.
• Write operations: the package never calls any mutating web UI endpoint.
• HTTPS: Netgear Easy Smart switches do not support HTTPS. All communication is HTTP.
• Multi-switch: the CLI and library operate on one switch at a time. Iterate from a wrapper script for fleet inventory.

License

Apache License 2.0 — see LICENSE.