# 🦠 Escáner Anti-Malware y Enlaces Sospechosos (VirusTotal API)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial revise cotizaciones adjuntas en correos, facturas comprimidas en `.zip` o enlaces enviados por supuestos clientes antes de que alguien en tu oficina les dé clic, analizándolos con más de 70 motores antivirus simultáneamente para evitar que infecten tu computadora con virus o secuestren tus archivos (*ransomware*).

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Detección de Malware y Seguridad Web |
| **Área Empresarial** | 07. Legal, Ciberseguridad y Prevención de Fraudes |
| **Nivel de Dificultad** | 🟢 Fácil |
| **Modelo de Costo** | Plan Comunitario Gratuito (hasta 500 análisis al día y 4 por minuto sin costo) |
| **Enlace Oficial** | [VirusTotal Developer API](https://docs.virustotal.com/reference/overview) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

El ataque más común a pequeñas empresas en Latinoamérica es el **Ransomware / Secuestro de Información**: un correo que dice *"Adjunto factura vencida de cobro jurídico urgente.pdf.exe"*. Cuando la secretaria lo abre asustada, toda la información de la empresa (facturas, base de clientes, contabilidad) se encripta y los criminales piden $5,000 USD para devolver los archivos.

Con **VirusTotal API**:
- La IA analiza el archivo sospechoso o el enlace antes de abrirlo.
- Lo somete al escaneo de 70 de las mejores empresas de seguridad del mundo (Kaspersky, Bitdefender, Microsoft Defender, Avast, etc.).
- Si 1 o más motores detectan peligro, la IA bloquea el archivo y te advierte con una alerta roja: 🛑 *"¡Peligro! Este archivo contiene un troyano de secuestro de datos. No lo abras y elimínalo de inmediato"*.

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Análisis con 70 Antivirus a la Vez**: Mucho más seguro que tener un solo antivirus instalado en tu PC.
- **Análisis de Enlaces Web (Phishing)**: Detecta páginas falsas de bancos o del SAT/DIAN diseñadas para robar contraseñas.
- **Cero Costo**: Su versión comunitaria es 100% gratuita para pequeñas empresas.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta gratuita en [VirusTotal.com](https://www.virustotal.com/).
2. Tu clave de API generada en tu perfil de usuario.

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tu backend o flujos de seguridad:

```env
# Variables de entorno (.env)
VIRUSTOTAL_API_KEY=1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Analista de Ciberseguridad y Detección de Amenazas.
Vamos a analizar un archivo sospechoso o enlace recibido por correo/WhatsApp mediante la API de VirusTotal.

Por favor, pregúntame:
1. ¿Deseas analizar un enlace web (URL), la huella digital de un archivo (Hash MD5/SHA256) o la dirección IP de un remitente?
2. ¿De qué fuente provino el archivo sospechoso (correo de remitente desconocido, mensaje de WhatsApp, descarga web)?

Con la información proporcionada, consultaré VirusTotal y te presentaré:
- Veredicto de Seguridad: (Seguro 🟢 | Sospechoso 🟡 | Malicioso 🔴).
- Número de motores antivirus que detectaron la amenaza (ej: 0/72 Limpio vs. 15/72 Malicioso).
- Tipo de amenaza identificada (Phishing, Troyano, Ransomware, Adware).
- Recomendación de acción inmediata para proteger tus equipos.
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Comercializadora Médica del Centro" (Insumos hospitalarios en Medellín, Colombia).
- **Problema**: Recibieron un correo con el logo falso de la DIAN diciendo que tenían una orden de embargo y un archivo adjunto `.zip` con la supuesta citación.
- **Resultado con la API**: Antes de descomprimirlo, pasaron el hash del archivo por VirusTotal. 48 antivirus lo marcaron como troyano bancario diseñado para robar credenciales de banca en línea. Salvaron las cuentas bancarias de la empresa.

---

## 🛡️ Regla de Oro

> [!CAUTION]
> **Nunca abras archivos con extensiones `.exe`, `.scr`, `.bat`, `.vbs`, `.iso` o archivos `.zip` protegidos con contraseña que te envíen remitentes desconocidos por correo o WhatsApp.**