# darkshell809/vuln-scanner-pro architecture

> Architecture diagram of the GitHub repository darkshell809/vuln-scanner-pro, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/darkshell809/vuln-scanner-pro
- Repository: https://github.com/darkshell809/vuln-scanner-pro

## Overview

This repository is a small command-line security toolkit with two chatbot-detection modes and an OWASP scanning workflow. The scanner accepts individual targets, target lists, or Postman collections, prepares target files, invokes external scanners, and summarizes Nuclei findings. The detector scripts independently report static HTML signatures or dynamically inspected network, DOM, and global-variable signatures. Relationships below follow the sampled source and README; external scanner execution is visible, but no scanner internals are included.

Main entry points: [`owasp_scanner.py`](https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py) (Scan Orchestrator), [`detect_chatbot.py`](https://github.com/darkshell809/vuln-scanner-pro/blob/main/detect_chatbot.py) (Static Detector), [`detect_chatbot_pro.py`](https://github.com/darkshell809/vuln-scanner-pro/blob/main/detect_chatbot_pro.py) (Dynamic Detector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_chatbot["Chatbot Detection"]
  node_static["Static Detector<br/>[detect_chatbot.py]"]
  node_dynamic["Dynamic Detector"]
end

subgraph group_vulnerability["Vulnerability Scanning"]
  node_targetprep["Target Preparation<br/>[owasp_scanner.py]"]
  node_postman["Postman Parser<br/>[owasp_scanner.py]"]
  node_scanner["Scan Orchestrator<br/>[owasp_scanner.py]"]
  node_nmap["Nmap"]
  node_nuclei["Nuclei"]
  node_nikto["Nikto"]
  node_summary["Findings Summary<br/>[owasp_scanner.py]"]
  node_results["Scan Reports<br/>[owasp_scanner.py]"]
end

node_user(("Operator"))
node_website["Target Website"]
node_targets["Target Inputs"]

node_user -->|"runs"| node_static
node_user -->|"runs"| node_dynamic
node_user -->|"provides targets"| node_targetprep
node_static -->|"fetches HTML"| node_website
node_dynamic -->|"inspects page"| node_website
node_targetprep -->|"reads inputs"| node_targets
node_targetprep -->|"parses collection"| node_postman
node_targetprep -->|"prepares target files"| node_scanner
node_scanner -->|"runs discovery"| node_nmap
node_scanner -->|"runs templates"| node_nuclei
node_scanner -->|"runs deep scan"| node_nikto
node_scanner -->|"summarizes JSON"| node_summary
node_nuclei -->|"writes findings"| node_results
node_summary -->|"reads findings"| node_results

click node_static "https://github.com/darkshell809/vuln-scanner-pro/blob/main/detect_chatbot.py"
click node_dynamic "https://github.com/darkshell809/vuln-scanner-pro/blob/main/detect_chatbot_pro.py"
click node_targetprep "https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py"
click node_postman "https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py"
click node_scanner "https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py"
click node_summary "https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py"
click node_results "https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_static,node_dynamic toneBlue
class node_targetprep,node_postman,node_scanner,node_nmap,node_nuclei,node_nikto,node_summary,node_results toneAmber
class node_user,node_website,node_targets toneIndigo
```

## Components

### Chatbot Detection

- [Static Detector](https://github.com/darkshell809/vuln-scanner-pro/blob/main/detect_chatbot.py): `detect_chatbot.py`
- [Dynamic Detector](https://github.com/darkshell809/vuln-scanner-pro/blob/main/detect_chatbot_pro.py): `detect_chatbot_pro.py`

### Vulnerability Scanning

- [Target Preparation](https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py): `owasp_scanner.py`
- [Postman Parser](https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py): `owasp_scanner.py`
- [Scan Orchestrator](https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py): `owasp_scanner.py`
- **Nmap**
- **Nuclei**
- **Nikto**
- [Findings Summary](https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py): `owasp_scanner.py`
- [Scan Reports](https://github.com/darkshell809/vuln-scanner-pro/blob/main/owasp_scanner.py): `owasp_scanner.py`

### Other components

- **Operator**
- **Target Website**
- **Target Inputs**

## Connections

- Operator → Static Detector: runs (evidence: `README.md`)
- Operator → Dynamic Detector: runs (evidence: `README.md`)
- Operator → Target Preparation: provides targets (evidence: `README.md`)
- Static Detector → Target Website: fetches HTML (evidence: `detect_chatbot.py`)
- Dynamic Detector → Target Website: inspects page (evidence: `detect_chatbot_pro.py`)
- Target Preparation → Target Inputs: reads inputs (evidence: `owasp_scanner.py`)
- Target Preparation → Postman Parser: parses collection (evidence: `owasp_scanner.py`)
- Target Preparation → Scan Orchestrator: prepares target files (evidence: `owasp_scanner.py`)
- Scan Orchestrator → Nmap: runs discovery (evidence: `owasp_scanner.py`)
- Scan Orchestrator → Nuclei: runs templates (evidence: `owasp_scanner.py`)
- Scan Orchestrator → Nikto: runs deep scan (evidence: `owasp_scanner.py`)
- Scan Orchestrator → Findings Summary: summarizes JSON (evidence: `owasp_scanner.py`)
- Nuclei → Scan Reports: writes findings (evidence: `owasp_scanner.py`)
- Findings Summary → Scan Reports: reads findings (evidence: `owasp_scanner.py`)
