Skip to content
TakoAPI
Back to skills

ntopng-admin

by transcendenceia

Coding Agents & IDEs
—Not yet rated
Your rating

Brief

Professional network monitoring and device identification using ntopng Redis data.

Description

What This Skill Does

Queries ntopng network monitoring data from Redis via a secure SSH tunnel to provide device identification, traffic analysis, and connection auditing. Targets lab, test, and controlled audit environments where elevated access to network gateway data is authorized.

Reads live ntopng data directly from Redis over SSH without requiring an active web UI session, making queries scriptable and fully auditable.

When to Use It

  • Identify unknown devices on a local network by MAC and IP
  • Audit external domains contacted by a specific device
  • Flag devices with abnormal upload-to-download traffic ratios
  • Verify ntopng service health and global device counts
  • Investigate suspicious MAC addresses for spoofing indicators

Example Workflow

INPUT

User asks: List all devices on the network with their traffic volumes

AGENT
  1. 1

    Establishes SSH tunnel to the configured OPNSENSE_HOST

  2. 2

    Runs ntopng-helper.sh list against the remote Redis instance

  3. 3

    Parses output with jq to extract MAC, IP, traffic, and last-seen fields

  4. 4

    Returns a formatted device inventory table

OUTPUT

A list of network devices showing MAC address, IP, total traffic volume, and last-seen timestamp for each

Requirements

  • OPNSENSE_HOST environment variable (target gateway IP or hostname)
  • OPNSENSE_SSH_PORT environment variable (SSH port on target)
  • NTOP_INSECURE environment variable (set to true for self-signed certificates)
  • SSH public key authentication configured to the OPNsense/ntopng host
  • ntopng running with Redis persistence enabled on the target host

Installation

clawhub install transcendenceia/ntopng-admin

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links