OSINT tool to guess and verify (experimental) the email address of a person from information such as firstname, middlename, lastname, username...
An email address is made up from local-part, the symbol @, and a domain. This script does :
- Create a lot of possible local-part from informations given and following generation level
- Add @domain to all local-part respecting the conditions of creation of mail of these domains
- Optional: Verify these mails (only for "gmail","laposte","protonmail","yahoo")
WARNING: Mailfoguess uses holehe to verify the generated mails. It can lead to false results due to rate limit or else.
git clone https://github.com/WildSiphon/Mailfoguess
cd Mailfoguess
pip3 install -r requirements.txt
usage: mailfoguess.py [-h] [-f [FIRSTNAME]] [-m [MIDDLENAME]] [-l [LASTNAME]] [-u [USERNAME]] [-n [NUMBER]] [--yes] [--level {min,low,high,max}] [--resume [RESUME_PATH]] [--separators [SEPARATORS]] [--print]
[--output [OUTPUT_LOCATION]] [--nb-localparts [NB_PRINT_LOCALPARTS]] [--nb-emails [NB_PRINT_EMAILS]] [--nb-verified [NB_PRINT_VERIFIED]]
python script to guess the potentials email adress of someone
optional arguments:
-h, --help show this help message and exit
Target:
Set known parameters concerning the target
-f [FIRSTNAME] set target's firstname
-m [MIDDLENAME] set target's middlename
-l [LASTNAME] set target's lastname
-u [USERNAME] set target's username
-n [NUMBER] set a number to use (year of birth, locality...)
Generation:
Set parameters concerning the generation
--verify, -V tries to verify the addresses using holehe (https://github.com/megadose/holehe)
--yes, -Y assumes "yes" as the answer to all questions of validation
--level {min,low,high,max}, -L {min,low,high,max}
choose level of generation (default 'min')
--resume [RESUME_PATH], -r [RESUME_PATH]
select a json file to resume or enrich wich new options
--separators [SEPARATORS], -s [SEPARATORS]
set separators used for the generation of local-parts (default are '-._')
Output:
Select how the data will be displayed and/or saved
--print, -P print generated informations on screen (local-part, emails and verified emails)
--output [OUTPUT_LOCATION], -O [OUTPUT_LOCATION]
choose output location (default is "./output")
--nb-localparts [NB_PRINT_LOCALPARTS]
set the maximum of local-part printed when informations are displayed (default is 20)
--nb-emails [NB_PRINT_EMAILS]
set the maximum of emails printed per domain when informations are displayed (default is 4)
--nb-verified [NB_PRINT_VERIFIED]
set the maximum of verified emails printed per domain when informations are displayed (default is all)
You enter the No interactions mod when you specify the parameters in the command line.
~$ python3 mailfoguess.py -f Pierre -l Croce --print --yes
You enter Interactions mod when no indication are provided to generate potentials emails.
$ python3 mailfoguess.py
$ python3 mailfoguess.py --level high
$ python3 mailfoguess.py --yes
You will get the same result after this part.
Generating email address is very fast but the verification part can last a long time. For example the command below, (a very bad realistic test case), took me almost 6 hours to verify the 10 000 email address generated from 2300 local-part.
~$ python3 mailfoguess.py -f Bill -m "The Gater" -l Gates -u billythekid -n 1955 --level max --yes
If the verification is to long for you, you can at any time press [ctrl+c]
to stop the script. This will save all the data so you can resume the verification using the –resume
or -r
options.
Results are displayed in console, but everything is recorded and stored by default in ./output/
in a json
file.
pierrecroce.json
{
"firstname": "pierre",
"middlename": null,
"lastname": "croce",
"username": null,
"number": null,
"local-parts": [
"croce",
"p-croce",
"p.croce",
"p_croce",
"pcroce",
"pierre",
"pierre-c",
"pierre-croce",
"pierre.c",
"pierre.croce",
"pierre_c",
"pierre_croce",
"pierrec",
"pierrecroce"
],
"emails": {
"gmail.com": {
"p.croce@gmail.com": true,
"pcroce@gmail.com": true,
"pierre@gmail.com": false,
"pierre.c@gmail.com": true,
"pierre.croce@gmail.com": true,
"pierrec@gmail.com": true,
"pierrecroce@gmail.com": true
},
"yahoo.com": {
"croce@yahoo.com": false,
"p.croce@yahoo.com": false,
"p_croce@yahoo.com": false,
"pcroce@yahoo.com": false,
"pierre@yahoo.com": false,
"pierre.c@yahoo.com": false,
"pierre.croce@yahoo.com": false,
"pierre_c@yahoo.com": false,
"pierre_croce@yahoo.com": false,
"pierrec@yahoo.com": false,
"pierrecroce@yahoo.com": false
},
"yahoo.fr": {
"croce@yahoo.fr": false,
"p.croce@yahoo.fr": false,
"p_croce@yahoo.fr": false,
"pcroce@yahoo.fr": false,
"pierre@yahoo.fr": false,
"pierre.c@yahoo.fr": false,
"pierre.croce@yahoo.fr": false,
"pierre_c@yahoo.fr": false,
"pierre_croce@yahoo.fr": false,
"pierrec@yahoo.fr": false,
"pierrecroce@yahoo.fr": false
},
"laposte.net": {
"croce@laposte.net": false,
"p-croce@laposte.net": false,
"p.croce@laposte.net": false,
"p_croce@laposte.net": false,
"pcroce@laposte.net": false,
"pierre@laposte.net": false,
"pierre-c@laposte.net": false,
"pierre-croce@laposte.net": false,
"pierre.c@laposte.net": false,
"pierre.croce@laposte.net": false,
"pierre_c@laposte.net": false,
"pierre_croce@laposte.net": false,
"pierrec@laposte.net": false,
"pierrecroce@laposte.net": false
},
"protonmail.com": {
"croce@protonmail.com": true,
"p-croce@protonmail.com": true,
"p.croce@protonmail.com": true,
"p_croce@protonmail.com": true,
"pcroce@protonmail.com": true,
"pierre@protonmail.com": true,
"pierre-c@protonmail.com": true,
"pierre-croce@protonmail.com": true,
"pierre.c@protonmail.com": true,
"pierre.croce@protonmail.com": true,
"pierre_c@protonmail.com": true,
"pierre_croce@protonmail.com": true,
"pierrec@protonmail.com": true,
"pierrecroce@protonmail.com": true
}
}
}
Each level includes the previous ones.
Creating lists of names based on given informations:
Level | Consequences |
---|---|
Minimal | Process with an empty name If name is not composed: - Process with the name If name is composed: - Process with each part of the name separately + Skipping particles (2 letters word) in all the names except in usernames - Process with the all name separated by each separator Example: Jean-Michel -> "", jean, michel, jean-michel, jean.michel, jean_michel, jeanmichel de Bauvoir -> "", bauvoir, de-bauvoir, de.bauvoir, de_bauvoir, debauvoir |
Low | Process with the vowelless lastname where all consecutives consonants are unique Example: Cadillac -> cdlc |
High | Process with the vowelless lastname Example: Cadillac -> cdllc |
Maximal |
Minimal | Low | High | Maximal |
---|---|---|---|
user first first ° last first ° lini first ° middle ° last first ° middle ° lini fini ° last fini ° middle ° last last |
first ° middle first ° mini fini ° middle middle middle ° last middle ° lini last ° first last ° fini last ° middle last ° first ° middle last ° fini ° middle lini ° first ° middle lini ° first lini ° middle |
first ° last ° middle first ° last ° mini first ° lini ° middle middle ° first middle ° fini mini ° first mini ° last last ° mini last ° middle ° first last ° mini ° first lini ° middle ° first |
first ° mini ° last middle ° first ° last middle ° last ° first middle ° first ° lini middle ° lini ° first mini ° first ° last mini ° last ° first last ° first ° mini |
- first,middle,last,user represents firstname,middlename,lastname,username
- fini,mini,lini represents the initials of firstname, middlename or lastname
- If the name is composed, the initials are the concatenation of all initials' part
- ° represent a separator (by default they are
'', '-', '.', '_'
)
- Colors in the printed output (feel free to help me with that)
Creation of emailVerification on email- Add options to change separators
- Add options to choose providers to use
- Option to choose a country to define the list of domains
Possibility to stop and resume the script
- This tool which help me to verify email address : https://github.com/megadose/holehe