Skip to content

πŸŒοΈβ€β™€οΈ Sherlock assistant to bulk username research

License

Notifications You must be signed in to change notification settings

greenmagenta/watson

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

46 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

watson

πŸŒοΈβ€β™€οΈ Sherlock assistant to bulk username research.

This script is based on Sherlock, originally created by Siddharth Dushantha.

Get started

Note : Python 3.6 or higher is required.

# install sherlock if not already done

# clone the repository in sherlock/sherlock directory
$ git clone https://github.com/greenmagenta/watson.git

# change the working directory to watson
$ cd watson

# install python3 and python3-pip if they are not installed

# install the requirements
$ python3 -m pip install -r requirements.txt

The best way to use Watson is to clone it in the sherlock/sherlock directory.
Anyway, you can change it path to reach it in config.json

"sherlock_dir": "..\\sherlock.py"
sherlock
β”œβ”€β”€ data_bad_site.json
β”œβ”€β”€ site_list.py
└── sherlock
    β”œβ”€β”€ notify.py
    β”œβ”€β”€ result.py
    β”œβ”€β”€ sherlock.py
    β”œβ”€β”€ sites.py
    └── watson
        └── watson.py

Usage

$ python3 watson.py --help
usage: watson.py [-h] [-q] [--csv] [--json] FILE

Watson: Sherlock assistant to bulk username research

positional arguments:
  FILE         File containing usernames

optional arguments:
  -h, --help   show this help message and exit
  -q, --quiet  Quiet Sherlock output from terminal and keep only essential
               informations.
  --csv        Use Comma-Separated Values (CSV) File.
  --json       Use JavaScript Object Notation (JSON) File.

(Version 1.0.2)

Run presinstalled examples :

# basic text file
$ python3 watson.py examples/example.txt

# csv file
$ python3 watson.py --csv examples/example.csv

# json file
$ python3 watson.py --json examples/example.json

Implementations

Currently working on other implementations like :

  • Simultaneous sherlock requests, especially for massive username research
  • Sherlock requests over tor, including circuit renew between requests

License

GPL-3.0 License

About

πŸŒοΈβ€β™€οΈ Sherlock assistant to bulk username research

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages