How katrielmoses/mailaccess works
MailAccess is an email-OSINT product: users investigate an email for linked accounts and identity signals, or harvest public company email addresses from a domain; name-and-domain lookup and hosted Pro enrichment are additional workflows. The map separates the CLI and web entry points, investigation and harvesting stages, enrichment/integrations, and persistence and reporting. README claims preserve major capabilities, but many modules and routes were not sampled, so undocumented internal links are omitted rather than inferred.
Main entry points: engine.py Investigation engine · domain_harvest_orchestrator.py Harvest orchestration · search_provider_router.py Search providers · main.py CLI
Components 20
User interfaces
- CLI
cli/main.py - Web application
frontend/src/App.tsx - API and routes
backend/main.py
Email investigation
- Investigation engine
backend/core/engine.py - Account checks
backend/modules/base.py - Platform sweep
backend/core/platform_executor.py - Identity and risk
backend/core/identity_graph.py
Domain harvesting
- Harvest command
cli/harvest_emails.py - Harvest orchestration
backend/core/domain_harvest_orchestrator.py - Email extraction
backend/core/email_extraction.py - Netlas sources
backend/core/netlas_client.py
Enrichment and integrations
- Pro enrichment
backend/api/routes/enrich.py - Search providers
backend/core/search_provider_router.py - HTTP transport
backend/core/http_client.py - Stealth transport
backend/core/stealth_client.py
Persistence and results
- Database
backend/db/database.py - Stored records
backend/db/models.py - Report exporters
backend/exporters/base.py - Webhook notifications
backend/integrations/webhooks.py
Other components
- Analyst
Connections 19
- Analyst → CLI: runs commands
README.md - Analyst → Web application: uses web app
README.md - Web application → API and routes: calls API
- API and routes → Investigation engine: starts investigations
- CLI → Investigation engine: investigates email
- Investigation engine → Account checks: runs checks
backend/core/engine.py - Investigation engine → Platform sweep: sweeps platforms
- Investigation engine → Identity and risk: builds identity results
backend/core/engine.py - Analyst → Harvest command: requests domain harvest
README.md - Harvest command → Harvest orchestration: starts harvest
cli/harvest_emails.py - Harvest orchestration → Email extraction: extracts addresses
- Harvest orchestration → Netlas sources: queries sources
- Analyst → Pro enrichment: requests Pro leads
README.md - Search providers → HTTP transport: uses transport
backend/core/search_provider_router.py - Search providers → Stealth transport: uses transport
- Investigation engine → Database: persists findings
backend/core/engine.py - Database → Stored records: stores records
backend/db/database.py - Analyst → Report exporters: exports reports
README.md - Investigation engine → Webhook notifications: notifies results
backend/core/engine.py