Skip to content

Cyber-Security-Tech/simple-vuln-matcher

Repository files navigation

🔍 Simple Vulnerability Matcher

Simple Vulnerability Matcher is a cybersecurity tool that scans installed software on a Windows machine, checks for known vulnerabilities using the NVD (National Vulnerability Database) API, and generates detailed reports in CSV, JSON, and PDF formats.


🚀 Features

Scans Installed Software – Detects software vulnerabilities from the NVD database.
Generates Reports – Creates reports in CSV, JSON, and PDF formats.
Schedule Scans – Allows users to set up daily automated scans with email report delivery.
SQL Injection Protection – Secure input handling to prevent SQL injection attacks.
User-Friendly UIWeb-based interface for running scans and downloading reports.


🛠️ Installation & Setup

1️⃣ Clone the Repository

git clone https://github.com/Cyber-Security-Tech/simple-vuln-matcher.git
cd simple-vuln-matcher

2️⃣ Install Dependencies

Ensure you have Python 3.8+ installed, then run:

pip install -r requirements.txt

3️⃣ Add Your API Key

You need an NVD API key. Open nvd_api.py and replace:

API_KEY = "your-api-key-here"

with your actual NVD API key.

4️⃣ Run the Application

python app.py

Then, open http://127.0.0.1:5000/ in your browser.


📂 Reports & Output

Once a scan completes, reports will be available for download:

📄 CSV Report/download/csv
📜 JSON Report/download/json
📑 PDF Report/download/pdf

📧 If you schedule a scan, reports will be emailed to you.


💡 Why This Project? (For Recruiters)

This project was built to demonstrate hands-on cybersecurity skills, including:

API integration with the NVD vulnerability database
Secure input handling to prevent SQL injection
Flask-based web UI for ease of use
Automated scanning & report generation

It showcases my ability to write secure Python code, work with APIs, and implement cybersecurity best practices.


🤝 Contributing

Want to improve this project? Feel free to fork & contribute!
If you have suggestions, open an issue or pull request.


📜 License

This project is open-source and licensed under the MIT License.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published