willwhite / freemail

A database of free and disposable email domains and a handy Node.js module for querying it.

freemail

A database of free and disposable email domains and a handy Node.js module for querying it.

Use the Node.js module or access the files in the ./data directory and parse with your language of choice.

In an effort to create the most up-to-date list of domains, the database can be synchronized with various lists from around the web. You can also add new domains directly by opening a pull request.

Database

There are three key data files in this project:

• free.txt contains a list of domains that are known to provide free email service
• disposable.txt contains a list of domains that are known to provide disposable email service
• blacklist.txt contains a list of domains that this project will refuse to add to either list

Domains may only be a member of one list.

Updating the database

Run ./update to pull in the latest domains from the sources listed in sources.txt. All new domains will be placed in free.txt by default. If any domains provide disposable email service, they may be moved to disposable.txt.

Node

Install

npm install --save freemail

var freemail = require('freemail');
freemail.isFree('[email protected]');
> true
freemail.isFree('[email protected]');
> true
freemail.isDisposable('[email protected]');
> false
freemail.isDisposable('[email protected]');
> true

Other

• freemail-cli is a CLI tool for filtering free and disposable emails

freemail's Issues

369 dead domains

withdrawn

domains to move from disposible to free list

I just checked out these domains that I found on the disposable list. They appear to redirect to gmx.de. I'm not sure, but they look more like free email services rather than disposable.

fantasymail.de
nurfuerspam.de

update never stop running

Hello, thanks for this.
I'm trying to update the lists using ./update however it seems I'm not able to.
I've tried several times and it seems the script take a huge amount of time around this block

for domain in $(cat $tmp); do
    result=`dig +short mx $domain`
    echo $result
    if [ -n "$result" ]; then
        echo $domain >> $confirmed
    fi
done

I'm not exactly sure what it is doing but it seems to me it is stuck in a cycle somehow

blacklist.txt has domains prepended with dot

The blacklist file is in a different format than the freemail.txt and disposable.txt files. I don't think it should not have the "period" in the domain name for consistency.

Webpack compatibility

Hey, this project looks great and I'd like to use it on the front-end but I'm having problems compiling it with Webpack. The main problem is that freemail is using fs to read the txt files, which isn't available to the browser. One possible solution would be to use json files and require them in directly.

protonmail.com is a free public email service

Add btinternet.com

Hi, please add btinternet.com free email provider, thx.

disposable-email-domains

Hello,

I found in disposable-email-domains package (https://github.com/ivolo/disposable-email-domains/blob/master/index.json) about 1000 disposable domains. Maybe you can merge this list or add this package to dependencies?

What do you think about it?

Vitaly

404 not found in one of the URLS in data/sources.txt due to typo

Hi

The URL https://gist.githubusercontent.com/defeated/6500068/raw/free_email_provider_domains.txt' on line 6 in sources.txt has 'quote' appended to it, if we use the URL as it is, it fails.

I believe It should be

https://gist.githubusercontent.com/defeated/6500068/raw/free_email_provider_domains.txt

without ending quote.

Regards.

Enable mechanisms for updating the free email domains in a running app

Thanks for providing this module, it's very useful. We'd like to have a mechanism to update the list of free email domains in a deployed application without deploying a new release. We've built a thin layer around this module so that the list of free email domains is stored in a database, which we query for each test of an email address. Should we need to update the list, DevOps can update the database for the running application.

We want to seed the database from this module. We could do this by locating the underlying data files in the file system, but the location of the files is not stable due to npm's dedupe & flatting of packages under node_modules. It would be nice if this module simply provided accessors for the underlying lists.

PR to follow.

Add housat.com to disposable list

http://www.throwawaymail.com/ produces emails at that domain

Add e.email

Minor issues

Just a couple of minor issues:

1. You have console.log statements in isFree(). These should probably be removed.
2. isDisposable is exported as isDisposible.

Thanks for the awesome library!

icloud.com freemail ?

i think its needs some kind of hardware to be free ?

Add reserved & special domains?

I know the title of the project is freemail, but might also be useful to have a reserved.txt for example.com and .org. But also some common ones like localhost, etc.

http://www.iana.org/domains/reserved
http://www.iana.org/assignments/special-use-domain-names/special-use-domain-names.xhtml

case

How do you handle case insensitivity of domain-names? I can't see it anywhere, for ascii it's quite easy, but for full UTF a bit more tricky I guess.

add nwytg.com to disposable dict

Hello,

Please add nwytg.com to disposable dictionary

Thx, Vitaly