360 Secure SkillHub
360 安全技能中心

gmailcleaner

该 Skill 通过 gog CLI 读取 Gmail 收件箱、垃圾邮件、系统标签和自定义标签，支持按发件人、主题、内容和时间搜索，并以文本摘要展示结果；需先完成 gog 认证并设置 GOG_ACCOUNT。

coorops25
coorops25
热度 85.67
最近更新 2026-05-18 12:11:10
分类：协作依赖：代码执行 / 第三方 API / 读写文件应用场景：工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add gmailcleaner
Metadata
name
email-reader
version
2.0.0
description
Reads emails from Gmail (all folders/labels) using the gog CLI. Use when the user asks to check email, read inbox, show unread messages, list folders, search messages, or fetch emails from any Gmail label.
homepage
https://gogcli.sh
metadata
{"clawdbot":{"emoji":"📥","requires":{"bins":["gog"],"env":[{"name":"GOG_ACCOUNT","description":"Tu dirección de Gmail, ej: tu@gmail.com"}]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gogcli","bins":["gog"],"label":"Install gog CLI (brew)"}]}}

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)

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)

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

gog gmail search 'in:spam newer_than:30d' --max 50 --json

Leer una carpeta/etiqueta específica

# 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

# 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:

# 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