π VulnScan AI - AI-Powered Vulnerability Scanner
The developer's best friend for pre-production security testing π
A lightweight, AI-powered vulnerability scanner that helps developers identify security issues before pushing to production. Perfect for CI/CD pipelines, local development, and quick security assessments.
β¨ Why VulnScan AI?
- π€ AI-Powered: Intelligent risk assessment and actionable recommendations
- β‘ Lightning Fast: Parallel scanning with configurable batch sizes
- π― Developer-Focused: Simple CLI, clear output, easy integration
- π Comprehensive: Technology stack analysis, API security, vulnerability detection
- π¦ Easy Install: One command installation via pip
- π° Free & Open Source: No licensing fees, full transparency
π Quick Start
Install from PyPI
pip install vulnscan-ai
Development Installation
# Clone the repository
git clone https://github.com/zeemscript/vulnscanner.git
cd vulnscanner
# Install in development mode
make install-dev
# Run tests
make test
# Run example scan
make scan-example
Basic Usage
# Scan a website
vulnscan example.com
# Scan with specific options
vulnscan example.com --scan-types web ssl --output html
# High-performance scanning
vulnscan example.com --threads 20 --batch-size 50
# Interactive mode with guided scanning
vulnscan --interactive
π― Essential Commands
# Basic security scan
vulnscan yourwebsite.com
# Pre-production check
vulnscan localhost:3000 --scan-types web --timeout 30
# API security focus
vulnscan api.yoursite.com --scan-types web --batch-size 50
# Custom output
vulnscan yoursite.com --output json --output-file security_report
# Help
vulnscan --help
π What It Checks
Technology Stack Analysis
- Frontend: React.js, Angular, Vue.js, Next.js, jQuery, Bootstrap
- Backend: Node.js, Python, PHP, Java, .NET frameworks
- CMS: WordPress, Drupal, Joomla with version-specific vulnerabilities
- Analytics: Google Analytics, Facebook Pixel, tracking services
Security Vulnerabilities
- Injection Attacks: XSS, CSRF, SQL injection vectors
- Security Headers: CSP, HSTS, X-Frame-Options, and more
- Information Disclosure: Server info, error handling, sensitive files
- Outdated Software: Technologies with known security issues
API Security
- Authentication: Public vs protected endpoint detection
- CORS: Dangerous wildcard origins and misconfigurations
- Rate Limiting: Missing protection headers
- Sensitive Endpoints: Admin, auth, config, debug APIs
π Sample Output
π οΈ TECHNOLOGY STACK ANALYSIS
Frontend Technologies:
β’ React.js v16.8.0 [HIGH] (OUTDATED)
β’ jQuery v3.4.1 [MEDIUM] (OUTDATED)
Technology Security Summary:
β’ High Risk Technologies: 1
β’ Medium Risk Technologies: 1
β’ Low Risk Technologies: 0
β’ Outdated Technologies: 2
HIGH FINDINGS:
ββββββββββββββββββββββββββ¬ββββββββββββ¬βββββββββββ¬βββββββββββββββββββββββββββββ
β Target β Scan Type β Category β Finding β
ββββββββββββββββββββββββββΌββββββββββββΌβββββββββββΌβββββββββββββββββββββββββββββ€
β example.com β web β csrf β Form without CSRF protectionβ
ββββββββββββββββββββββββββ΄ββββββββββββ΄βββββββββββ΄βββββββββββββββββββββββββββββ
π€ AI-POWERED ANALYSIS
Risk Level: High
Risk Score: 67/100
π§ TOP RECOMMENDATIONS:
1. Update React.js from v16.8.0 to latest version
2. Implement rate limiting on API endpoints
3. Fix CORS configuration for production
4. Add Content Security Policy headers
5. Update jQuery to latest version
π οΈ Installation Options
Option 1: PyPI (Recommended)
pip install vulnscan-ai
Option 2: From Source
# Clone repository
git clone https://github.com/zeemscript/vulnscanner.git
cd vulnscanner
# Install in development mode
pip install -e .
Prerequisites
- Python 3.8+
- nmap (for port scanning) -
brew install nmap or sudo apt install nmap
- nikto (for web server scanning) -
brew install nikto or sudo apt install nikto
π§ Advanced Usage
# High-performance scanning
vulnscan yoursite.com --threads 20 --batch-size 50
# Specific scan types
vulnscan yoursite.com --scan-types web ssl
# Custom output formats
vulnscan yoursite.com --output html --output-file report
# CI/CD integration
vulnscan $TARGET_URL --output json --no-save | jq '.risk_score'
# Full command options
vulnscan --help
π Performance
- Lightweight: Minimal dependencies, fast startup
- Fast: Parallel scanning with configurable batch sizes
- Efficient: Smart caching and minimal resource usage
- Scalable: Handles everything from localhost to enterprise sites
π― Perfect For
- π¨βπ» Developers: Pre-production security checks
- π§ DevOps: CI/CD pipeline integration
- π‘οΈ Security Teams: Quick vulnerability assessments
- π Startups: Affordable security testing
- π Students: Learning web security concepts
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π Acknowledgments
- Built with Python, asyncio, and aiohttp for high performance
- AI-powered analysis using machine learning techniques
- Inspired by the need for developer-friendly security tools
π Documentation
Ready to secure your web applications? Start with vulnscan yoursite.com and see the magic happen! β¨