- **Huella Digital Multimétodo**: Detecta WordPress 4.x-6.x con cero falsos positivos
- **Correlación de CVE en Tiempo Real**: Verifica cada plugin, tema y versión del núcleo detectado contra WPVulnerability.net (gratuito, sin clave API)
- **Puntuación CVSS**: Obtiene puntuaciones de NVD para cada CVE (crítico ≥9.0, alto ≥7.0, medio ≥4.0)
- **Detección de Última Versión**: La API de WordPress.org muestra la versión estable actual junto con la versión detectada
- **OWASP Top 10 2021**: Cada hallazgo mapeado a su categoría OWASP (A01–A10)
- **Escaneo Concurrente**: Grupo de hilos + limitación de tasa para escaneos rápidos y respetuosos
- **Detección Inteligente**: Aborto temprano para sitios que no son WordPress (rechazo 99% más rápido)
- **Recopilación de Evidencias**: Respuestas HTTP, cabeceras y contenidos de archivos preservados

### 📈 Informes de Diferencias de Escaneo (v0.2.0)

Seguimiento del progreso de remediación entre escaneos:```bash
# Compare this scan against the previous one
python -m argus --target https://example.com --html --diff last

# Or reference a specific scan ID
python -m argus --target https://example.com --html --diff 42

**Informes HTML** (Amigable para humanos, v0.2.0)

- 🎨 Diseño responsivo con CSS en línea (sin dependencias externas)
- 🏷️ Insignias de severidad codificadas por color + barra de filtro interactiva
- 🔴 Insignias CVE que enlazan a NVD, insignias CWE moradas (deduplicadas)
- 🟣 Insignia OWASP Top 10 2021 por hallazgo
- 🟢 Insignia de última versión estable para componentes vulnerables
- 📊 Insignia de puntuación CVSS codificada por color por CVE (rojo/naranja/amarillo/verde)
- 📝 Paneles de detalles CVE expandibles, recomendaciones expandibles
- 🔧 Fragmentos de configuración de encabezados de seguridad (Apache / Nginx / WordPress)
- 📈 Sección de diferencias (nuevo/corregido/persistente) con advertencia de discrepancia de modo
- 🤖 Análisis de IA con pestañas (ejecutivo / técnico / agente)
- 📱 Compatible con móviles

### 🔐 Sistema de Token de Consentimiento

Argus fomenta la piratería ética a través de la tecnología. El escaneo agresivo y el análisis de IA requieren **prueba de propiedad**:```bash
# 1. Generate token
python -m argus --gen-consent example.com

# 2. Place token on your server
echo "verify-abc123..." > .well-known/verify-abc123.txt

# 3. Verify ownership
python -m argus --verify-consent http --domain example.com --token verify-abc123

# 4. Now you can use aggressive mode
python -m argus --target https://example.com --aggressive --use-ai

---

## 🚀 Inicio Rápido

### Requisitos previos

- **Python 3.11+** (3.12 recomendado)
- **pip** (Gestor de paquetes de Python)
- **Docker** (opcional, para escaneo con contenedores)

### Instalación

**1. Clona el repositorio**```bash
git clone https://github.com/rodhnin/argus-wp-watcher.git
cd argus-wp-watcher

**3. Crear y activar el entorno virtual**```bash
python3 -m venv .venv
source .venv/bin/activate
# You should see (.venv) in your terminal prompt

**5. Instalar dependencias**```bash
python -m pip install -r requirements.txt

**7. Verificar instalación**```bash
python -m argus --version
# Output: Argus v0.2.0

**🎉 ¡Éxito!** Revisa `~/.argos/reports/` para tus informes.

---

## 📘 Guía de Uso

### Escaneo Básico```bash
# Safe mode (default) - Non-intrusive checks
python -m argus --target https://example.com

# Generate HTML report
python -m argus --target https://example.com --html

# Increase verbosity for debugging
python -m argus --target https://example.com -vv

### Análisis impulsado por IA

**Paso 1: Configura tu clave API**```bash
export OPENAI_API_KEY="sk-..."

**Paso 3: Ejecutar escaneo con IA**```bash
# Both analyses in one scan (~$0.006 with default model)
python -m argus --target https://example.com --use-ai --html

