Buster - An advanced tool for email reconnaissance

$ git clone git://github.com/sham00n/buster

$ cd buster/
$ python3 setup.py install
$ buster -h

API keys

This project uses hunter.io to get information from company emails,the first couple "company email" searches dont require a key,if you have an interest in company emails i recommend that you sign up for an account on hunter.io.

Once you get an API key, add it to the file "api-keys.yaml" and rerun the command:

$ python setup.py install

Usage

usage: buster [-h] [-e EMAIL] [-f FIRST] [-m MIDDLE] [-l LAST] [-b BIRTHDATE]
              [-a ADDINFO [ADDINFO ...]] [-u USERNAME][-c COMPANY]
              [-p PROVIDERS [PROVIDERS ...]] [-o OUTPUT] [-v] [--list LIST]

Buster is an OSINT tool used to generate and verify emails and return
information associated with them

optional arguments:
 -h, --help               show this help message and exit
 -e EMAIL, --email EMAIL  
                          email adress or email pattern
 -f FIRST, --first FIRST 
                          first name
 -m MIDDLE, --middle MIDDLE 
                          middle name
 -l LAST, --last LAST 
                          last name
 -b BIRTHDATE, --birthdate BIRTHDATE
                          birthdate in ddmmyyyy format,type * if you dont
                          know(ex:****1967,3104****)
 -a ADDINFO [ADDINFO ...], --addinfo ADDINFO [ADDINFO ...]
                          additional info to help guessing the
                          email(ex:king,345981)
 -u USERNAME, --username USERNAME
                          checks 100+ email providers for the availability of
                          [email protected]
 -c COMPANY, --company COMPANY
                          company domain
 -p PROVIDERS [PROVIDERS ...], --providers PROVIDERS [PROVIDERS ...]
                          email provider domains
 -o OUTPUT, --output OUTPUT
                          output to a file
 -v, --validate 
                          check which emails are valid and returns information of each one
 --list LIST 
                          file containing list of emails

Usage examples

Get info of a single email(exists or not,social media where email was used,data breaches,pastes and links to where it was found)

$ buster -e [email protected]

Query for list of emails`

$ buster --list emails.txt

Generate emails that matches the pattern and checks if they exist or not(use the -a argument if you have more info to add(ex: -a nickname fav_color phone #)

$ buster -e j********9@g****.com -f john -l doe -b ****1989

Generate usernames (use with -o option and input the file to recon-ng's profiler module)

$ buster -f john -m james -l doe -b 13071989

Generate emails (use -v if you want to validate and get info of each email)

$ buster -f john -m james -l doe -b 13071989 -p gmail.com yahoo.com

Generate 100+ emails in the format [email protected] and returns the valid ones(use -p if you dont want all 100+)

$ buster -u johndoe

Generate a company email and returns info associated with it

$ buster -f john -l doe -c company.com

Download tool: https://github.com/sham00n/buster