Skip to main content

Advanced Email Enumeration & Validation Tool

Project description

Advanced Email Enumeration & Validation Tool

EnumURL Status License Python

This is an advanced tool for email enumeration and validation, designed to help you identify potentially valid email addresses from a given domain. It uses various techniques, including generating email patterns, checking SMTP validity, verifying reputation, and cross-referencing with services like Have I Been Pwned and PyHunter.

Features:

  • Email Generation: Generates potential email addresses based on common naming patterns.
  • SMTP Validation: Checks if the generated email addresses are valid via SMTP.
  • HaveIBeenPwned Integration: Checks if the email has been compromised in any known data breaches using the HaveIBeenPwned API.
  • Email Reputation Check: Validates the reputation of the email addresses to identify potentially risky ones.
  • Tor Integration: Supports anonymous requests via Tor to ensure privacy.
  • Proxy Support: Allows you to use a list of proxies for the email validation process.
  • API Integrations: Supports integration with services like PyHunter for email discovery.

Installation

Clone the repository:

git clone https://github.com/hemaabokila/email-enumeration-validation.git
cd email-enumeration-validation
pip install .

You can install the tool using pip:

sudo install emailev

Usage

You can run the tool via the command line interface. Below are the available options:

usage: email [-h] -d DOMAIN -n NAMES
             [-a APIKEY] [--use-tor]
             [--tor-port TOR_PORT]
             [--tor-control-port TOR_CONTROL_PORT]
             [--proxy-file PROXY_FILE]
             [--apikey-pyhunter APIKEY_PYHUNTER]
             [--save {txt,json,csv}]

Options:

-h, --help

Show this help message and exit.

-d DOMAIN, --domain DOMAIN

Target domain (e.g., example.com). This option is required.

-n NAMES, --names NAMES

File containing first and last names (one per line, space-separated). This option is required.

-a APIKEY, --apikey APIKEY

API Key for HaveIBeenPwned (optional). If you want to check email addresses against the HaveIBeenPwned database, you need to provide this API key.

--use-tor

Use Tor for anonymity. This will route your requests through the Tor network to ensure privacy.

--tor-port TOR_PORT

Tor SOCKS port (default: 9050). This is the port used to connect to the Tor network.

--tor-control-port TOR_CONTROL_PORT

Tor Control port for IP renewal (default: 9051). This allows you to request a new IP address from the Tor network.

--proxy-file PROXY_FILE

File containing a list of HTTP/HTTPS proxies (one per line). This will be used to route requests via the specified proxies.

--apikey-pyhunter APIKEY_PYHUNTER

API Key for PyHunter (optional). If you want to search for emails using the PyHunter service, you need to provide this API key.

--save {txt,json,csv}

Save results to file in the specified format (txt, json, or csv). If you choose to save the results, they will be written to the corresponding file format.

Example Usage

Basic usage with a domain and names file:

email -d example.com -n names.txt

Using Tor for anonymity:

email -d example.com -n names.txt --use-tor

Using proxies from a file:

email -d example.com -n names.txt --proxy-file proxies.txt

Using HaveIBeenPwned API for data breach checks:

email -d example.com -n names.txt -a YOUR_HIBP_API_KEY

Saving results to a CSV file:

email -d example.com -n names.txt --save csv

🔧 Requirements

  • Python 3.7+
  • socks, requests, aiohttp, pyhunter, stem

📜 License

License This project is open-source and licensed under the MIT License.

🤝 Contributing

Contributions are welcome! Feel free to open a Pull Request to enhance the tool.

📬 Contact

📧 For inquiries and support: LinkedIn

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

emailev-1.0.0.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

emailev-1.0.0-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

File details

Details for the file emailev-1.0.0.tar.gz.

File metadata

  • Download URL: emailev-1.0.0.tar.gz
  • Upload date:
  • Size: 9.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.0

File hashes

Hashes for emailev-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ca49856584efac95817ee370815871d2a3b73d55aa29635aff5a1b2509df4661
MD5 e9df6984c3260332a57604a3e5268018
BLAKE2b-256 620996d7c1a3913784ffb8fe8b73b9d5a7e161a50958a101add1030e32f2e247

See more details on using hashes here.

File details

Details for the file emailev-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: emailev-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 12.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.0

File hashes

Hashes for emailev-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3b5b9b8e8a68c3bca9b28914c3fc281fd2e76b03ab5631ac3f0b07e9e7dacff7
MD5 b637b8ec3ea389c5658f55e704aa659b
BLAKE2b-256 6302beaf71e130e16dafdb4b655e5045b3e905953d78d01b4b3957952256486b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page