RetrieveEmail

• A tool to retrieve Domain email addresses from Search Engines
• Check the License

This project was inspired by:

• theHarvester(https://github.com/laramies/theHarvester) from laramies.
• search_email_collector(https://github.com/rapid7/metasploit-framework/blob/master/modules/auxiliary/gather/search_email_collector.rb) from Carlos Perez.

Requirements

• Python 3.x
• termcolor
• colorama
• requests
• validators

Features

• Retrieve Domain email addresses from popular Search engines (Google, Bing, Yahoo, ASK, Baidu, Dogpile, Exalead).
• Export results to txt and xml files.
• Limit search results.
• Define your own User-Agent string.
• Use proxy server.
• Plugins system.
• Search in popular web sites using Search engines (Twitter, LinkedIn, Google+, Github, Instagram, Reddit, Youtube).

Download/Installation

• git clone https://github.com/muneebwanee/RetrieveEmail
• pip install -r requirements.txt

Usage

usage: RetrieveEmail.py [-h] [-d DOMAIN] [-s FILE] [-e ENGINE] [-l LIMIT]
                         [-u USER-AGENT] [-x PROXY] [--noprint]


╔═══╗──╔╗────────────╔═══╗──────╔╗
║╔═╗║─╔╝╚╗───────────║╔══╝──────║║
║╚═╝╠═╩╗╔╬═╦╦══╦╗╔╦══╣╚══╦╗╔╦══╦╣║
║╔╗╔╣║═╣║║╔╬╣║═╣╚╝║║═╣╔══╣╚╝║╔╗╠╣║
║║║╚╣║═╣╚╣║║║║═╬╗╔╣║═╣╚══╣║║║╔╗║║╚╗
╚╝╚═╩══╩═╩╝╚╩══╝╚╝╚══╩═══╩╩╩╩╝╚╩╩═╝

    A tool to retrieve Domain email addresses from Search Engines | @muneebwanee
                                Version: 1.0.0

optional arguments:
  -h, --help            show this help message and exit
  -d DOMAIN, --domain DOMAIN
                        Domain to search.
  -s FILE, --save FILE  Save the results into a TXT and XML file (both).
  -e ENGINE, --engine ENGINE
                        Select search engine(google, bing, yahoo, ask, all).
  -l LIMIT, --limit LIMIT
                        Limit the number of results.
  -u USER-AGENT, --user-agent USER-AGENT
                        Set the User-Agent request header.
  -x PROXY, --proxy PROXY
                        Setup proxy server (example: http://127.0.0.1:8080)
  --noprint             RetrieveEmail will print discovered emails to terminal. 
						It is possible to tell RetrieveEmail not to print results to terminal with this option.
  -r EXCLUDED_PLUGINS, --exclude EXCLUDED_PLUGINS
                        Plugins to exclude when you choose 'all' for search engine (eg. '-r google,twitter')
  -p, --list-plugins    List all available plugins.

Examples

Search in Google

• ./RetrieveEmail.py -d example.com -e google

Search in site using Search engines

• ./RetrieveEmail.py -d example.com -e linkedin
• ./RetrieveEmail.py -d example.com -e twitter
• ./RetrieveEmail.py -d example.com -e googleplus

Search in all engines/sites

• ./RetrieveEmail.py -d example.com -e all

Search in all engines/sites but exclude some

• ./RetrieveEmail.py -d example.com -e all -r twitter,ask

Limit results

• ./RetrieveEmail.py -d example.com -e all -l 200

Export emails

• ./RetrieveEmail.py -d example.com -e all -l 200 -s emails.txt

Custom User-Agent string

• ./RetrieveEmail.py -d example.com -e all -u "MyUserAgentString 1.0"

Proxy Server

• ./RetrieveEmail.py -d example.com -e all -x http://127.0.0.1:8080

Docker

Alpine based Dockerfile

git clone https://github.com/muneebwanee/RetrieveEmail
cd RetrieveEmail
docker build -t RetrieveEmail .
docker run -it RetrieveEmail -d example.com