codex-team / email-provider

Detect email provider by address

Email provider service detector

Detect Provider's Service name by email address

[e-mail] -> { name: 'Gmail', url: 'https://googlemail.com' }
[e-mail] -> { name: 'Яндекс', url: 'https://yandex.ru' }

Why

It can be useful for improving User Experience after entering an email address:

1. User enters an email address
2. You have sent confirmation email to him
3. On the same place, you can show Open Gmail|Yahoo|Яндекс|etc button

How it words

1. Fetching DNS MX records for email address
2. Find MX host at the free email services datastore, collected by freemail
3. Find Service product name by its hostname (googlemail.com -> Gmail)

Usage

Install

npm i --save email-provider

or

yarn add email-provider

Connect and call

const emailProvider = require('email-provider');

let email = '[email protected]';

emailProvider.get(email)
     .then( service => {
       console.log(service.name); // Gmail
       console.log(service.url); // https://googlemail.com
     })
     .catch( error => {
       console.log('Email provider was not reached:', error);
     })

License

MIT

email-provider's Issues

Provide option to not fetch name

This would be much more useful to me if you made it optional to extract the name from the url. Unfortunately the name will not be stable and often times is something wack like Sign in to your Microsoft account. Really for my use case I need a stable enum of which provider this is e.g. outlook, yahoo, gmail