How mcbottm/mcbotscan works
MCBOTSCAN is a Termux-oriented, static APK risk scanner: users provide an APK or decompiled directory and receive scored findings, a risk classification, and optionally JSON. Its main workflow is CLI to scan orchestration, APK extraction and manifest/smali analysis, cluster-based scoring, then reporting. The README also describes captured-log parsing and dynamic-analysis extension stubs; these are separate from the working static workflow. Edges reflect the supplied source excerpts, index references, and README; unsampled behavior is not inferred.
Main entry points: scanner.py Scan orchestrator · string_scan.py Smali scanning · analyzer.py Risk analysis · yara_engine.py YARA scanning
Components 19
User interface
- CLI
cli/main.py - Package API
mcbotscan/__init__.py
Scan pipeline
- Scan orchestrator
mcbotscan/core/scanner.py - APK extraction
mcbotscan/core/extractor.py
Detection and scoring
- Manifest scanning
mcbotscan/static/permission_scan.py - Smali scanning
mcbotscan/static/string_scan.py - DEX patterns
mcbotscan/static/dex_loader.py - YARA scanning
mcbotscan/static/yara_engine.py - Detection rules
mcbotscan/rules - Risk analysis
mcbotscan/core/analyzer.py
Results and utilities
- Report renderer
mcbotscan/core/report.py - APK hashing
mcbotscan/utils/hash.py - Scan logging
mcbotscan/utils/logger.py - Scan helpers
mcbotscan/utils/helpers.py - Version metadata
mcbotscan/_version.py
Behavioral extensions
- Logcat parser
mcbotscan/behavioral/logcat_parser.py - Network monitor stub
mcbotscan/behavioral/network_monitor.py - Emulator hooks stub
mcbotscan/behavioral/emulator_hooks.py
Other components
- APK analyst
Connections 20
- APK analyst → CLI: provides target
README.md - CLI → Package API: imports
cli/main.py - Package API → Scan orchestrator: exposes scanner
mcbotscan/__init__.py - Scan orchestrator → APK extraction: extracts APK
mcbotscan/core/scanner.py - Scan orchestrator → Manifest scanning: scans manifest
mcbotscan/core/scanner.py - Scan orchestrator → Smali scanning: scans smali
mcbotscan/core/scanner.py - Scan orchestrator → YARA scanning: runs optional scan
mcbotscan/core/scanner.py - Scan orchestrator → Detection rules: loads rules
mcbotscan/core/scanner.py - Smali scanning → DEX patterns: delegates patterns
mcbotscan/static/string_scan.py - YARA scanning → APK extraction: discovers smali dirs
mcbotscan/static/yara_engine.py - YARA scanning → Risk analysis: creates findings
mcbotscan/static/yara_engine.py - Scan orchestrator → Risk analysis: scores findings
mcbotscan/core/scanner.py - Scan orchestrator → Report renderer: renders results
mcbotscan/core/scanner.py - Scan orchestrator → APK hashing: hashes target
mcbotscan/core/scanner.py - Scan orchestrator → Scan logging: logs scan
mcbotscan/core/scanner.py - Manifest scanning → Risk analysis: creates findings
mcbotscan/static/permission_scan.py - Smali scanning → Risk analysis: creates findings
mcbotscan/static/string_scan.py - Smali scanning → Scan helpers: classifies URLs
mcbotscan/static/string_scan.py - Report renderer → Version metadata: reads version
mcbotscan/core/report.py - Report renderer → Scan helpers: formats points
mcbotscan/core/report.py