# Technical only (for security teams)
python -m argus --target https://example.com --use-ai --ai-tone technical --html

# Executive only (for management)
python -m argus --target https://example.com --use-ai --ai-tone non_technical --html

# Override model or provider at runtime
python -m argus --target https://example.com --use-ai --ai-model gpt-4o --html
python -m argus --target https://example.com --use-ai --ai-provider anthropic --html

# Stream output in real time
python -m argus --target https://example.com --use-ai --ai-stream

# Agent mode with NVD CVE lookup (free)
python -m argus --target https://example.com --use-ai --ai-agent --html

# Compare two providers side by side
python -m argus --target https://example.com \
  --use-ai --ai-compare openai,anthropic --html

# Budget cap ($0.05 max)
python -m argus --target https://example.com --use-ai --ai-budget 0.05

---

## 🤖 Análisis impulsado por IA

Argus utiliza **LangChain 1.0.0** con soporte para múltiples proveedores de IA, brindándole flexibilidad según sus requisitos de seguridad, privacidad y presupuesto.

### Proveedores compatibles

#### OpenAI GPT-4 Turbo

**Mejor para: Uso en producción**

- ⭐ Calidad: Excelente (5/5)
- ⚡ Velocidad: ~35 segundos
- 💰 Costo: ~$0.25 por escaneo
- 🔒 Privacidad: Estándar (datos cifrados en tránsito)```bash
export OPENAI_API_KEY="sk-..."
python -m pip install langchain-openai==1.0.0

#### Ollama (Modelos Locales)

**Mejor para: Privacidad completa**

- ⭐ Calidad: Buena (3/5)
- 🐢 Velocidad: ~28 minutos (CPU) o ~75 segundos (GPU)
- 💰 Coste: Gratuito
- 🔐 Privacidad: 100% sin conexión (los datos nunca salen de tu máquina)```bash
# Install Ollama: https://ollama.ai
ollama pull llama3.2
python -m pip install "langchain-ollama>=0.3.0,<0.4.0"

**Opción B — `config/defaults.yaml` (cambiar el predeterminado persistente)**```yaml
ai:
    langchain:
        provider: "ollama" # Changed from "openai"
        model: "llama3.2" # Ollama model
        ollama_base_url: "http://localhost:11434"

---

## 🧪 Laboratorio de Pruebas Seguras

**⚠️ NUNCA escanees sitios de producción sin permiso por escrito.**

Usa nuestro laboratorio Docker para practicar de forma segura:

### Configurar Entorno de Pruebas```bash
# Navigate to docker directory
cd docker

# Option 1: Use interactive script
./deploy.sh
# Select option 2 (Testing Lab)

# Option 2: Manual deployment
docker compose -f compose.testing.yml up -d

# Wait for services to start (~60-90 seconds)
docker compose -f compose.testing.yml logs -f wordpress

# Setup WordPress
# Open http://localhost:8080 in your browser
# Complete WordPress installation
# Username: admin
# Password: (choose a strong password)

# Create vulnerable conditions for testing
docker compose -f compose.testing.yml exec wordpress bash -c \
  "cp /var/www/html/wp-config.php /var/www/html/wp-config.php.bak"

### Limpieza```bash
cd docker
docker compose -f compose.testing.yml down -v  # -v removes all data

**Opciones del menú:**

- `1` → Solo escáner de producción
- `2` → Solo laboratorio de pruebas (WordPress + MariaDB)
- `3` → Ambos entornos
- `4` → Detener todos los servicios
- `5` → Eliminar todos los contenedores y datos (restablecer)

---

### Opción 1: Escáner de producción

Desplegar solo el escáner Argus para escanear sitios WordPress externos:```bash
cd docker
./deploy.sh
# Select option 1

**Escanear un objetivo:**```bash
docker compose exec argus python -m argus --target https://example.com

**Detener:**```bash
docker compose down

**O manualmente:**```bash
docker compose -f compose.testing.yml up -d

