SkillHub

phishguard

v1.0.0

Monitorea las bandejas de Gmail y Outlook en busca de correos de phishing. Analiza cada correo entrante usando reglas estaticas e IA (Claude API). Asigna un puntaje de riesgo (BAJO/MEDIO/ALTO/CRITICO) y actua automaticamente: pone en cuarentena los correos sospechosos, alerta al usuario y envia noti...

Sourced from ClawHub, Authored by lichq1337

Installation

Please help me install the skill `phishguard` from SkillHub official store. npx skills add lichq1337/phishguard

Skill PhishGuard

Que hace este skill

Este skill monitorea automaticamente las bandejas de entrada en busca de ataques de phishing. Se ejecuta en segundo plano y revisa los correos nuevos en un intervalo configurable.

Cuando llega un correo nuevo, PhishGuard:

  1. Extrae remitente, asunto, cuerpo, URLs y cabeceras de autenticacion (SPF/DKIM)
  2. Ejecuta verificaciones de reglas estaticas (typosquatting, palabras de urgencia, URLs sospechosas, fallas de autenticacion)
  3. Envia el correo a la API de Claude para un analisis semantico de phishing
  4. Combina ambos puntajes en un nivel de riesgo final: BAJO / MEDIO / ALTO / CRITICO
  5. Toma la accion correspondiente segun el nivel de riesgo

Niveles de riesgo y acciones

Nivel de riesgo Puntaje Accion tomada
BAJO 0-24 Entrega normal, sin accion
MEDIO 25-49 Agrega etiqueta de advertencia al correo
ALTO 50-74 Cuarentena + alerta al usuario + notificacion a Slack/Teams
CRITICO 75-100 Cuarentena + alerta al usuario + notificacion a Slack/Teams + registro

Como invocar este skill

Podes pedirle a OpenClawd que ejecute PhishGuard de las siguientes formas:

  • "Inicia el monitoreo de phishing"
  • "Revisa mi bandeja en busca de phishing"
  • "Analiza este correo: [pegar correo]"
  • "Mostrame el reporte de PhishGuard de hoy"
  • "Detene el monitoreo de PhishGuard"

Como funciona internamente

El skill esta implementado en phishguard.js. Expone estas funciones principales:

  • startMonitoring(context) — inicia el ciclo de revision de correos en segundo plano
  • stopMonitoring(context) — detiene el ciclo de revision
  • analyzeEmail(emailData, context) — analiza un correo individual bajo demanda
  • getReport(context) — devuelve un resumen de las detecciones de la sesion actual

Cuando el monitoreo esta activo, el skill consulta Gmail cada N segundos (por defecto: 60) usando la herramienta de Gmail disponible en OpenClawd. Por cada correo no leido que no haya visto antes, ejecuta analyzeEmail() y actua segun el resultado.

Herramientas de OpenClawd requeridas

Este skill utiliza las siguientes herramientas que deben estar habilitadas en tu instancia de OpenClawd:

  • gmail:list-messages — listar mensajes no leidos
  • gmail:get-message — obtener el contenido completo y cabeceras del mensaje
  • gmail:modify-message — agregar etiquetas (cuarentena, advertencia)
  • slack:send-message O teams:send-message — enviar notificaciones de alerta (opcional)

Variables de entorno

Variable Requerida Por defecto Descripcion
ANTHROPIC_API_KEY Si — API key de Claude para el analisis de IA
SLACK_WEBHOOK_URL No — Webhook de Slack para alertas
TEAMS_WEBHOOK_URL No — Webhook de Teams para alertas
GMAIL_CHECK_INTERVAL_SECONDS No 60 Frecuencia de revision de Gmail en segundos
PHISHGUARD_QUARANTINE_LABEL No PhishGuard-Cuarentena Etiqueta de Gmail para correos en cuarentena

Formato de salida

Cuando se analiza un correo, PhishGuard reporta lo siguiente:

[PhishGuard] Riesgo: ALTO (puntaje: 67/100)
Remitente: [email protected]
Asunto:    URGENTE: Tu cuenta ha sido suspendida

Indicadores detectados:
  - CRITICO: El dominio del remitente imita a paypal.com
  - ALTO: Fallo en la validacion SPF
  - ALTO: El cuerpo solicita informacion sensible (contrasena, tarjeta de credito)
  - MEDIO: 4 palabras de urgencia detectadas

Analisis de IA: Este correo exhibe patrones clasicos de phishing dirigidos
a usuarios de PayPal. El dominio usa sustitucion de caracteres (paypa1 vs paypal).

Accion tomada: Correo en cuarentena + notificacion enviada a Slack.