Skip to content

README.md

Latest commit

 

History

History
43 lines (30 loc) · 1.24 KB

README.md

File metadata and controls

43 lines (30 loc) · 1.24 KB

Python Vulnerability Scanner

Simple Network Vulnerability Scanner using Nmap + Python.

Tool that performs network discovery, port scanning, service version detection, and generates security reports. Ideal for learning offensive/defensive security and portfolio projects.

🎯 Objective

Demonstrate practical skills in network scanning, vulnerability identification, and reporting — core competencies for Penetration Tester, SOC Analyst, and Security Engineer roles.

✨ Key Features

  • Host discovery
  • Port scanning (top 1000 ports)
  • Service and version detection
  • Basic vulnerability checking (using Nmap scripts)
  • Professional HTML and TXT reports
  • Easy to extend

🛠️ Technologies

  • Python 3
  • python-nmap
  • Nmap (must be installed on system)
  • HTML report generation

🚀 Prerequisites

  • Install Nmap on your system

How to Use

git clone https://github.com/L-Esquivel/python-vulnerability-scanner.git
cd python-vulnerability-scanner

pip install -r requirements.txt

# Basic scan
python main.py --target 192.168.1.1

# Full scan with report
python main.py --target 192.168.1.0/24 --report html


---
This repository is part of a specialized portfolio in Cybersecurity and IT Security.