🔎 Hunt down social media accounts by username across social networks

hacktoberfest python linux windows cli hacktoberfest2022 information-gathering macos osint python3 reconnaissance redteam sherlock tools

Go to file

Christopher K. Hoadley 4ecaad6289 Update script to use with-as structure for files. Add number of supported sites to title. Add status message.		6 years ago
.gitignore	Merge remote-tracking branch 'upstream/master' into async-requests	6 years ago
LICENSE	…
README.md	Add link to sites.md in readme and merge with master	6 years ago
data.json	…
preview.png	Added the image back.	6 years ago
requirements.txt	Merge remote-tracking branch 'upstream/master' into async-requests	6 years ago
sherlock.py	Simeon Visser noticed that "enforce utf-8 encoding when we open data.json" (#8 ) got undone in the previous merge. Include it again.	6 years ago
site_list.py	Update script to use with-as structure for files. Add number of supported sites to title. Add status message.	6 years ago
sites.md	Update script to use with-as structure for files. Add number of supported sites to title. Add status message.	6 years ago

README.md

Sherlock

Find usernames across social networks

Installation

NOTE: Python 3.6 or higher is required.

# clone the repo
$ git clone https://github.com/sdushantha/sherlock.git

# change the working directory to sherlock
$ cd sherlock

# install the requirements
$ pip3 install -r requirements.txt

Usage

$ python3 sherlock.py --help
usage: sherlock.py [-h] [--version] [--verbose] [--quiet] [--csv] [--tor] [--unique-tor]
                   USERNAMES [USERNAMES ...]

Sherlock: Find Usernames Across Social Networks (Version 0.1.0)

positional arguments:
  USERNAMES             One or more usernames to check with social networks.

optional arguments:
  -h, --help            show this help message and exit
  --version             Display version information and dependencies.
  --verbose, -v, -d, --debug
                        Display extra debugging information.
  --quiet, -q           Disable debugging information (Default Option).
  --csv                 Create Comma-Separated Values (CSV) File.
  --tor, -t             Make requests over TOR; increases runtime; requires TOR to be installed and in system path.
  --unique-tor, -u      Make requests over TOR with new TOR circuit after each request; increases runtime; requires TOR to be installed and in system path.

For example, run python3 sherlock.py user123, and all of the accounts found will be stored in a text file with the username (e.g user123.txt).

License

MIT License