Skip to content
Find usernames across over 170 social networks - Fast & flexible remake of sdushantha/sherlock
JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
.gitignore
LICENSE
README.md
https-worker.js
index.js
package-lock.json
package.json
screenshot.png
services.json

README.md

Sherlock.js


Screenshot

This is a "remake" of the original sherlock written in Python by sdushantha that I made mostly because I was bored and found that it had some flaws.

It is written in Node.js simply because that's the language I'm the most confortable with, but that's probably not the best choice and I'll see if I can make a Rust version or something.

Notable differences compared to sherlock (at time of writing):

  • 0 dependencies pre-built binaries for Windows/macOS/Linux
  • Tests all services concurrently (asynchronous/"multithreaded")
  • Checks whether accounts exists by looking at both the HTTP response status code and stripping down the HTML code to search if the desired username is written on the page
  • Follows HTTP(S) redirections
  • Command line switches allow piping output in various formats; designed to be used with xargs

Available command line switches

  • General:
    • --help: Display this message
    • --version or -v: Print version
  • Options:
    • --name user or -n user: Specify a username to search for (remove prompt)
    • --only-found or -f: Only output when username was found (skip errors/404s)
  • Output formats:
    • --json or -j: Output results in minified JSON
    • --csv or -c: Output results in CSV format
    • --pretty-json: Output results in whitespaced JSON

Examples:

Search for all accounts named Smith, display live results:

./sherlockjs --name Smith

Get a human-readable file with links to all accounts named Smith:

./sherlockjs --pretty-json --only-found -n Smith > smith_accounts.json

You can use sherlockjs non-interactive options combined with common shell utilities to easily batch-process lists of users, and leverage sherlockjs' multithreaded design to create powerful, fast, extensive one-liner searches.

For instance, to batch-process a list of usernames, output each user's accounts in separate .csv files, and start all sherlockjs searches simultaneously (careful with the potential # of threads!):

cat users.txt | xargs -r -P 0 -I % sh -c "./sherlockjs -cf -n % > accounts_%.csv"
You can’t perform that action at this time.