Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hippiiee/mailpermute

Generate email permutations from a name and verify if this email exist with different providers (gmail, duckduckgo, yahoo, yandex)
https://github.com/hippiiee/mailpermute

Last synced: 10 days ago
JSON representation

Generate email permutations from a name and verify if this email exist with different providers (gmail, duckduckgo, yahoo, yandex)

Awesome Lists containing this project

README

        

# MailPermute


Find valid email from a name with permutations


img last release



## Features
Find valid email from different providers:
- [x] DuckDuckGo
- [x] Gmail
- [x] Posteo
- [x] Yahoo
- [x] Yandex

## Requirements

```bash
pip3 install -r requirements.txt
```

## Usage

```
$ python3 mailpermute.py -h

888b d888 d8b 888 888
8888b d8888 Y8P 888 888
88888b.d88888 888 888
888Y88888P888 8888b. 888 888 88888b. .d88b. 888d888 88888b.d88b. 888 888 888888 .d88b.
888 Y888P 888 "88b 888 888 888 "88b d8P Y8b 888P" 888 "888 "88b 888 888 888 d8P Y8b
888 Y8P 888 .d888888 888 888 888 888 88888888 888 888 888 888 888 888 888 88888888
888 " 888 888 888 888 888 888 d88P Y8b. 888 888 888 888 Y88b 888 Y88b. Y8b.
888 888 "Y888888 888 888 88888P" "Y8888 888 888 888 888 "Y88888 "Y888 "Y8888
888 v1.1
888
888
By Hippie | https://twitter.com/hiippiiie

usage: mailpermute.py [-h] [-n NAME]
[-c CHECKERS]

options:
-h, --help show this help message
and exit
-n NAME, --name NAME Name of the person (e.g.
"John Doe") (default:
None)
-b BIRTHYEAR, --birthyear BIRTHYEAR
Birth year of the person (e.g. "1990") (default: None)
-c CHECKERS, --checkers CHECKERS
Checkers to use (e.g.
"gmail, yandex")
(default: all)
```

## Example output

```
$ ./mailpermute.py -n "Hippolyte Quere"

[+] [email protected]
[+] [email protected]
[+] [email protected]
[+] [email protected]
[+] [email protected]
[+] [email protected]
[+] [email protected]
[+] [email protected]

```

## How does it works ?

Mailpermute first creates different permutations from the name provided by the user. It creates permutations adding '-' '_' (note that mailpermute does not add '+' or '.' which can be added to any valid mail not changing the mail itself). Then Mailpermute is sending request to different providers to verify if the mail exist.

Feel free to contribute if you want to add more checkers to the tool !

*Project inspired from [Mailcat](https://github.com/sharsil/mailcat)*