How sherlock-project/sherlock works
Sherlock is a username-discovery CLI that checks usernames across hundreds of social networks. The workflow accepts one or more usernames, loads and filters site definitions, probes eligible sites in parallel, classifies responses, and reports or exports findings. The graph also includes the documented selection, proxy, browsing, and output options. Source excerpts show the CLI/search and site-loading responsibilities; some export and option details are documented in the README rather than fully excerpted.
Main entry points: sherlock.py Search coordinator · sites.py Site definitions · notify.py Live notifications · __main__.py Command entry
Components 15
CLI workflow
- Command entry
sherlock_project/__main__.py - Search options
sherlock_project/sherlock.py
Site catalog
- Site definitions
sherlock_project/sites.py - Bundled site manifest
sherlock_project/resources/data.json - Remote manifest
- Exclusion list
Account probing
- Search coordinator
sherlock_project/sherlock.py
Results and reporting
- Query classification
sherlock_project/result.py - Live notifications
sherlock_project/notify.py - Result exports
sherlock_project/sherlock.py
Other components
- CLI user
- Social networks
- Terminal output
- Web browser
- Output files
Connections 14
- CLI user → Command entry: starts search
- Command entry → Search options: dispatches to
sherlock_project/__main__.py - Search options → Site definitions: configures
sherlock_project/sherlock.py - Search options → Search coordinator: configures
sherlock_project/sherlock.py - Site definitions → Bundled site manifest: loads
sherlock_project/sites.py - Site definitions → Remote manifest: fetches
sherlock_project/sites.py - Site definitions → Exclusion list: fetches exclusions
sherlock_project/sites.py - Search coordinator → Social networks: probes accounts
sherlock_project/sherlock.py - Search coordinator → Query classification: creates statuses
sherlock_project/sherlock.py - Search coordinator → Live notifications: updates results
sherlock_project/sherlock.py - Live notifications → Terminal output: prints findings
sherlock_project/notify.py - Live notifications → Web browser: opens matches
sherlock_project/notify.py - Search coordinator → Result exports: writes reports
sherlock_project/sherlock.py - Result exports → Output files: saves results