{"id":13609712,"url":"https://github.com/Wyko/netcrawl","last_synced_at":"2025-04-12T20:32:18.921Z","repository":{"id":180442492,"uuid":"80079697","full_name":"Wyko/netcrawl","owner":"Wyko","description":"Netcrawl is a tool designed to discover and poll one or more devices, inventory them, and then provide useful data on the processed devices.","archived":true,"fork":false,"pushed_at":"2017-03-29T17:26:18.000Z","size":5661,"stargazers_count":54,"open_issues_count":9,"forks_count":10,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-11-07T15:46:21.154Z","etag":null,"topics":["cdp","cisco","netmiko"],"latest_commit_sha":null,"homepage":"http://netcrawl.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Wyko.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2017-01-26T02:34:42.000Z","updated_at":"2024-06-15T11:56:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"33f30574-b234-4920-810b-fb5bb710c8da","html_url":"https://github.com/Wyko/netcrawl","commit_stats":null,"previous_names":["wyko/netcrawl"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wyko%2Fnetcrawl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wyko%2Fnetcrawl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wyko%2Fnetcrawl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wyko%2Fnetcrawl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wyko","download_url":"https://codeload.github.com/Wyko/netcrawl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248629942,"owners_count":21136347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cdp","cisco","netmiko"],"created_at":"2024-08-01T19:01:37.305Z","updated_at":"2025-04-12T20:32:15.945Z","avatar_url":"https://github.com/Wyko.png","language":"Python","funding_links":[],"categories":["others"],"sub_categories":[],"readme":"|Build Status| |Coverage Status| |Documentation Status|\r\n\r\n========\r\nNetCrawl\r\n========\r\n---------------------------------------\r\nNetwork Information Gathering Made Easy\r\n---------------------------------------\r\n\r\n\r\nNetcrawl is a tool designed to discover and poll one or more devices,\r\ninventory them, and then provide useful data on the processed devices.\r\n\r\n*This package is still in development.*\r\n\r\n\r\nFeatures\r\n--------\r\n\r\n-  **Switchport Tracing**: Discover which devices and interfaces have seen a\r\n   particular MAC\r\n-  **Wireless Audit**: Discovers likely matches for rogue wireless devices\r\n   among physically connected devices on a subnet\r\n-  **MAC Audit**: Discover potential unauthorized switches on your network\r\n-  SSH and Telnet connections to network devices\r\n-  Automatically backs up device configurations\r\n-  Stores a neighbor database to find layer two connection mappings\r\n-  Auto-detect system type of newly discovered devices\r\n-  Works with Nmap to allow for discovery of both neighboring and\r\n   seperated devices\r\n-  Securely stores credentials using `keyring`_ and `cryptography`_\r\n-  Can use multiple credentials in case the first fails\r\n-  Stores device inventory using a PostgreSQL database\r\n-  Offers a single device scan to quickly get data on one device\r\n-  Concurrently runs multiple subprocesses to quickly scan devices\r\n-  Multiple ``netcrawl`` top-level processes can run concurrently to\r\n   scan different network segments (do not use ``-c`` while doing this),\r\n   or to run an Nmap scan and inventory hosts as they are discovered.\r\n\r\nExample\r\n--------\r\n\r\n\r\nScan one host with no logging output\r\n+++++++++++++++++++++++++++++++++++++\r\n\r\n.. code-block:: console\r\n\r\n    C:\\netcrawl\u003erun.py -sS -t 10.1.120.1 -v0\r\n\r\n    Device Name:       my-device-dist-1\r\n    Unique Name:       MY-DEVICE-DIST-1_EC032\r\n    Management IP:     10.1.120.1\r\n    First Serial:      Name: [Switch System], Desc: [WS-C4500X-32], Serialnum: [JAE14350G30]\r\n    Serial Count:      28\r\n    Dynamic MAC Count: 920\r\n    Interface Count:   88\r\n    Neighbor Count:    22\r\n    Config Size:       26573\r\n\r\n    +---------------------------+------------------------+----------------------+-------------+\r\n    | Neighbor Name             | Source Interface       | Platform             | IP Address  |\r\n    +---------------------------+------------------------+----------------------+-------------+\r\n    | DVCOPS-MIS-1              | TenGigabitEthernet1/1  | cisco WS-C3750-48P   | 10.1.220.11 |\r\n    | DVCOPS-MIS-2              | TenGigabitEthernet1/2  | cisco WS-C3750-48P   | 10.1.220.10 |\r\n    | DVCOPS-sceast-sc01        | TenGigabitEthernet1/3  | cisco WS-C3850-48P   | 10.1.139.12 |\r\n    | DVCOPS-sccent-sc01        | TenGigabitEthernet1/4  | cisco WS-C3850-48P   | 10.1.139.11 |\r\n    | DVCOPS-dcgsc-sc01         | TenGigabitEthernet1/16 | cisco WS-C3850-48P   | 10.1.139.26 |\r\n    | DVCOPS-wlcprm-vd01        | TenGigabitEthernet1/17 | AIR-CT5520-K9        | 10.1.139.51 |\r\n    +---------------------------+------------------------+----------------------+-------------+\r\n\r\n\r\nLocate a device on the network\r\n+++++++++++++++++++++++++++++++    \r\n \r\n.. code-block:: console\r\n \r\n    C:\\netcrawl\u003elocate_mac.py 00FEC89232B0\r\n\r\n    MAC:  00FEC89232B0\r\n    Manufacturer:  Cisco ,  Cisco Systems, Inc\r\n    +-----------------------+---------------------+-----------------------+\r\n    | Device Name           | Interface           | CDP Neighbors         |\r\n    +-----------------------+---------------------+-----------------------+\r\n    | DVCOPSDS01            | Ethernet2/24        | DVCOPSMGT1            |\r\n    | DVCOPSMGT1            | GigabitEthernet0/23 | None                  |\r\n    | DVCOPS-mgmt-sd01      | FastEthernet1/0/39  | DVCOPSDS01            |\r\n    +-----------------------+---------------------+-----------------------+\r\n    \r\n    \r\nBuilt With\r\n-----------\r\n\r\n* Netmiko_ - SSH and Telnet connection manager\r\n* Manuf_ - OUI lookup\r\n\r\n\r\nAuthors\r\n--------\r\n\r\n* **Wyko ter Haar** - *Initial work* - Wyko_\r\n   \r\n   \r\n.. _Wyko: https://github.com/Wyko   \r\n.. _Manuf: https://github.com/coolbho3k/manuf\r\n.. _Netmiko: https://github.com/ktbyers/netmiko\r\n.. _keyring: https://pypi.python.org/pypi/keyring\r\n.. _cryptography: https://cryptography.io\r\n\r\n.. |Build Status| image:: https://travis-ci.org/Wyko/netcrawl.svg?branch=master\r\n   :target: https://travis-ci.org/Wyko/netcrawl\r\n.. |Coverage Status| image:: https://coveralls.io/repos/github/Wyko/netcrawl/badge.svg?branch=master\r\n   :target: https://coveralls.io/github/Wyko/netcrawl?branch=master\r\n.. |Documentation Status| image:: https://readthedocs.org/projects/netcrawl/badge/?version=latest\r\n   :target: http://netcrawl.readthedocs.io/en/latest/?badge=latest    \r\n    \r\n\r\n   \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWyko%2Fnetcrawl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWyko%2Fnetcrawl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWyko%2Fnetcrawl/lists"}