**Detener y eliminar:**```bash
docker compose -f compose.testing.yml down -v

**Qué se despliega:**

- ✅ Escáner Argus de producción
- ✅ Base de datos MariaDB
- ✅ WordPress 6.0 (vulnerable)
- ✅ Conexión entre el escáner de producción y la red de pruebas

**Escanear sitios externos desde el escáner de producción:**```bash
docker compose exec argus python -m argus --target https://example.com

**Detener todo:**```bash
cd docker
./deploy.sh
# Select option 4

### Esquema de informe JSON```json
{
    "tool": "argus",
    "version": "0.2.0",
    "target": "https://example-wp-site.com",
    "date": "2026-04-15T18:45:30Z",
    "mode": "safe",
    "summary": {
        "critical": 1,
        "high": 2,
        "medium": 4,
        "low": 3,
        "info": 5
    },
    "findings": [
        {
            "id": "ARGUS-WP-012",
            "title": "Vulnerable plugin: contact-form-7 v5.3.1 (6 CVEs)",
            "severity": "critical",
            "confidence": "high",
            "owasp": { "id": "A06", "name": "Vulnerable and Outdated Components" },
            "latest_version": "5.9.8",
            "cve": ["CVE-2021-39346", "CVE-2020-35489"],
            "vulnerabilities": [
                {
                    "title": "Contact Form 7 < 5.3.2 — Unrestricted File Upload",
                    "cvss": 9.8,
                    "cve_id": "CVE-2020-35489",
                    "cwe": ["CWE-434"]
                }
            ],
            "description": "Plugin 'contact-form-7' v5.3.1 has 6 known CVEs. Highest CVSS: 9.8 (Critical).",
            "evidence": {
                "type": "path",
                "value": "https://example-wp-site.com/wp-content/plugins/contact-form-7/readme.txt",
                "context": "Version detected via readme.txt"
            },
            "recommendation": "Update contact-form-7 to 5.9.8 (latest stable). Immediate action required.",
            "affected_component": "contact-form-7 5.3.1"
        },
        {
            "id": "ARGUS-WP-030",
            "title": "wp-config.php backup exposed",
            "severity": "critical",
            "confidence": "high",
            "owasp": { "id": "A05", "name": "Security Misconfiguration" },
            "description": "WordPress configuration file backup is publicly accessible.",
            "evidence": {
                "type": "url",
                "value": "https://example-wp-site.com/wp-config.php.bak",
                "context": "HTTP 200, Size: 2847 bytes"
            },
            "recommendation": "Remove immediately and rotate all credentials.",
            "affected_component": "wp-config.php.bak"
        },
        {
            "id": "ARGUS-WP-050",
            "title": "Missing security header: HSTS",
            "severity": "medium",
            "confidence": "high",
            "owasp": { "id": "A02", "name": "Cryptographic Failures" },
            "description": "HSTS header is not set.",
            "evidence": {
                "type": "header",
                "value": "Strict-Transport-Security: [not set]",
                "context": "Header missing in HTTP response"
            },
            "recommendation": "Add: Strict-Transport-Security: max-age=31536000; includeSubDomains; preload"
        }
    ],
    "diff": {
        "ref_scan_id": 41,
        "ref_date": "2026-04-10T10:00:00Z",
        "ref_mode": "safe",
        "current_mode": "safe",
        "mode_mismatch": false,
        "new": [{ "id": "ARGUS-WP-012", "title": "Vulnerable plugin: contact-form-7...", "severity": "critical" }],
        "fixed": [],
        "persisting": [{ "id": "ARGUS-WP-050", "title": "Missing security header: HSTS", "severity": "medium" }]
    },
    "notes": {
        "scan_duration_seconds": 26.4,
        "requests_sent": 312,
        "rate_limit_applied": true,
        "scope_limitations": "Scan limited to publicly accessible pages.",
        "false_positive_disclaimer": "Manual verification recommended before remediation."
    }
}

---

## 🗺️ Hoja de Ruta

### v0.1.0 — Lanzamiento Inicial ✅ (Noviembre de 2025)

**Estado:** 🎉 **Lanzado**

