pyats-topology

Discover multi-vendor network topology from CDP/LLDP, ARP, and routing peer data.

Updated Feb 28, 2026

Search Tags:#automation #cdp #topology #network-discovery #pyats #netbox #lldp

Ready to run

npx skills add https://github.com/dgethings/netclaw --skill pyats-topology-dgethings

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: pyats-topology
Source: https://github.com/dgethings/netclaw/tree/main/workspace/skills/pyats-topology
Command: npx skills add https://github.com/dgethings/netclaw --skill pyats-topology-dgethings

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically aggregates CDP/LLDP neighbor data, ARP tables, and routing peers to build an accurate network topology map, enabling fast visualization and documentation of device connections.

Core Features & Use Cases

CDP/LLDP neighbor discovery across multi-vendor devices
ARP-based interface mapping and adjacency data
Topology modeling with VRF, routing peers, and FHRP context
Diagram-ready outputs and NetBox reconciliation for source-of-truth alignment

Quick Start

Run the topology discovery workflow across your devices to generate a unified topology model.

Frequently Asked Questions about pyats-topology

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automatically discover and map network topology across multi-vendor devices?▼

Automatically discover network topology by collecting CDP and LLDP neighbor data, ARP tables, and routing peers to build a comprehensive adjacency map of multi-vendor device connections. This creates a unified topology model for visualization and documentation tasks.

What is the best way to build a network topology model that includes VRF and routing peer context?▼

Build a network topology model with VRF, routing peer, and FHRP context by aggregating CDP/LLDP neighbor discovery and ARP data. This approach captures logical routing structures alongside physical adjacencies to provide a complete representation of network links.

Can I use pyats to collect CDP and LLDP data for network topology visualization?▼

Yes, you can use pyats to collect CDP and LLDP data for topology visualization. It requires an MCP script environment and a defined testbed path to gather neighbor information and generate diagram-ready representations of your network links.

How do I generate diagram-ready network topology outputs from ARP and routing peer data?▼

Generate diagram-ready topology outputs by aggregating ARP-based interface mappings and routing peers into a structured topology model. This process transforms raw discovery data into adjacency maps suitable for documentation and visualization.

Does network topology discovery support reconciliation with NetBox as a source of truth?▼

Yes, network topology discovery supports NetBox reconciliation for source-of-truth alignment. It compares discovered CDP/LLDP and ARP adjacency data against existing NetBox records to ensure your documentation accurately reflects the live network state.