Habilidades gws-gmail-watch
📦

gws-gmail-watch

Seguro

Monitore Gmail para Novos E-mails

Pare de perder e-mails importantes. Esta skill ajuda você a monitorar Gmail em tempo real e transmitir novas mensagens como dados estruturados para processamento automatizado.

Suporta: Claude Codex Code(CC)
🥉 73 Bronze
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "gws-gmail-watch". Monitore minha caixa de entrada do Gmail por novos e-mails

Resultado esperado:

  • Configurando Gmail watch para INBOX...
  • Tópico Pub/Sub criado: projects/my-project/topics/gmail-watch
  • Assinatura criada: projects/my-project/subscriptions/gmail-watch-sub
  • Monitorando novos e-mails (pressione Ctrl-C para parar)...
  • Mensagem recebida: {"historyId":"12345","email":{"id":"msg123","threadId":"thread456","snippet":"Olá..."}}

A utilizar "gws-gmail-watch". Monitore e-mails não lidos uma vez e saia

Resultado esperado:

  • Puxando mensagens do rótulo INBOX,UNREAD...
  • 3 mensagens puxadas
  • Processamento completo
  • Execute novamente para renovar o monitoramento (expira em 7 dias)

Auditoria de Segurança

Seguro
v1 • 4/21/2026

Static analysis detected 20 potential security issues, all of which are false positives after manual review. The external_commands detections are documentation code blocks (bash examples), filesystem detections are markdown hyperlink references (../ paths), and weak crypto detections are false positives on version numbers. This is documentation-only content with no executable code.

1
Arquivos analisados
60
Linhas analisadas
2
achados
1
Total de auditorias
Problemas de Baixo Risco (2)
SKILL.md:22-48
Documentation Code Blocks Trigger Static Scanner
Static scanner flagged 15 external_commands patterns in SKILL.md lines 16, 22-39, 43. These are markdown code blocks containing bash command examples (gws gmail +watch), not executable code. No actual command execution occurs.
SKILL.md:16SKILL.md:58-59
Markdown Hyperlinks Trigger Path Traversal Scanner
Static scanner flagged 3 filesystem patterns at SKILL.md lines 16, 58, 59. These are relative path references in markdown links (e.g., ../gws-shared/SKILL.md) for navigation, not actual filesystem operations.
Auditado por: claude

Pontuação de qualidade

38
Arquitetura
100
Manutenibilidade
87
Conteúdo
50
Comunidade
100
Segurança
83
Conformidade com especificações

O Que Você Pode Construir

Pipeline Automatizado de Processamento de E-mail

Configure monitoramento em tempo real para capturar e-mails importantes e acionar fluxos de trabalho automatizados como extração de dados de recibos, faturas ou notificações.

Monitor de Resposta ao Cliente

Monitore e-mails de suporte de alta prioridade e alerte a equipe instantaneamente quando mensagens críticas chegarem na caixa de entrada de suporte.

Cão de Guarda da Caixa de Entrada Pessoal

Monitore seu Gmail pessoal para remetentes ou rótulos específicos e receba saída NDJSON para registro ou análise em ferramentas de produtividade.

Tente Estes Prompts

Monitoramento Básico de Caixa de Entrada 
Monitore minha caixa de entrada do Gmail por novos e-mails e mostre-os conforme chegarem. Quero ver a saída no terminal.
Filtrar por Rótulo 
Monitore apenas e-mails não lidos no meu rótulo INBOX do Gmail. Puxe mensagens a cada 10 segundos e pare após encontrar 5 mensagens.
Salvar em Arquivos 
Monitore meu Gmail por novos e-mails e salve cada mensagem em um arquivo JSON separado no diretório ./emails. Limpe recursos quando terminar.
Usar Assinatura Pub/Sub Existente 
Conecte-se à minha assinatura Pub/Sub existente em projects/my-project/subscriptions/email-sub e puxe mensagens uma vez.

Melhores Práticas

  • Use a flag --cleanup durante os testes para evitar deixar recursos Pub/Sub órfãos no seu projeto GCP
  • Renove seu Gmail watch a cada 7 dias para manter monitoramento ininterrupto
  • Comece com a flag --once para testar sua configuração antes de executar o monitor contínuo
  • Especifique --label-ids para filtrar mensagens e reduzir ruído de rótulos irrelevantes

Evitar

  • Não execute sem --cleanup em testes de produção, a menos que você queira que os recursos Pub/Sub persistam
  • Não defina --max-messages muito alto, pois pode causar problemas de memória com grandes lotes de e-mails
  • Não esqueça de configurar permissões adequadas do projeto GCP antes de executar o comando watch
  • Não use --poll-interval abaixo de 1 segundo para evitar limitação de taxa da API do Gmail

Perguntas Frequentes

O que esta skill realmente faz?
Esta skill monitora sua caixa de entrada do Gmail e transmite novos e-mails como dados NDJSON. Ela usa o Google Workspace CLI para configurar notificações push via Pub/Sub e puxa mensagens conforme chegam.
Preciso instalar algo?
Sim, você precisa ter a ferramenta CLI gws instalada. Esta skill requer um binário externo que não está incluído no Claude Code.
Quanto tempo dura o monitoramento?
As assinaturas do Gmail watch expiram após 7 dias. Você deve executar o comando novamente para renovar o monitoramento e continuar recebendo novos e-mails.
O que é o formato de saída NDJSON?
NDJSON significa Newline-Delimited JSON. Cada e-mail aparece como um objeto JSON separado em sua própria linha, facilitando o parsing por scripts ou ferramentas de dados.
Posso filtrar rótulos de e-mail específicos?
Sim, use a flag --label-ids com nomes de rótulos separados por vírgula como INBOX,UNREAD ou IDs de rótulos personalizados para filtrar quais e-mails acionam notificações.
O que acontece com os recursos Pub/Sub quando eu paro?
Por padrão, tópicos e assinaturas Pub/Sub persistem para reconexão. Use --cleanup para excluí-los automaticamente quando você sair do monitor.

Detalhes do Desenvolvedor

Licença

MIT

Repositório

https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-watch/

Referência

main

Estrutura de arquivos

📄 SKILL.md