- ✅ Escáner de seguridad completo para WordPress (130+ comprobaciones)
- ✅ Análisis impulsado por IA (OpenAI, Anthropic, Ollama)
- ✅ Sistema de tokens de consentimiento (verificación HTTP + DNS)
- ✅ Informes profesionales (JSON + HTML)
- ✅ Persistencia SQLite e historial de escaneos
- ✅ Soporte Docker con laboratorio vulnerable
- ✅ Manejo integral de errores y resiliencia

### v0.2.0 — Detección Mejorada e IA ✅ (Mayo de 2026)

**Estado:** 🎉 **Lanzado**

- ✅ **Detección de Versión de Plugins**: Método en cascada de 4 vías (HTML ?ver=, readme.txt, changelog, cabecera PHP)
- ✅ **Correlación de CVE en Tiempo Real**: WPVulnerability.net (gratuito, sin clave) para plugins, temas y núcleo de WP
- ✅ **Puntuación CVSS**: API de NVD — insignias con código de colores crítico/alto/medio/bajo por CVE
- ✅ **Última Versión**: API de WordPress.org muestra la versión estable actual junto con la versión detectada
- ✅ **Mapeo OWASP Top 10 2021**: Cada hallazgo mapeado a A01–A10 con insignia en el informe HTML
- ✅ **Informes HTML Mejorados**: Insignias CVE/CWE/OWASP/CVSS, barra de filtros, fragmentos de configuración, paneles expandibles
- ✅ **Informes de Diferencias de Escaneo**: `--diff last` / `--diff ID` con nuevo/corregido/persistente, advertencia de discrepancia de modo
- ✅ **Modo Agresivo**: 447 plugins, 437 rutas, seguridad de inicio de sesión (2FA/CAPTCHA/fuerza bruta), rastreo web
- ✅ **Seguimiento de Costos de IA**: Control de presupuesto, `~/.argos/costs.json`, registros de costos en BD (`ai_costs` table)
- ✅ **Streaming de IA**: `--ai-stream` para salida de tokens en tiempo real
- ✅ **Comparación Multi-LLM**: `--ai-compare openai,anthropic` — análisis en paralelo lado a lado
- ✅ **Agente de IA**: `--ai-agent` con llamadas en vivo a herramientas NVD + WPVulnerability.net

### v0.3.0 — Funcionalidades Empresariales (T3 2026)

**Enfoque:** Usabilidad, escalabilidad, IA interactiva

- 🔜 **Gestión Interactiva de Configuración**: Interfaz estilo Metasploit (`--show-options`, `--set`)
- 🔜 **CLI de Base de Datos**: Sin necesidad de SQL (`argus db scans list`, `argus db findings search`)
- 🔜 **Escaneo Multi-Sitio**: Procesamiento por lotes desde archivo
- 🔜 **Interfaz de Chat de IA**: Análisis conversacional de vulnerabilidades
- 🔜 **Integración CI/CD**: Plantillas para GitHub Actions, Jenkins, GitLab
- 🔜 **Servidor de API REST**: API basada en FastAPI para automatización

**Mejoras planificadas:**

- Configuración interactiva (`--set`, `--show-options`) para cambio dinámico de proveedor
- Seguimiento de finalización de fases e indicadores de progreso
- Gestión de base de datos mediante CLI (sin necesidad de SQL)

### v0.4.0 — Inteligencia y Automatización (T1 2027)

**Enfoque:** ML, automatización, IA avanzada

- 🔜 **Remediación Automatizada**: Integración con WP-CLI para corrección automática
- 🔜 **Detección Basada en ML**: Detección de anomalías, reducción de falsos positivos
- 🔜 **Escaneo Distribuido**: Nodos trabajadores para operaciones a gran escala
- 🔜 **Agentes de IA Avanzados**: Planificación autónoma de escaneos, generación de exploits

### Pro Track

**Producto comercial para empresas**

**EN PROCESO**

