Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/GitSquared/sherlock-js
Find usernames across over 170 social networks - Fast & flexible remake of sdushantha/sherlock
https://github.com/GitSquared/sherlock-js
cli linux macos nodejs osint reconnaissance sherlock windows
Last synced: about 2 months ago
JSON representation
Find usernames across over 170 social networks - Fast & flexible remake of sdushantha/sherlock
- Host: GitHub
- URL: https://github.com/GitSquared/sherlock-js
- Owner: GitSquared
- License: mit
- Archived: true
- Created: 2018-12-26T19:00:43.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-12-12T11:13:01.000Z (almost 4 years ago)
- Last Synced: 2024-04-08T07:35:48.612Z (6 months ago)
- Topics: cli, linux, macos, nodejs, osint, reconnaissance, sherlock, windows
- Language: JavaScript
- Homepage:
- Size: 417 KB
- Stars: 182
- Watchers: 11
- Forks: 22
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Sherlock.js
This is a "remake" of the original [sherlock](https://github.com/sdushantha/sherlock) written in Python by [sdushantha](https://github.com/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](https://github.com/GitSquared/sherlock-js/releases)
- 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"
```