email-reader

# Email Reader Lee correos de Gmail usando el CLI `gog`. Requiere que `gog auth` esté configurado. Si no lo está, ejecuta el setup primero. ## Setup inicial (solo una vez) ```bash gog auth credentials /ruta/a/client_secret.json gog auth add $GOG_ACCOUNT --services gmail gog auth list # verificar que quedó bien ``` ## Cuándo usar esta skill - "Revisa mi correo" - "¿Qué correos nuevos tengo?" - "Muéstrame los no leídos de hoy" - "Lee los correos de Juan" - "Busca correos sobre la propuesta del Q1" - "¿Cuántos correos de spam tengo?" - "Muéstrame el hilo de [asunto]" - "Lee la carpeta Clientes" ## Comandos principales ### Leer inbox (correos recientes) ```bash gog gmail search 'in:inbox newer_than:1d' --max 20 --json gog gmail search 'in:inbox is:unread' --max 50 --json gog gmail search 'in:inbox newer_than:7d' --max 100 --json ``` ### Leer spam ```bash gog gmail search 'in:spam newer_than:30d' --max 50 --json ``` ### Leer una carpeta/etiqueta específica ```bash # Etiquetas de sistema gog gmail search 'in:sent newer_than:7d' --max 20 --json gog gmail search 'in:drafts' --max 20 --json gog gmail search 'in:trash newer_than:30d' --max 20 --json gog gmail search 'is:starred' --max 20 --json # Etiquetas personalizadas (carpetas del usuario) gog gmail search 'label:Clientes newer_than:30d' --max 20 --json gog gmail search 'label:Proyectos' --max 20 --json gog gmail search 'label:Facturas newer_than:90d' --max 20 --json ``` ### Buscar correos ```bash # Por remitente gog gmail search 'from:juan@empresa.com newer_than:30d' --max 20 --json # Por asunto gog gmail search 'subject:propuesta' --max 10 --json # Por contenido gog gmail search 'propuesta presupuesto 2026' --max 10 --json # Combinado gog gmail search 'from:ceo@empresa.com is:unread newer_than:7d' --max 10 --json # Con adjuntos gog gmail search 'has:attachment in:inbox newer_than:7d' --max 10 --json ``` ### Filtros de tiempo útiles | Filtro | Significado | |--------|-------------| | `newer_than:1d` | último día | | `newer_than:7d` | última semana | | `newer_than:30d` | último mes | | `older_than:180d` | más de 6 meses | | `after:2026/01/01` | desde fecha exacta | ## Presentación de resultados Después de obtener el JSON, presenta un resumen claro al usuario: ``` 📥 INBOX — 8 correos nuevos (3 no leídos) ⭐ [hoy 09:14] ceo@empresa.com "Reunión urgente esta tarde" 📧 [hoy 08:30] juan@empresa.com "Re: Propuesta Q1 2026" 📰 [ayer 18:00] newsletter@medium.com "Top 10 AI tools this week" ... ¿Quieres que analice estos correos o que responda alguno? ``` ## Múltiples cuentas Si el usuario tiene más de una cuenta de Gmail: ```bash # Listar cuentas configuradas gog auth list # Leer de una cuenta específica gog gmail search 'in:inbox is:unread' --account otra@gmail.com --max 20 --json # Cambiar cuenta por defecto export GOG_ACCOUNT=otra@gmail.com ``` ## Notas importantes - Usar siempre `--json` para obtener datos estructurados - Usar `--no-input` en modo automático/cron para evitar prompts interactivos - El flag `--max` limita resultados; aumentar si el usuario quiere más - Los resultados de búsqueda de Gmail usan la misma sintaxis que gmail.com