Email Reporter

email-reporter

Cuándo usar

Usuario pide resumen, estadísticas, reporte de correos, exportar a Sheets, ver historial de acciones, o deshacer.

Backend A — gog CLI (preferido)

Obtener datos para informes

# Diario
gog gmail search 'in:inbox newer_than:1d' --max 100 --json --no-input
gog gmail search 'in:spam  newer_than:1d' --max 100 --json --no-input
gog gmail search 'in:sent  newer_than:1d' --max 50  --json --no-input

# Semanal — cambiar 1d por 7d
# Spam stats (último mes)
gog gmail search 'in:spam newer_than:30d' --max 500 --json --no-input

# Sin respuesta (follow-up pendiente)
gog gmail search 'in:sent older_than:5d newer_than:30d' --max 100 --json --no-input

Exportar a Google Sheets

# Añadir filas de datos
gog sheets append <SHEET_ID> "Correos!A:F" \
  --values-json '[[fecha,remitente,asunto,categoria,prioridad,accion]]' \
  --insert INSERT_ROWS --no-input

# Leer sheet actual
gog sheets get <SHEET_ID> "Correos!A1:F100" --json --no-input

# Metadata del sheet
gog sheets metadata <SHEET_ID> --json --no-input

Columnas: Fecha | Remitente | Asunto | Categoría | Prioridad | Acción

Google Docs

gog docs cat <DOC_ID> --no-input
gog docs export <DOC_ID> --format txt --out /tmp/informe.txt --no-input

Deshacer última acción

# Buscar en papelera reciente
gog gmail search 'in:trash newer_than:1d' --max 100 --json --no-input
# Restaurar (confirmar primero)
gog gmail untrash <ID> --no-input

Backend B — Python (fallback)

# Informe diario
python3 scripts/reporter.py --period day

# Informe semanal
python3 scripts/reporter.py --period week

# Solo spam stats
python3 scripts/reporter.py --spam-only

# Exportar a Markdown
python3 scripts/reporter.py --period week --output informe_semanal.md

# Ver audit log
python3 scripts/reporter.py --audit --last 20

# Deshacer última acción
python3 scripts/reporter.py --undo

Archivo de prompts detectados: ~/.openclaw/workspace/prompts_log.md

Presentación de informes

📬 RESUMEN [HOY / SEMANA] — DD MMM YYYY
══════════════════════════════════════
Recibidos: N  │  Enviados: N  │  Sin respuesta: N
Spam:      N  │  Importantes: N

Top remitentes:
  1. newsletter@medium.com (N)
  2. juan@empresa.com (N)

Pendientes de respuesta:
  • cliente@empresa.com — "Cotización" (hace N días) ¿Follow-up?

⚠️ Prompts detectados esta semana: N → ver prompts_log.md
══════════════════════════════════════

Audit log

~/.openclaw/workspace/email_audit.log:

YYYY-MM-DD HH:MM | TRASH  | 87 correos | SPAM
YYYY-MM-DD HH:MM | MOVE   | 23 correos | INBOX → Facturas
YYYY-MM-DD HH:MM | SEND   |  1 correo  | Re: Propuesta Q1

Errores

• Sheet ID no encontrado → pedir ID al usuario (URL de Google Sheets)
• gog missing → brew install steipete/tap/gogcli
• Token expired → gog auth add <email>