Para descripciones detalladas de funcionalidades, consulte [ROADMAP.md](https://github.com/rodhnin/argus-wp-watcher/blob/main/ROADMAP.md)

---

## 🤝 Contribuciones

¡Damos la bienvenida a las contribuciones! Ya sean:

- 🐛 Reportes de errores
- 💡 Solicitudes de funcionalidades
- 📝 Mejoras en la documentación
- 🔧 Contribuciones de código

### Cómo Contribuir

1. **Haz un fork del repositorio**
2. **Crea una rama de funcionalidad** (`git checkout -b feature/amazing-feature`)
3. **Realiza tus cambios**
4. **Escribe/actualiza pruebas** (cuando corresponda)
5. **Confirma tus cambios** (`git commit -m 'Add amazing feature'`)
6. **Sube los cambios a la rama** (`git push origin feature/amazing-feature`)
7. **Abre un Pull Request**

### Configuración de Desarrollo```bash
# Clone your fork
git clone https://github.com/YOUR-USERNAME/argus-wp-watcher.git
cd argus-wp-watcher

# Install development dependencies
python -m pip install -r requirements.txt
python -m pip install pytest black flake8 mypy

# Run code formatting
black argus/

# Run linting
flake8 argus/
mypy argus/

# Run tests (when available)
pytest tests/

---

## ⚠️ Descargo de responsabilidad

**IMPORTANTE:** Esta herramienta es solo para **pruebas de seguridad autorizadas**.

### Aviso legal

Al usar Argus, usted reconoce y acepta que:

1. ✅ Solo escaneará **sistemas que posea** o para los que tenga **permiso explícito por escrito**
2. ✅ Cumplirá con **todas las leyes aplicables** y regulaciones
3. ✅ Entiende que **el acceso no autorizado es ilegal** (CFAA, Computer Misuse Act, etc.)
4. ✅ El autor y los colaboradores **no asumen responsabilidad** por el mal uso
5. ✅ Este software se proporciona **"tal cual" sin garantía** de ningún tipo

### Divulgación responsable

Si descubre vulnerabilidades usando Argus:

- 📧 Contacte primero al propietario del sitio de forma privada
- ⏰ Otorgue un tiempo razonable para corregir (generalmente 90 días)
- 🤝 Coordine el cronograma de divulgación
- 📝 Documente sus hallazgos de manera profesional

### En caso de duda

**No escanee.** Si no está seguro de tener permiso, probablemente no lo tenga.

---

## 🙏 Agradecimientos

Argus se sostiene sobre los hombros de gigantes:

- **WordPress.org** — Equipo de seguridad por documentación y mejores prácticas
- **WPScan** — Investigación de vulnerabilidades y base de datos
- **OWASP** — Estándares de seguridad (Top 10, Guía de pruebas)
- **LangChain** — Framework de IA que impulsa el análisis inteligente
- **Anthropic & OpenAI** — Modelos de IA para análisis de vulnerabilidades
- **Ollama** — Inferencia de IA local para escaneo centrado en la privacidad
- **Comunidad de Python** — Bibliotecas y herramientas increíbles

Un agradecimiento especial a todos los investigadores de seguridad que practican y promueven el hacking ético.

---

## 👤 Autor

**Rodney Dhavid Jimenez Chacin (rodhnin)**

- 🌐 Sitio web y contacto: [rodhnin.com](https://rodhnin.com)
- 💼 GitHub: [@rodhnin](https://github.com/rodhnin)
- 🔗 Proyecto: [argus-wp-watcher](https://github.com/rodhnin/argus-wp-watcher)

Para preguntas, comentarios o consultas de colaboración, visite [rodhnin.com](https://rodhnin.com) para contactarme.

---

## 💬 Comunidad

- **Discussions**: [GitHub Discussions](https://github.com/rodhnin/argus-wp-watcher/discussions)
- **Issues**: [GitHub Issues](https://github.com/rodhnin/argus-wp-watcher/issues)
- **Releases**: [GitHub Releases](https://github.com/rodhnin/argus-wp-watcher/releases)

---

<div align="center">

**Construido con ❤️ para hackers éticos y administradores de WordPress en todo el mundo**

⭐ **¡Dale una estrella a este repositorio si te resulta útil!** ⭐

[Reportar error](https://github.com/rodhnin/argus-wp-watcher/issues) • [Solicitar funcionalidad](https://github.com/rodhnin/argus-wp-watcher/issues) • [Documentación](https://github.com/rodhnin/argus-wp-watcher/blob/main/docs)

---

_Argus v0.2.0 — Mayo 2026_

</div>