Email automation driven by headless chrome.
This project is an early WIP, but the CLI currently works to automate Outlook.
npm install -g puppeteer-email-cli
Usage: puppeteer-email [options] [command]
Options:
-V, --version output the version number
-u, --username <username> email account username
-p, --password <password> email account password
-P, --provider <provider> email provider (default: outlook)
-H, --no-headless (puppeteer) disable headless mode
-s, --slow-mo <timeout> (puppeteer) slows down operations by the given ms (default: 0)
-h, --help output usage information
Commands:
signup [options]
signin
get-emails [options]
See the CLI for more in-depth CLI docs.
This example signs into an Outlook account, searches for a given query, and then parses and returns all emails returned for that query.
npm install --save puppeteer-email
const PuppeteerEmail = require('puppeteer-email')
const client = new PuppeteerEmail('outlook')
const username = 'XXX'
const password = 'XXX'
const session = await client.signin({ username, password })
const emails = await session.getEmails({ query: 'from:github' })
await session.close()
console.log(emails)
Example parsed email output:
[
{
"attachments": [ /* ... */ ],
"headers": { /* ... */ },
"html": "<!DOCTYPE html>\n<html>...</html>",
"text": "...",
"textAsHtml": "<p>...</p>",
"subject": "Example email subject",
"date": "2018-05-09T14:17:02.000Z",
"to": {
"value": [
{
"address": "[email protected]",
"name": "Travis Fischer"
}
],
"html": "<span class=\"mp_address_name\">Travis Fischer</span> <<a href=\"mailto:[email protected]\" class=\"mp_address_email\">[email protected]</a>>",
"text": "Travis Fischer <[email protected]>"
},
"from": {
"value": [
{
"address": "[email protected]",
"name": "GitHub"
}
],
"html": "<span class=\"mp_address_name\">GitHub</span> <<a href=\"mailto:[email protected]\" class=\"mp_address_email\">[email protected]</a>>",
"text": "GitHub <[email protected]>"
},
"messageId": "<01.B3.11399.xxxxxxxx@momentum1-mta1>"
}
]
See the library for more in-depth library docs.
See parse-email for details on email model properties.
Using this software to violate the terms and conditions of any third-party service is strictly against the intent of this software. By using this software, you are acknowledging this fact and absolving the author or any potential liability or wrongdoing it may cause. This software is meant for testing and experimental purposes only, so please act responsibly.
MIT © Travis Fischer
Support my OSS work by following me on twitter