Skill: christopher-schulze/protonmail-claw (version 1.0.1)

--- name: protonmail-claw title: ProtonMail description: Manage ProtonMail emails via Playwright browser automation. Login, read, send, and manage your encrypted inbox. homepage: https://proton.me/mail metadata: {"clawdbot":{"emoji":"📧","requires":{"bins":["playwright","node"]},"install":[{"id":"npm","kind":"npm","package":"playwright","bins":["npx playwright"],"label":"Install Playwright (npm)"},{"id":"chromium","kind":"exec","command":"npx playwright install chromium","label":"Install Chromium browser"}]}} --- # ProtonMail 📨 Your encrypted inbox, automated. Because checking emails manually is so 2010. ## What it does - **Login** to any ProtonMail account securely - **Read** emails from your inbox - **Send** new emails with compose functionality - **Manage** your mailbox like a pro All via Playwright browser automation. No API keys, no IMAP/SMTP headaches - just a real browser doing real browser things. ## Why this exists You have better things to do than clicking through ProtonMail's beautiful (but slow) UI. Let your agent handle it. While you relax. Or code. Or whatever it is you do. We built this because: 1. ProtonMail's web UI is... leisurely 2. Automation is hot 3. Why click when you can script? ## Requirements ### The Basics - **Node.js** 18+ (20+ recommended) - **Playwright** 1.40+ (`npm install playwright`) - **Chromium** browser (`npx playwright install chromium`) ### System Dependencies (Linux) ```bash # Ubuntu/Debian sudo apt-get update sudo apt-get install -y libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2 libpango-1.0-0 libcairo2 # Raspberry Pi / ARM sudo apt-get install -y chromium-browser ``` ### The Secret Sauce (Bot Detection Bypass) This skill includes enterprise-grade bot detection evasion: ```javascript // Launch with stealth args await chromium.launch({ headless: true, args: [ [REDACTED_SECRET], '--no-sandbox', '--disable-setuid-sandbox', '--disable-dev-shm-usage' ] }); // Hide webdriver property await page.addInitScript(() => { Object.defineProperty(navigator, 'webdriver', { get: () => undefined }); }); ``` This makes Chrome think it's being controlled by a human. Mostly works. ✨ ## Quick Start ### 1. Login ```javascript const { chromium } = require('playwright'); async function loginProton(email, password) { const browser = await chromium.launch({ headless: true, args: [[REDACTED_SECRET], '--no-sandbox'] }); const context = await browser.newContext({ userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36', }); const page = await context.newPage(); await page.addInitScript(() => { Object.defineProperty(navigator, 'webdriver', { get: () => undefined }); }); await page.goto('https://account.proton.me/login'); await page.waitForTimeout(2000); await page.fill('#username', email); await page.fill('#password', password); await page.click('button[type=submit]'); await page.waitForTimeout(3000); return { browser, context, page }; } ``` ### 2. Check Inbox ```javascript await page.goto('https://mail.proton.me/inbox'); await page.waitForTimeout(2000); const emails = await page.evaluate(() => { return Array.from(document.querySelectorAll('.item')).map(e => ({ subject: e.querySelector('.subject')?.innerText, sender: e.querySelector('.sender')?.innerText, time: e.querySelector('.time')?.innerText })); }); console.log(emails); ``` ### 3. Read Email ```javascript await page.click('.item:first-child'); await page.waitForTimeout(2000); const content = await page.evaluate(() => document.querySelector('.message-content')?.innerText ); ``` ### 4. Send Email (Tested & Working) ```javascript // Navigate to compose await page.goto('https://mail.proton.me/compose'); await page.waitForTimeout(3000); // Use keyboard navigation (most reliable) // Tab to recipient field await page.keyboard.press('Tab'); await page.waitForTimeout(500); // Type recipient await page.keyboard.type('[REDACTED_SECRET]'); await page.waitForTimeout(500); // Tab to subject await page.keyboard.press('Tab'); await page.waitForTimeout(500); // Type subject await page.keyboard.type('Your subject here'); await page.waitForTimeout(500); // Tab to body await page.keyboard.press('Tab'); await page.waitForTimeout(500); // Type message await page.keyboard.type('Your message here...'); // Send with Ctrl+Enter await page.keyboard.press('Control+Enter'); await page.waitForTimeout(3000); ``` ### 5. Logout (please, it's polite) ```javascript await page.click('button[aria-label="Settings"]'); await page.click('text=Sign out'); await browser.close(); ``` ## Environment Variables Don't hardcode passwords (seriously, don't): ```bash export PROTON_EMAIL="[REDACTED_SECRET]" export PROTON_PASSWORD="yourpassword" ``` Then in code: ```javascript const email = process.env.PROTON_EMAIL; const [REDACTED_SECRET]; ``` ## Complete Example ```javascript const { chromium } = require('playwright'); async function main() { const email = process.env.PROTON_EMAIL || '[REDACTED_SECRET]'; const [REDACTED_SECRET] || 'yourpassword'; const browser = await chromium.launch({ headless: true, args: [[REDACTED_SECRET], '--no-sandbox'] }); const context = await browser.newContext({ userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36', }); const page = await context.newPage(); await page.addInitScript(() => { Object.defineProperty(navigator, 'webdriver', { get: () => undefined }); }); // Login await page.goto('https://account.proton.me/login'); await page.fill('#username', email); await page.fill('#password', password); await page.click('button[type=submit]'); await page.waitForTimeout(5000); // Go to compose await page.goto('https://mail.proton.me/compose'); await page.waitForTimeout(3000); // Send email using keyboard navigation (most reliable) await page.keyboard.press('Tab'); await page.keyboard.type('[REDACTED_SECRET]'); await page.keyboard.press('Tab'); await page.keyboard.type('Test Subject'); await page.keyboard.press('Tab'); await page.keyboard.type('Hello! This is a test email.'); await page.keyboard.press('Control+Enter'); await page.waitForTimeout(3000); console.log('📧 Email sent!'); await browser.close(); } main(); ``` ## Limitations - **2FA**: Can't do 2FA via automation (use a browser on your device for initial login, then cookie session) - **Rate limiting**: ProtonMail might throttle you if you go crazy - **Dynamic UI**: Class names change. Use text selectors or ARIA when possible - **Headless detection**: Works mostly, but Proton might occasionally notice ## Troubleshooting ### "chromium not found" ```bash npx playwright install chromium ``` ### Bot detection / Login fails - Verify bot detection bypass is enabled - Check user agent string is current - Try headed mode for testing ### Timeout errors - Increase waitForTimeout values - Check your internet - ProtonMail might be rate limiting ### "libX11 not found" Install system dependencies (see Requirements section) ## Security Notes - 🔒 Credentials should come from environment variables, not hardcoded - 🔑 Use app-specific passwords if ProtonMail supports them - 📝 Always logout when done - 🍪 Session cookies can be saved for re-use (advanced) --- **Made with 🦞🔒** *From Claws for Claws. Because reading emails manually is for plebs.* *HQ Quality Approved.*


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (HIGH)