sherlock README

The project's README from github.com/sherlock-project/sherlock. As one markdown file: README.md.


sherlock
Hunt down social media accounts by username across 400+ social networks

Installation    •    Usage    •    Contributing

demo

Installation

OSINTSearch User Search OSINT Industries

[!WARNING]
Packages for ParrotOS and Ubuntu 24.04, maintained by a third party, appear to be broken.
Users of these systems should defer to uv/pipx/pip or Docker.

Method Notes
pipx install sherlock-project pip or uv 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! ❤️

contributors

Star History

Sherlock Project Star History Chart

License

MIT © Sherlock Project
Creator - Siddharth Dushantha

sherlock (sherlock-project/sherlock)

Searching Database…

94.4K ·GitHub
这是干什么的?Sherlock 可以根据用户名搜查社交媒体账号:给它一个用户名,它就会在各大社交网络上查找用这个名字注册的账号。
这是终端工具,还是有图形界面?它是一个命令行工具:你在终端里运行它,并输入想查询的一个或多个用户名。它没有图形界面。
pipx、Docker 还是发行版软件包——哪种安装方式最好?pipx install sherlock-project 是官方推荐的方法(用 pip 或 uv 也可以),'docker run -it --rm sherlock/sherlock' 无需安装即可使用,Fedora 用户则可以用 dnf install sherlock-project。
有没有哪些软件包我应该避开?有:ParrotOS 和 Ubuntu 24.04 的第三方软件包目前是坏的,这两个系统的用户请改用 uv、pipx、pip 或 Docker。
它能在 macOS 和 Windows 上运行吗,还是只支持 Linux?它是 Python 命令行工具,还有官方 Docker 镜像,所以三个系统都能用;README 里还列出了社区提供的软件包,支持 Homebrew(macOS)、Debian、Ubuntu、Kali 和 BlackArch。
搜查的结果会保存在哪里?找到的账号会保存到一个单独的文本文件里,文件名就是查询的用户名,所以每次查询都会留下自己的结果文件。
Size
18.6 MB
Stars
94.4K
Age
7y
Commits · 90 Days