站内导读
定位:Sherlock 是 Sherlock Project 维护的开源命令行工具,输入一个或多个用户名,在 400 多个社交网络上查询是否存在对应账号,并把命中结果写入文件。
核心能力
- 支持一次传入多个用户名批量查询;也可用
{?}占位符,把该位置替换为下划线、连字符或点号后,一并检查相近的用户名。 - 命中账号按用户名分别写入独立文本文件,另可通过参数导出为 CSV、XLSX、JSON,便于后续整理。
- 提供
--site限定站点、--timeout设置超时、--proxy指定代理、--dump-response保留原始响应等选项。 - 用
--print-all与--print-found区分输出范围,--browse可直接打开命中页面。
适用人群:适合做公开信息核查、安全研究与媒体查证的人;
位置づけ:Sherlock は Sherlock Project が保守するオープンソースの CLI ツールで、一つまたは複数のユーザー名を入力すると、400 以上のソーシャルネットワークに同名のアカウントが存在するかを調べ、ヒット結果をファイルに書き出します。
主な機能
- 複数のユーザー名を一度に渡して一括検索できます。
{?}プレースホルダを使えば、その位置をアンダースコア、ハイフン、ピリオドに置き換えた近いユーザー名もまとめて確認できます。 - ヒットしたアカウントはユーザー名ごとに個別のテキストファイルへ書き出され、パラメータ指定で CSV、XLSX、JSON へのエクスポートも可能です。
--siteでのサイト限定、--timeoutのタイムアウト設定、--proxyのプロキシ指定、--dump-responseの生レスポンス保存などのオプションがあります。--print-allと--print-foundで出力範囲を切り替え、--browseでヒットしたページを直接開けます。
対象ユーザー:公開情報の確認、セキュリティ調査、メディアのファクトチェックに携わる人に向いています。
정의: Sherlock은 Sherlock Project가 유지보수하는 오픈소스 명령줄 도구로, 사용자 이름 하나 또는 여러 개를 입력하면 400개가 넘는 소셜 네트워크에서 같은 이름의 계정이 있는지 조회하고 결과를 파일로 저장합니다.
핵심 기능
- 사용자 이름 여러 개를 한 번에 넘겨 일괄 조회할 수 있고,
{?}자리 표시자를 쓰면 그 위치를 밑줄, 하이픈, 점으로 바꾼 비슷한 사용자 이름까지 함께 확인할 수 있습니다. - 찾은 계정은 사용자 이름별로 별도 텍스트 파일에 기록되며, 옵션을 통해 CSV, XLSX, JSON으로 내보낼 수도 있습니다.
--site로 사이트를 한정하고,--timeout으로 시간 제한을,--proxy로 프록시를 지정하며,--dump-response로 원본 응답을 남기는 등의 옵션을 제공합니다.--print-all과--print-found로 출력 범위를 나누고,--browse로 찾은 페이지를 바로 열 수 있습니다.
대상 사용자: 공개 정보 확인, 보안 연구, 미디어 검증 작업을 하는 사람에게 적합합니다.
What it is: Sherlock is an open-source command-line tool maintained by the Sherlock Project. Give it one or more usernames and it checks 400+ social networks for matching accounts, writing the hits to files.
Key capabilities
- Pass multiple usernames for a batch search; the
{?}placeholder also checks near variants with that position replaced by an underscore, hyphen, or dot. - Found accounts are written to a separate text file per username, and flags can export results to CSV, XLSX, or JSON for further processing.
- Options include
--siteto limit sites,--timeoutfor timeouts,--proxyfor a proxy, and--dump-responseto keep raw responses. --print-alland--print-foundcontrol output scope, and--browseopens found pages directly.
Who it is for: People doing public-information checks, security research, or media verification.
README · 详细文档
来源 · 查看原文
Hunt down social media accounts by username across 400+ social networks
Installation • Usage • Contributing
Installation
[!WARNING] Packages for ParrotOS and Ubuntu 24.04, maintained by a third party, appear to be broken. Users of these systems should defer to 0/pipx/pipor Docker.
| Method | Notes |
|---|---|
pipx install sherlock-project | pip or 1 may be used in place of pipx |
docker run -it --rm sherlock/sherlock | |
dnf install sherlock-project |
Community-maintained packages are available for Debian (>= 13), Ubuntu (>= 22.10), Homebrew, Kali, and BlackArch. These packages are not directly supported or maintained by the Sherlock Project.
See all alternative installation methods here.
General usage
To search for only one user:
sherlock user123
To search for more than one user:
sherlock user1 user2 user3
Accounts found will be stored in an individual text file with the corresponding username (e.g ``user123.txt``).
$ sherlock --help
usage: sherlock [-h] [--version] [--verbose] [--folderoutput FOLDEROUTPUT] [--output OUTPUT] [--csv] [--xlsx] [--site SITE_NAME] [--proxy PROXY_URL] [--dump-response]
[--json JSON_FILE] [--timeout TIMEOUT] [--print-all] [--print-found] [--no-color] [--browse] [--local] [--nsfw] [--txt] [--ignore-exclusions]
USERNAMES [USERNAMES ...]
Sherlock: Find Usernames Across Social Networks (Version 0.16.0)
positional arguments:
USERNAMES One or more usernames to check with social networks. Check similar usernames using {?} (replace to '_', '-', '.').
options:
-h, --help show this help message and exit
--version Display version information and dependencies.
--verbose, -v, -d, --debug
Display extra debugging information and metrics.
--folderoutput FOLDEROUTPUT, -fo FOLDEROUTPUT
If using multiple usernames, the output of the results will be saved to this folder.
--output OUTPUT, -o OUTPUT
If using single username, the output of the result will be saved to this file.
--csv Create Comma-Separated Values (CSV) File.
--xlsx Create the standard file for the modern Microsoft Excel spreadsheet (xlsx).
--site SITE_NAME Limit analysis to just the listed sites. Add multiple options to specify more than one site.
--proxy PROXY_URL, -p PROXY_URL
Make requests over a proxy. e.g. socks5://127.0.0.1:1080
--dump-response Dump the HTTP response to stdout for targeted debugging.
--json JSON_FILE, -j JSON_FILE
Load data from a JSON file or an online, valid, JSON file. Upstream PR numbers also accepted.
--timeout TIMEOUT Time (in seconds) to wait for response to requests (Default: 60)
--print-all Output sites where the username was not found.
--print-found Output sites where the username was found (also if exported as file).
--no-color Don't color terminal output
--browse, -b Browse to all results on default browser.
--local, -l Force the use of the local data.json file.
--nsfw Include checking of NSFW sites from default list.
--txt Enable creation of a txt file
--ignore-exclusions Ignore upstream exclusions (may return more false positives)
Credits
Thank you to everyone who has contributed to Sherlock! ❤️
Star History
License
MIT © Sherlock Project
Creator - Siddharth Dushantha
[extpypi]: https://pypi.org/project/sherlock-project/ [extbrew]: https://formulae.brew.sh/formula/sherlock