Web Application Fingerprinting & AI Risk Assessment Tool

A modular Python Command Line Interface (CLI) tool designed to scan a website's technology stack using the BuiltWith API, perform a security risk analysis using a local Ollama LLM, and export a styled report to Microsoft Excel.

🚀 Features

• Tech Stack Discovery: Identifies frameworks, CMS, analytics tools, and servers via BuiltWith API.
• AI Security Analyst: Uses a local LLM (via Ollama) to assess security risks, EOL software versions, and configuration vulnerabilities.
• Structured Excel Export: Aggregates findings and generates a professionally formatted spreadsheet with a Dark Steel Blue theme.
• Resilient Mock Mode: Works automatically out-of-the-box even without a configured BuiltWith API key or active Ollama instance.

🗂️ Project Structure

• main.py - Unified CLI script entry point.
• builtwith_scanner.py - Interacts with BuiltWith API and handles data extraction.
• ollama_analyzer.py - Sends parsed data to local Ollama instance for risk analysis.
• excel_exporter.py - Formats and saves the data into an Excel spreadsheet.
• config.py - Configuration settings.
• .env - (Not tracked in Git) Stores your secret BuiltWith API credentials.

🔧 Installation & Setup

1. Clone the repository:

   git clone <your-repository-url>
   cd web_fingerprint_tool
   

2. Create and activate a virtual environment python -m venv web_fingerprint_env

   On Windows (cmd):

   .\web_fingerprint_env\Scripts\activate
3. Install dependencies: pip install requests pandas openpyxl ollama python-dotenv
4. Configure your API Key: Create a .env file in the root directory: BUILTWITH_API_KEY=your_builtwith_api_key
5. (Optional) Run local Ollama: Make sure Ollama is installed and running with your chosen model (default is tinyllama): ollama run tinyllama

💻 Usage

Run the tool using the unified command line:
# Print results to console only
python main.py example.com

Print results to console and export to a styled Excel report

python main.py example.com --excel