seed IP

Map Connected Devices

Discover network topology via CDP and generate visual diagrams.

Description

Starts from a seed device, crawls CDP neighbors recursively, and produces network topology diagrams and reports. It generates both Layer 2 and Layer 3 topology diagrams in draw.io format, along with a JSON representation and an Excel report of all discovered devices and their connections.

Input

This tool requires:

  • •devices.csv file with columns: host, device_type
  • •SSH credentials (username and password prompted at runtime)
  • •Output folder name (prompted at runtime)

Usage

Run the toolkit and select option [5] from the menu:

Terminal 
docker compose run network_automation

Output

Results are saved to:

outputs/map_connected_devices/_/

Each run produces:

  • •CSV files - One per device
  • •JSON files - Raw parsed output from each device
  • •Excel summary report - Consolidated data across all devices

Standalone Usage

To run this tool directly without the run.py menu:

Terminal 
cd tools/map_connected_devices && python scripts/discover.py 192.168.1.1
← Back to All Tools