How megadose/holehe works
Holehe is an OSINT tool for checking whether an email is associated with accounts across 120+ services. The principal workflow accepts an email through the CLI, discovers and runs service-specific checks concurrently, and reports whether accounts exist, along with possible recovery details and rate-limit status. The checks span social, community, business, and consumer services; their implementations make HTTP requests directly to those services. The README also documents calling an individual check from Python. The excerpts show core orchestration and representative checks, but not every module’s implementation or the complete CLI flow.
Main entry points: core.py CLI and runner · localuseragent.py User-agent data · modules Social and media checks · instruments.py Progress tracker
Components 10
Entry and orchestration
- CLI and runner
holehe/core.py - Check results
holehe/core.py
Runtime support
- Progress tracker
holehe/instruments.py - User-agent data
holehe/localuseragent.py
Account checks
- Social and media checks
holehe/modules - Community and interest checks
holehe/modules - Business and work checks
holehe/modules - Consumer and service checks
holehe/modules
External systems
- Target services
Other components
- CLI user
Connections 16
- CLI user → CLI and runner: provides email
- CLI and runner → Social and media checks: dispatches checks
holehe/modules/shopping/garmin.py - CLI and runner → Community and interest checks: dispatches checks
holehe/modules/shopping/garmin.py - CLI and runner → Business and work checks: dispatches checks
holehe/modules/shopping/garmin.py - CLI and runner → Consumer and service checks: dispatches checks
holehe/modules/shopping/garmin.py - CLI and runner → Progress tracker: registers tracker
holehe/core.py - Progress tracker → CLI and runner: tracks tasks
holehe/instruments.py - Social and media checks → User-agent data: uses user agents
holehe/modules/social_media/tumblr.py - Community and interest checks → User-agent data: uses user agents
holehe/modules/forum/nattyornot.py - Business and work checks → User-agent data: uses user agents
holehe/modules/company/aboutme.py - Consumer and service checks → User-agent data: uses user agents
holehe/modules/shopping/garmin.py - Social and media checks → Target services: queries accounts
- Community and interest checks → Target services: queries accounts
- Business and work checks → Target services: queries accounts
- Consumer and service checks → Target services: queries accounts
- CLI and runner → Check results: prints and exports
holehe/core.py