Gmail Label Routing

该 Skill 提供一套本地 Python 脚本流程：按用户指定标签与一个或多个发件人，在 Gmail 中创建或复用标签、创建过滤规则、回溯应用到已有邮件，并默认将匹配邮件移出收件箱；支持保留在收件箱、替换同发件人已有过滤器以及模拟运行，最后输出结果 JSON。

1u1s4

热度 56.78

最近更新 2026-05-11 17:30:39

分类：协作依赖：代码执行 / 读写文件 / 第三方 API应用场景：工作流 / 任务管理

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add gmail-label-routing

Metadata

name: gmail-label-routing
description: Configurar en Gmail el enrutamiento por remitente hacia etiquetas usando el workflow local `scripts/gws_gmail_label_workflow.py`, incluyendo crear/usar etiqueta, crear filtro, aplicar retroactivo y opcionalmente sacar de INBOX. Usar cuando el usuario pida cosas como “manda este remitente a esta etiqueta”, “hazlo para varios remitentes”, “aplícalo a correos existentes”, “sácalos de INBOX”, o “limpia/reemplaza filtros duplicados para ese remitente”.

Gmail Label Routing

Overview

Estandarizar cambios de etiquetas por remitente en Gmail con un flujo único y consistente. Priorizar el script local para evitar inconsistencias manuales entre filtro, retroaplicación y estado de INBOX.

Workflow

Confirmar intención del usuario:

Etiqueta destino
Uno o varios remitentes
Si debe salir de INBOX (default: sí)
Si debe reemplazar filtros existentes del remitente (solo cuando lo pida o haya conflictos)

Ejecutar el workflow:

python3 scripts/gws_gmail_label_workflow.py \
  --label "<Etiqueta>" \
  --sender "correo1@dominio.com" \
  --sender "correo2@dominio.com"

scripts/gws_gmail_label_workflow.py es ruta relativa al directorio de esta skill.

Variantes comunes:

Mantener en INBOX: --keep-inbox
Reemplazar filtros del remitente: --replace-sender-filters
Simular sin cambios: --dry-run

Confirmar resultado con el JSON final del script:

createdFilterId
retroApplied
withLabelCount
inboxCount

Rules

Repetir --sender por cada remitente.
Mantener comillas en etiqueta y remitentes para evitar errores de parsing.
Usar --replace-sender-filters cuando haya mezcla por reglas duplicadas para el mismo remitente.
Si el usuario dice “haz lo mismo”, repetir el mismo patrón usado: etiqueta + filtro + retroactivo + manejo de INBOX.
Si hay fallo de scopes en gws para filtros, usar el fallback ya implementado dentro del workflow (credenciales OAuth locales).

Reference

Ver ejemplos listos en references/commands.md.