protonmail-claw

# 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: [
    '--disable-blink-features=AutomationControlled',
    '--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:...