{"id":26241336,"url":"https://github.com/tomaston1996/net-scanner","last_synced_at":"2025-09-21T18:47:40.310Z","repository":{"id":260265498,"uuid":"878633669","full_name":"TomAston1996/net-scanner","owner":"TomAston1996","description":"A network vulnerability scanner to improve cybersecurity engineer workflow | NMAP | National Vulnerability Database","archived":false,"fork":false,"pushed_at":"2024-11-01T16:45:55.000Z","size":65,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-13T08:21:34.351Z","etag":null,"topics":["cybersecurity","nmap"],"latest_commit_sha":null,"homepage":"","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/TomAston1996.png","metadata":{"files":{"readme":"README.md","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,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-10-25T18:52:13.000Z","updated_at":"2025-02-26T22:08:02.000Z","dependencies_parsed_at":"2025-09-21T18:47:39.813Z","dependency_job_id":null,"html_url":"https://github.com/TomAston1996/net-scanner","commit_stats":null,"previous_names":["tomaston1996/net-scanner"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TomAston1996/net-scanner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TomAston1996%2Fnet-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TomAston1996%2Fnet-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TomAston1996%2Fnet-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TomAston1996%2Fnet-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TomAston1996","download_url":"https://codeload.github.com/TomAston1996/net-scanner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TomAston1996%2Fnet-scanner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276288756,"owners_count":25616950,"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","status":"online","status_checked_at":"2025-09-21T02:00:07.055Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cybersecurity","nmap"],"created_at":"2025-03-13T08:20:16.304Z","updated_at":"2025-09-21T18:47:40.284Z","avatar_url":"https://github.com/TomAston1996.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n[![LinkedIn][linkedin-shield]][linkedin-url]\n\n# 🤖 NetScanner\n\nThe goal of NetScanner is to create an all-in-one CLI tool for exploring network vulnerabilities. The tool utilises NMAP along with the National Vulnerability Database (NVD) API to \nconduct a series of vulnerability tests to help automate Cybersecurity Engineer workflow.\n\n![cli](./images/cli.png)\n\nFunctionality includes host discovery, port scanning, os detection, and a software vulnerability assessment. An automated report for the network will be produced as a result. See ⚙️ Features section below.\n\n\n## 🧑‍💻 Tech Stack\n\n![Python] ![Pandas]\n\n## ⚙️ Features\n\n### Active Host Discovery\nFind active hosts on the network, with the help of NMAP under the hood, by specifying the port range to scan when prompted in the CLI.\n\nExample port range syntax:\n\n```192.168.1.1/24``` specifies a scan of all ports between 192.168.1.1 and 192.168.1.254 (corresponding to a subnet mast of 255.255.255.0)\n\n```192.168.1.1``` specifies a scan of a single port i.e. 192.168.1.1\n\n### CPE Matching\n\nFind official CPE (Common Platform Enumeration) names and matches on the NVD (National Vulnerabiluity) database based on CPE's identified in the host scan.\n\nCurrent CPE naming version is CPE 2.3\n\n```cpe:\u003ccpe_version\u003e:\u003cpart\u003e:\u003cvendor\u003e:\u003cproduct\u003e:\u003cversion\u003e:\u003cupdate\u003e:\u003cedition\u003e:\u003clanguage\u003e:\u003csw_edition\u003e:\u003ctarget_sw\u003e:\u003ctarget_hw\u003e:\u003cother\u003e```\n\n### CVE Finder\n\nFind CVEs (Common Vulnerabilities and Exposures) from the NVD (National Vulnerabiluity) database based on CPE names identified in the host scan.\n\n### Automated Reporting\n\nAn optional automated CSV report is generated for the user on cleation of a host and vulnerability scan. The intent is to improve Cybersecuirty Engineer workflow by automating\nrepetitive vulnerability assessments on LANs or a group of IPs.\n\n## 🔧 Setup\n\n### Dependencies\n``` pip install -r requirements.txt``` will install all dependcies required\n\n### API Key\nRequest an API Key from https://nvd.nist.gov/developers/request-an-api-key and place it in your ```.env``` file as 'NVD_API_KEY'\n\n### Run Locally\n``` python ./main.py``` will run the CLI tool locally\n\n## 🧑‍🤝‍🧑 Developers \n\n| Name           | Email                      |\n| -------------- | -------------------------- |\n| Tom Aston      | mailto:mail@tomaston.dev     |\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/TomAston1996/net-scanner.svg?style=for-the-badge\n[contributors-url]: https://github.com/TomAston1996/net-scanner/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/TomAston1996/net-scanner.svg?style=for-the-badge\n[forks-url]: https://github.com/TomAston1996/net-scanner/network/members\n[stars-shield]: https://img.shields.io/github/stars/TomAston1996/net-scanner.svg?style=for-the-badge\n[stars-url]: https://github.com/TomAston1996/net-scanner/stargazers\n[issues-shield]: https://img.shields.io/github/issues/TomAston1996/net-scanner.svg?style=for-the-badge\n[issues-url]: https://github.com/TomAston1996/net-scanner/issues\n[license-shield]: https://img.shields.io/github/license/TomAston1996/net-scanner.svg?style=for-the-badge\n[license-url]: https://github.com/TomAston1996/net-scanner/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/tomaston96\n[React.js]: https://img.shields.io/badge/React-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB\n[React-url]: https://reactjs.org/\n[TypeScript]: https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge\u0026logo=typescript\u0026logoColor=white\n[Redux]: https://img.shields.io/badge/redux-%23593d88.svg?style=for-the-badge\u0026logo=redux\u0026logoColor=white\n[Chart.js]: https://img.shields.io/badge/chart.js-F5788D.svg?style=for-the-badge\u0026logo=chart.js\u0026logoColor=white\n[Bootstrap]: https://img.shields.io/badge/bootstrap-%238511FA.svg?style=for-the-badge\u0026logo=bootstrap\u0026logoColor=white\n[NodeJS]: https://img.shields.io/badge/node.js-6DA55F?style=for-the-badge\u0026logo=node.js\u0026logoColor=white\n[Python]: https://img.shields.io/badge/python-3670A0?style=for-the-badge\u0026logo=python\u0026logoColor=ffdd54\n[Pandas]: https://img.shields.io/badge/pandas-%23150458.svg?style=for-the-badge\u0026logo=pandas\u0026logoColor=white\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomaston1996%2Fnet-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomaston1996%2Fnet-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomaston1996%2Fnet-scanner/lists"}