email-reader

# email-reader

## Cuándo usar
Usuario pide revisar inbox, buscar correos, leer mensajes, listar carpetas, o ver emails recientes.

## Backend A — gog CLI (preferido)

### Setup (una vez)
```bash
brew install steipete/tap/gogcli
gog auth credentials /ruta/credentials.json
gog auth add $GOG_ACCOUNT --services gmail
```

### Comandos
```bash
# No leídos (acción por defecto)
gog gmail search 'in:inbox is:unread' --max 5 --format minimal --json --no-input

# Búsqueda por criterio
gog gmail search '<query>' --max 10 --format minimal --json --no-input

# Correo completo
gog gmail get <ID> --format full --json --no-input

# Hilo completo
gog gmail thread <THREAD_ID> --format minimal --json --no-input
```

### Queries útiles
```bash
# Carpetas sistema
'in:inbox newer_than:1d'   'in:spam newer_than:30d'
'in:sent newer_than:7d'    'is:starred'

# Etiquetas personalizadas
'label:Clientes'  'label:Facturas newer_than:90d'

# Filtros
'from:juan@empresa.com is:unread'
'subject:propuesta newer_than:7d'
'has:attachment in:inbox newer_than:7d'
```

### Operadores Gmail
`from:` `to:` `subject:` `label:` `is:unread` `is:starred` `has:attachment`
`newer_than:Nd` `older_than:Nd` `in:inbox` `in:sent` `after:YYYY/MM/DD`

## Backend B — Python (fallback)

### Setup (una vez)
```bash
pip install google-api-python-client google-auth-oauthlib beautifulsoup4 cryptography
python3 scripts/auth.py   # OAuth → genera token.json cifrado
```

### Comandos
```bash
python3 scripts/fetch_emails.py --label INBOX --max 50
python3 scripts/fetch_emails.py --label INBOX --unread-only --max 20
python3 scripts/fetch_emails.py --label INBOX --since 2026-01-01
python3 scripts/fetch_emails.py --label INBOX --from juan@empresa.com
python3 scripts/fetch_emails.py --label SPAM  --max 100
python3 scripts/fetch_emails.py --label Clientes --max 30
python3 scripts/list_folders.py                     # listar etiquetas
python3 scripts/fetch_thread.py --thread-id <ID>   # hilo completo
python3 scripts/imap_fetch.py --hos...

# 📬 email-manager — OpenClaw Skills Pack v3.0

Pack de 6 skills para gestión completa de Gmail.
Cada skill tiene **dos backends**: `gog` CLI (preferido, sin dependencias) y scripts Python (fallback, más control).

---

## Skills

| Skill | Emoji | Función | Modelo |
|-------|-------|---------|--------|
| `email-reader` | 📬 | Leer inbox, buscar, hilos, IMAP | gemini-flash-lite |
| `email-organizer` | 🗂️ | Mover, archivar, etiquetar, reglas | gemini-flash |
| `email-analyzer` | 🤖 | Clasificar, phishing, prompts, tareas | claude-sonnet-4 |
| `email-responder` | ✉️ | Borradores, envíos, follow-up | claude-sonnet-4 |
| `email-scheduler` | ⏰ | Cron, heartbeat, envíos diferidos | gemini-flash-lite |
| `email-reporter` | 📊 | Informes, Sheets, audit log, undo | gemini-flash |

---

## Instalación

```bash
# 1. gog CLI (backend principal)
brew install steipete/tap/gogcli
gog auth credentials /ruta/credentials.json
gog auth add tu@gmail.com --services gmail,sheets,docs

# 2. Python (backend fallback)
pip install google-api-python-client google-auth-oauthlib \
            beautifulsoup4 cryptography python-dotenv anthropic

# 3. Skills en OpenClaw
cp -r email-manager/* ~/.openclaw/workspace/skills/
openclaw gateway restart
```

---

## Estructura de archivos

```
email-manager/
├── email-reader/
│   ├── SKILL.md              ← instrucciones del agente
│   └── scripts/
│       ├── auth.py           ← OAuth2 cifrado
│       ├── fetch_emails.py   ← leer correos (HTML, paginación, checkpoint)
│       ├── fetch_thread.py   ← hilo completo
│       ├── list_folders.py   ← etiquetas Gmail
│       └── imap_fetch.py     ← Outlook / Yahoo / IMAP genérico
├── email-organizer/
│   ├── SKILL.md
│   └── scripts/
│       ├── organizer.py      ← trash/archive/move/read/star (batch + undo)
│       ├── manage_labels.py  ← crear/renombrar/borrar etiquetas
│       └── rules_engine.py   ← motor de reglas automáticas
├── email-analyzer/
│   ├── SKILL.md
│   └── scripts/
│       ├── analyzer.py...