How mcbottm/mcbotweb works
MCBOTWEB is an offline static security and syntax scanner for web-project source trees. A user selects files or a directory and scan modes through the CLI; the scanner collects relevant files, dispatches per-file vulnerability and lint checks, optionally runs project-wide contextual checks, then scores findings for a verdict and report. The graph also shows rule loading and language detection as shared internal layers. The scanner’s documented orchestration supports the contextual branches; unsampled implementation details are not inferred beyond those documented calls.
Main entry points: scanner.py Scan orchestrator · analyzer.py File analyzer · _scan_common.py Shared rule matching · rule_loader.py Rule loader
Components 24
User entry
- CLI
cli/main.py
Scan orchestration
- Scan orchestrator
mcbotweb/core/scanner.py - File extraction
mcbotweb/core/extractor.py - Language detection
mcbotweb/utils/language_detect.py - File analyzer
mcbotweb/core/analyzer.py
Static analysis
- PHP vuln scan
mcbotweb/static/php_scan.py - JavaScript vuln scan
mcbotweb/static/js_scan.py - HTML vuln scan
mcbotweb/static/html_scan.py - Python vuln scan
mcbotweb/static/py_scan.py - Shared rule matching
mcbotweb/static/_scan_common.py - Language lint checks
mcbotweb/static
Project context
- Framework detection
mcbotweb/contextual/framework_detector.py - Framework rules
mcbotweb/contextual/framework_rules.py - Secret scan
mcbotweb/contextual/secret_scanner.py - Env and config scan
mcbotweb/contextual/env_config_scanner.py - Dependency check
mcbotweb/contextual/dependency_checker.py - Project structure check
mcbotweb/contextual/project_structure_scanner.py
Findings and rules
- Finding scoring
mcbotweb/core/scoring.py - Rule loader
mcbotweb/core/rule_loader.py - Vulnerability rules
mcbotweb/rules/web_vuln_rules.json - Vulnerable package list
mcbotweb/rules/known_vulnerable_packages.json - Scoring rules
mcbotweb/rules/scoring_rules.yaml - Report output
mcbotweb/core/report.py
Other components
- User
Connections 28
- User → CLI: selects targets
README.md - CLI → Scan orchestrator: runs scan
cli/main.py - Scan orchestrator → File extraction: collects files
mcbotweb/core/scanner.py - File extraction → Language detection: detects language
mcbotweb/core/extractor.py - Scan orchestrator → File analyzer: analyzes files
mcbotweb/core/scanner.py - File analyzer → Language detection: detects language
mcbotweb/core/analyzer.py - File analyzer → PHP vuln scan: dispatches
mcbotweb/core/analyzer.py - File analyzer → JavaScript vuln scan: dispatches
mcbotweb/core/analyzer.py - File analyzer → HTML vuln scan: dispatches
mcbotweb/core/analyzer.py - File analyzer → Python vuln scan: dispatches
mcbotweb/core/analyzer.py - File analyzer → Language lint checks: dispatches
mcbotweb/core/analyzer.py - PHP vuln scan → Shared rule matching: uses matching
mcbotweb/static/php_scan.py - JavaScript vuln scan → Shared rule matching: uses matching
mcbotweb/static/js_scan.py - HTML vuln scan → Shared rule matching: uses matching
mcbotweb/static/html_scan.py - Python vuln scan → Shared rule matching: uses matching
mcbotweb/static/py_scan.py - Shared rule matching → Rule loader: loads rules
mcbotweb/static/_scan_common.py - Rule loader → Vulnerability rules: loads
mcbotweb/core/rule_loader.py - Scan orchestrator → Framework detection: detects frameworks
mcbotweb/core/scanner.py - Scan orchestrator → Framework rules: runs checks
mcbotweb/core/scanner.py - Scan orchestrator → Secret scan: scans secrets
mcbotweb/core/scanner.py - Scan orchestrator → Env and config scan: scans config
mcbotweb/core/scanner.py - Scan orchestrator → Dependency check: checks dependencies
mcbotweb/core/scanner.py - Dependency check → Vulnerable package list: matches package list
mcbotweb/contextual/dependency_checker.py - Scan orchestrator → Project structure check: checks structure
mcbotweb/core/scanner.py - Scan orchestrator → Finding scoring: scores findings
mcbotweb/core/scanner.py - Finding scoring → Rule loader: loads scoring rules
mcbotweb/core/scoring.py - Rule loader → Scoring rules: loads
mcbotweb/core/rule_loader.py - CLI → Report output: prints or saves
cli/main.py