sherlock-project/sherlock
Hunt down social media accounts by username across social networks
How sherlock is put together
Sherlock is a Python 3.9+ command-line OSINT tool that hunts for a given username across hundreds of social media sites. It is data-driven: site definitions (URLs, error-detection heuristics) live in sherlock_project/resources/data.json, which is validated against a bundled JSON Schema. The core module (sherlock.py) fans out concurrent HTTP probes using requests/requests-futures, classifies results via result.py, and can emit notifications through notify.py. The repo also ships an Apify serverless Actor wrapper (.actor/) that packages the same engine to run on the Apify cloud platform, plus Docker packaging and Poetry-based build metadata.
Languages
Frameworks
Infrastructure
Major components
sherlock_project.sherlock
Main CLI entrypoint and orchestration logic that probes each configured site for target usernames.
sherlock_project.sites
Loads, validates, and provides access to the site definition catalog from resources/data.json.
sherlock_project.result
Models query targets and per-site result statuses/outcomes.
sherlock_project.notify
Handles delivery of found-account results to configured notification channels.
resources/data.json + data.schema.json
Community-maintained catalog of supported social networks with detection rules, enforced by a bundled JSON Schema.
.actor (Apify wrapper)
Packages Sherlock as an Apify Actor with its own Dockerfile, input/dataset schemas, and launch script.
devel/
Developer utilities for listing sites and summarizing site-validation results.
test/tooling config (pytest.ini, tox.ini)
Configures parallel test execution across environments.
The team added a new banner graphic to the UserSearch page and polished its image link.
This week's work on the Sherlock project focused on a single visual improvement: adding a promotional banner to the UserSearch page. The change was contributed via a pull request, merged, and followed up with a small update to the banner's image link.
Feature
UserSearch banner added
A new banner was added to the UserSearch page, merged into the project through pull request #3058.
Chore
Banner URL updated
A follow-up tweak corrected the web address pointing to the banner image so it displays properly.
Dependencies and code review
Dependency advisories
Security Watch
No known advisories across 0 scanned dependencies.
No known advisories in the scanned dependencies.
Code review
No concrete code-level issues confirmed.
Get this report every week for your repos.
GitZoid learns each repo, reports what changed, and flags what needs attention. One flat price for the whole team.
$19 a month, flat · First 10 outputs free · No card required