mailrecon

Detect whether an email account exists using real provider validation flows (CLI tool)

Features

• Fast CLI-based validation
• Real signal detection, not regex or MX-only checks
• Provider-specific validation logic for supported providers such as Yahoo

Installation

pip install mailrecon

Usage

Single email

mailrecon validate user@yahoo.com
mailrecon validate user@gmail.com

Validate multiple emails:

mailrecon validate a@yahoo.com b@yahoo.com

Validate from a file:

mailrecon validate --file emails.txt

Get JSON output:

mailrecon validate --json user@gmail.com

Module execution is also supported:

python -m mailrecon validate email@yahoo.com
python -m mailrecon email@yahoo.com

Output

Default output:

email@yahoo.com → exists

JSON output:

[
  {
    "email": "user@gmail.com",
    "status": "exists"
  }
]

Possible statuses:

• exists
• does_not_exist
• unknown

Python API

from mailrecon import validate

status = validate("email@yahoo.com")
print(status)

Notes

• Validation is provider-specific and only works for supported domains.
• Different providers use different validation strategies. Some providers, like Yahoo, use deeper validation flows, while others may return results more directly.
• Live validation can return unknown when a provider changes behavior or blocks requests.