How osint-experts-society/consensus-osint works
Consensus is a command-line OSINT lookup application for usernames, email addresses, and phone numbers. A user starts a scan through the CLI or interactive terminal; the CLI selects checks, runs data-driven site rules and adapted code modules, then presents unified findings and can export reports. Phone lookup additionally provides offline number analysis and search-dork suggestions. The README also describes broad merged coverage and deduplicated default searches. Relationships below are limited to excerpted source references and README statements; several domain subsystems are present in the tree but their wiring was not sampled.
Main entry points: cli.py Command-line Scanner · models.py Unified Findings · modules.py Module Registry · reports.py Report Export
Components 22
User Interface
- Command-line Scanner
consensus_osint/cli.py - Interactive Terminal
consensus_osint/core/interactive.py - Terminal UI
consensus_osint/core/terminal_ui.py - Console Output
consensus_osint/core/console.py - MCP Interface
consensus_osint/mcp_server.py
Lookup Workflow
- Scan Controls
consensus_osint/core/scan_control.py - Scan Budget
consensus_osint/core/scan_budget.py - Phone Analysis
consensus_osint/core/phone.py
Check Catalog
- Site Rules
consensus_osint/core/sitesdb.py - Module Registry
consensus_osint/core/modules.py - Project Adapters
consensus_osint/adapters - Profile Contracts
consensus_osint/core/profile_api_contracts.py - Mailbox Contracts
consensus_osint/core/mailbox_contracts.py
Results and Reports
- Unified Findings
consensus_osint/core/models.py - Result Interpretation
consensus_osint/core/presentation.py - Report Export
consensus_osint/core/reports.py
Session Support
- Configuration
consensus_osint/core/config.py - Session Details
consensus_osint/core/session_info.py - Managed Installer
consensus_osint/core/install_manager.py
Other components
- User
- Lookup Sites
- Phone Metadata
Connections 29
- User → Command-line Scanner: starts lookup
consensus_osint/cli.py - User → Interactive Terminal: uses
consensus_osint/core/interactive.py - Interactive Terminal → Command-line Scanner: dispatches commands
consensus_osint/core/interactive.py - Command-line Scanner → Site Rules: loads rules
consensus_osint/cli.py - Command-line Scanner → Module Registry: selects checks
consensus_osint/cli.py - Module Registry → Project Adapters: loads families
consensus_osint/core/modules.py - Module Registry → Unified Findings: uses result types
consensus_osint/core/modules.py - Project Adapters → Unified Findings: normalizes results
consensus_osint/adapters/user_scanner_adapter.py - Project Adapters → Module Registry: implements modules
consensus_osint/adapters/user_scanner_adapter.py - Site Rules → Lookup Sites: defines checks
consensus_osint/core/sitesdb.py - Command-line Scanner → Phone Analysis: analyzes numbers
consensus_osint/cli.py - Phone Analysis → Phone Metadata: reads metadata
consensus_osint/core/phone.py - Command-line Scanner → Scan Budget: limits checks
consensus_osint/cli.py - Command-line Scanner → Scan Controls: controls scans
consensus_osint/cli.py - Command-line Scanner → Unified Findings: collects findings
consensus_osint/cli.py - Command-line Scanner → Console Output: prints results
consensus_osint/cli.py - Console Output → Result Interpretation: formats findings
consensus_osint/core/console.py - Console Output → Report Export: offers exports
consensus_osint/core/console.py - Report Export → Unified Findings: reads summaries
consensus_osint/core/reports.py - Report Export → Result Interpretation: uses interpretation
consensus_osint/core/reports.py - Interactive Terminal → Terminal UI: uses terminal UI
consensus_osint/core/interactive.py - Terminal UI → Scan Controls: dispatches controls
consensus_osint/core/terminal_ui.py - MCP Interface → Command-line Scanner: invokes scanner
consensus_osint/mcp_server.py - MCP Interface → Report Export: uses result formats
consensus_osint/mcp_server.py - Configuration → Site Rules: configures catalog
consensus_osint/core/config.py - Session Details → Configuration: identifies session
- Managed Installer → Lookup Sites: retrieves releases
- Profile Contracts → Unified Findings: uses finding types
consensus_osint/core/profile_api_contracts.py - Mailbox Contracts → Unified Findings: uses finding types
consensus_osint/core/mailbox_contracts.py