vamp-easm 1.2__tar.gz → 1.4__tar.gz

{vamp_easm-1.2 → vamp_easm-1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vamp-easm
-Version: 1.2
+Version: 1.4
 Summary: External Attack Surface Management (EASM) scanner for authorized audits
 Author-email: VampSecure Studios <contact@vampsecurestudios.com>
 License: MIT
@@ -20,6 +20,7 @@ License-File: LICENSE
 Requires-Dist: rich>=13.7.0
 Dynamic: license-file
 
+<!-- © VampSecure Studios — VampSecure Labs Security Research Division -->
 # vamp-easm
 
 **Continuous External Attack Surface Management with daily diff tracking**
@@ -59,6 +60,13 @@ Part of the [VampSecure Labs](https://github.com/Vampsecure-Labs) security toolk
 
 ## Installation
 
+
+```bash
+pip install vamp-easm
+# o con Homebrew:
+brew install vampsecure-labs/labs/vamp-easm
+```
+
 ```bash
 # 1. Clone and enter the directory
 git clone https://github.com/Vampsecure-Labs/vamp-easm.git
@@ -210,3 +218,8 @@ MIT License — see [LICENSE](LICENSE) for details.
 
 © VampSecure Studios — VampSecure Labs Security Research Division  
 For authorized penetration testing use only.
+
+---
+
+## Versión
+v1.3 — VampSecure Labs Security Research Division

{vamp_easm-1.2 → vamp_easm-1.4}/README.md

@@ -1,3 +1,4 @@
+<!-- © VampSecure Studios — VampSecure Labs Security Research Division -->
 # vamp-easm
 
 **Continuous External Attack Surface Management with daily diff tracking**
@@ -37,6 +38,13 @@ Part of the [VampSecure Labs](https://github.com/Vampsecure-Labs) security toolk
 
 ## Installation
 
+
+```bash
+pip install vamp-easm
+# o con Homebrew:
+brew install vampsecure-labs/labs/vamp-easm
+```
+
 ```bash
 # 1. Clone and enter the directory
 git clone https://github.com/Vampsecure-Labs/vamp-easm.git
@@ -188,3 +196,8 @@ MIT License — see [LICENSE](LICENSE) for details.
 
 © VampSecure Studios — VampSecure Labs Security Research Division  
 For authorized penetration testing use only.
+
+---
+
+## Versión
+v1.3 — VampSecure Labs Security Research Division

{vamp_easm-1.2 → vamp_easm-1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "vamp-easm"
-version = "1.2"
+version = "1.4"
 description = "External Attack Surface Management (EASM) scanner for authorized audits"
 readme = "README.md"
 license = { text = "MIT" }

{vamp_easm-1.2 → vamp_easm-1.4}/vamp_easm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vamp-easm
-Version: 1.2
+Version: 1.4
 Summary: External Attack Surface Management (EASM) scanner for authorized audits
 Author-email: VampSecure Studios <contact@vampsecurestudios.com>
 License: MIT
@@ -20,6 +20,7 @@ License-File: LICENSE
 Requires-Dist: rich>=13.7.0
 Dynamic: license-file
 
+<!-- © VampSecure Studios — VampSecure Labs Security Research Division -->
 # vamp-easm
 
 **Continuous External Attack Surface Management with daily diff tracking**
@@ -59,6 +60,13 @@ Part of the [VampSecure Labs](https://github.com/Vampsecure-Labs) security toolk
 
 ## Installation
 
+
+```bash
+pip install vamp-easm
+# o con Homebrew:
+brew install vampsecure-labs/labs/vamp-easm
+```
+
 ```bash
 # 1. Clone and enter the directory
 git clone https://github.com/Vampsecure-Labs/vamp-easm.git
@@ -210,3 +218,8 @@ MIT License — see [LICENSE](LICENSE) for details.
 
 © VampSecure Studios — VampSecure Labs Security Research Division  
 For authorized penetration testing use only.
+
+---
+
+## Versión
+v1.3 — VampSecure Labs Security Research Division

{vamp_easm-1.2 → vamp_easm-1.4}/vamp_easm.py

@@ -76,7 +76,7 @@ from vampsec_report import (
 # Constantes
 # ---------------------------------------------------------------------------
 
-VERSION = "1.2"
+VERSION = "1.4"
 TOOL    = "vamp-easm"
 BRAND   = "VampSecure Labs — EASM Continuo"
 
@@ -87,7 +87,7 @@ BANNER = (
     " \\ V / _ \\| |\\/| |  _/\\__ \\ _| (__| |_| |   / _|| |__ / _ \\| _ \\__ \\\n"
     "  \\_/_/ \\_\\_|  |_|_|  |___/___\\___|\\___/|_|_\\___|____/_/ \\_\\___/___/\n"
     '  by Antonio Hernandez "Belky" — VampSecure Studios\n'
-    "  vamp-easm v1.2 · External Attack Surface Management\n"
+    "  vamp-easm v1.4 · External Attack Surface Management\n"
     "  ────────────────────────────────────────────────────────────────────────\n"
     "  USO EXCLUSIVO EN AUDITORÍAS AUTORIZADAS · El uso no autorizado es ilegal\n"
 )
@@ -196,6 +196,374 @@ def _tabla_historial(rows) -> Table:
     return tabla
 
 
+# ---------------------------------------------------------------------------
+# Integración Shodan  (v1.3)
+# ---------------------------------------------------------------------------
+
+# Puertos considerados sensibles para emitir hallazgo MEDIUM
+_SHODAN_PUERTOS_SENSIBLES = {21, 23, 445, 3389, 1433, 3306, 5432, 5900, 6379, 27017, 9200}
+
+
+class ShodanEASMEnricher:
+    """
+    Enriquecimiento EASM con la API REST de Shodan por IP.
+
+    Para cada IP descubierta en el escaneo consulta
+    https://api.shodan.io/shodan/host/<ip>?key=<api_key>
+    y añade hallazgos al listado de findings del escaneo:
+
+      - Puerto sensible abierto           → MEDIUM
+      - Vulnerabilidades en campo 'vulns' → HIGH
+      - Hostname alternativo              → INFO
+
+    Límite: 10 IPs máximo por invocación (para no agotar créditos API).
+    """
+
+    _HOST_URL = "https://api.shodan.io/shodan/host/{ip}?key={key}"
+    _MAX_IPS   = 10
+
+    def __init__(self, api_key: str) -> None:
+        self._key = api_key
+
+    def _enrich_with_shodan(
+        self,
+        ips_or_hosts: list,
+        api_key: str,
+        findings: list,
+    ) -> None:
+        """
+        Enriquece la lista de findings con datos Shodan para cada IP.
+
+        Modifica findings in-place añadiendo los hallazgos relevantes.
+
+        Parámetros
+        ----------
+        ips_or_hosts : list[str]  — IPs o nombres de host a consultar
+        api_key      : str        — Clave API de Shodan
+        findings     : list       — Lista de Finding a la que se añaden los hallazgos
+        """
+        import urllib.request as _ureq
+        import json as _json
+
+        # Filtrar solo IPs (IPv4 básico) y descartar repeticiones
+        ips_validas = []
+        vistas: set = set()
+        for h in ips_or_hosts:
+            h = h.strip()
+            partes = h.split(".")
+            if len(partes) == 4 and all(p.isdigit() for p in partes) and h not in vistas:
+                ips_validas.append(h)
+                vistas.add(h)
+
+        ips_validas = ips_validas[: self._MAX_IPS]
+
+        idx_base = max((int(f.id.split("-")[-1]) for f in findings if "-" in f.id), default=0)
+
+        for i, ip in enumerate(ips_validas, start=1):
+            url = self._HOST_URL.format(ip=ip, key=api_key)
+            try:
+                req = _ureq.Request(
+                    url,
+                    headers={"User-Agent": f"vamp-easm/{VERSION}"},
+                )
+                with _ureq.urlopen(req, timeout=15) as resp:
+                    codigo = resp.status
+                    if codigo == 401:
+                        findings.append(Finding(
+                            id          = f"EASM-SHD-{idx_base + i:03d}",
+                            title       = "API key Shodan inválida o sin créditos",
+                            severity    = "INFO",
+                            description = "La clave API de Shodan devolvió 401. Verificar validez y cuota.",
+                            evidence    = f"URL: {self._HOST_URL.format(ip=ip, key='***')}",
+                            affected    = ip,
+                            remediation = "Comprobar la clave API en https://account.shodan.io/",
+                            tags        = ["shodan", "easm"],
+                        ))
+                        return   # Si 401, todas las demás peticiones fallarán también
+                    if codigo == 404:
+                        # IP no indexada en Shodan: INFO silencioso
+                        continue
+                    if codigo != 200:
+                        continue
+                    data = _json.loads(resp.read())
+            except Exception:
+                # Error de red o timeout: continuar con la siguiente IP
+                continue
+
+            puertos:   list = data.get("ports", []) or []
+            vulns_raw: dict = data.get("vulns", {}) or {}
+            hostnames: list = data.get("hostnames", []) or []
+            org:       str  = data.get("org", "") or ""
+            sistema:   str  = data.get("os", "") or ""
+
+            # Hallazgo: puertos sensibles abiertos
+            sensibles = [p for p in puertos if p in _SHODAN_PUERTOS_SENSIBLES]
+            for puerto in sensibles:
+                idx_base += 1
+                findings.append(Finding(
+                    id          = f"EASM-SHD-{idx_base:03d}",
+                    title       = f"Puerto sensible {puerto} abierto según Shodan — {ip}",
+                    severity    = "MEDIUM",
+                    description = (
+                        f"Shodan ha indexado el puerto {puerto} como abierto en la IP {ip}. "
+                        "Este puerto corresponde a un servicio de alto riesgo si está expuesto "
+                        "sin control de acceso."
+                    ),
+                    evidence    = (
+                        f"IP: {ip}\n"
+                        f"Puerto: {puerto}\n"
+                        f"Org: {org or '—'}\n"
+                        f"OS: {sistema or '—'}\n"
+                        f"Fuente: Shodan (datos históricos — verificar estado actual)"
+                    ),
+                    affected    = f"{ip}:{puerto}",
+                    remediation = (
+                        f"Verificar si el puerto {puerto} en {ip} debe estar accesible desde Internet. "
+                        "Aplicar reglas de firewall para restringir el acceso por IP de origen. "
+                        "Actualizar el servicio a la última versión segura."
+                    ),
+                    tags        = ["shodan", "easm", "exposed-port"],
+                ))
+
+            # Hallazgo: vulnerabilidades reportadas por Shodan (campo 'vulns')
+            if vulns_raw:
+                cves_str = ", ".join(list(vulns_raw.keys())[:10])
+                idx_base += 1
+                findings.append(Finding(
+                    id          = f"EASM-SHD-{idx_base:03d}",
+                    title       = f"Vulnerabilidades Shodan en {ip}: {cves_str[:60]}",
+                    severity    = "HIGH",
+                    description = (
+                        f"Shodan reporta {len(vulns_raw)} vulnerabilidad(es) conocida(s) en la IP {ip}. "
+                        "Estas vulnerabilidades pueden estar presentes en los servicios actualmente "
+                        "expuestos según el índice de Shodan."
+                    ),
+                    evidence    = (
+                        f"IP: {ip}\n"
+                        f"Vulnerabilidades Shodan: {cves_str}\n"
+                        f"Org: {org or '—'}\n"
+                        f"Fuente: Shodan — los datos pueden tener latencia de semanas"
+                    ),
+                    affected    = ip,
+                    remediation = (
+                        "Verificar el estado actual de las vulnerabilidades listadas en los servicios "
+                        "del host. Consultar el NVD para detalles de parches y aplicarlos. "
+                        "Referencia: https://nvd.nist.gov/"
+                    ),
+                    cve         = list(vulns_raw.keys())[0] if vulns_raw else None,
+                    tags        = ["shodan", "easm", "cve", "vulnerability"],
+                ))
+
+            # Hallazgo INFO: hostname alternativo reportado por Shodan
+            for hostname in hostnames[:3]:
+                idx_base += 1
+                findings.append(Finding(
+                    id          = f"EASM-SHD-{idx_base:03d}",
+                    title       = f"Shodan reporta hostname alternativo: {hostname}",
+                    severity    = "INFO",
+                    description = (
+                        f"Shodan indexa el hostname '{hostname}' para la IP {ip}. "
+                        "Puede indicar servicios adicionales o dominios compartiendo esta IP."
+                    ),
+                    evidence    = f"IP: {ip}\nHostname Shodan: {hostname}",
+                    affected    = ip,
+                    remediation = "Verificar que el hostname corresponde a infraestructura autorizada.",
+                    tags        = ["shodan", "easm", "hostname"],
+                ))
+
+
+# ---------------------------------------------------------------------------
+# Integración Censys (v1.4)
+# ---------------------------------------------------------------------------
+
+# URL base de la API Censys v2
+_CENSYS_SEARCH_URL = "https://search.censys.io/api/v2/hosts/search"
+
+# Puertos considerados sensibles para enriquecer hallazgos Censys
+_CENSYS_PUERTOS_SENSIBLES = {21, 22, 23, 25, 80, 443, 445, 3389, 1433, 3306, 5432, 5900, 6379, 8080, 8443, 27017, 9200}
+
+
+class CensysEASMEnricher:
+    """
+    Enriquecimiento EASM con la API Censys v2.
+
+    Consulta el endpoint de búsqueda de hosts Censys usando la query
+    ``parsed.names:<dominio>`` para detectar hosts indexados por Censys
+    que no fueron descubiertos por crt.sh/HackerTarget.
+
+    Hallazgos emitidos:
+      - CENSYS_HOST_EXPOSED: host encontrado por Censys pero no en el
+        escaneo activo (superficie no visible para la organización).
+      - Puerto sensible abierto según Censys: MEDIUM.
+
+    Límite: 1 petición por segundo (rate limit de la API gratuita).
+    Resultados por página: 100 hosts (máximo permitido por la API).
+    """
+
+    _MAX_PAGINAS = 3   # máximo de páginas (300 hosts) por invocación
+
+    def __init__(self, censys_id: str, censys_secret: str) -> None:
+        self._id     = censys_id
+        self._secret = censys_secret
+
+    def _auth_header(self) -> str:
+        """Devuelve el valor de la cabecera Authorization (Basic Auth)."""
+        import base64 as _b64
+        creds = f"{self._id}:{self._secret}".encode()
+        return "Basic " + _b64.b64encode(creds).decode()
+
+    def enriquecer(
+        self,
+        dominio: str,
+        ips_conocidas: set,
+        findings: list,
+    ) -> None:
+        """
+        Consulta Censys por el dominio y añade hallazgos a la lista recibida.
+
+        Parámetros
+        ----------
+        dominio       : str        — Dominio objetivo
+        ips_conocidas : set[str]   — IPs ya descubiertas por el escaneo
+        findings      : list       — Lista de Finding a la que se añaden hallazgos
+        """
+        import urllib.request as _ureq
+        import urllib.error   as _uerr
+        import json           as _json
+        import time           as _time
+
+        auth = self._auth_header()
+        idx_base = max(
+            (int(f.id.split("-")[-1]) for f in findings if "-" in f.id),
+            default=0,
+        )
+
+        cursor: str | None = None
+        pagina = 0
+        hosts_censys: list[dict] = []
+
+        while pagina < self._MAX_PAGINAS:
+            # Construir URL con paginación
+            params = f"q=parsed.names%3A{_ureq.quote(dominio)}&per_page=100"
+            if cursor:
+                params += f"&cursor={_ureq.quote(cursor)}"
+            url = f"{_CENSYS_SEARCH_URL}?{params}"
+
+            try:
+                req = _ureq.Request(
+                    url,
+                    headers={
+                        "Authorization": auth,
+                        "User-Agent":    f"vamp-easm/{VERSION}",
+                        "Accept":        "application/json",
+                    },
+                )
+                with _ureq.urlopen(req, timeout=20) as resp:
+                    if resp.status != 200:
+                        break
+                    data = _json.loads(resp.read())
+            except _uerr.HTTPError as e:
+                if e.code in (401, 403):
+                    findings.append(Finding(
+                        id          = f"EASM-CNS-{idx_base + 1:03d}",
+                        title       = "Credenciales Censys inválidas o sin permisos",
+                        severity    = "INFO",
+                        description = (
+                            f"La API Censys devolvió {e.code}. "
+                            "Verificar --censys-id y --censys-secret."
+                        ),
+                        evidence    = f"URL: {_CENSYS_SEARCH_URL}",
+                        affected    = dominio,
+                        remediation = "Comprobar credenciales en https://search.censys.io/account",
+                        tags        = ["censys", "easm"],
+                    ))
+                break
+            except Exception:
+                break
+
+            lote = data.get("result", {}).get("hits", [])
+            hosts_censys.extend(lote)
+            cursor = data.get("result", {}).get("links", {}).get("next")
+            pagina += 1
+
+            if not cursor or not lote:
+                break
+
+            # Respetar el límite de 1 req/seg de la API gratuita
+            _time.sleep(1.0)
+
+        # Procesar cada host devuelto por Censys
+        for host in hosts_censys:
+            ip      = host.get("ip", "")
+            nombres = host.get("names", []) or []
+            servicios = host.get("services", []) or []
+            puertos = [s.get("port") for s in servicios if s.get("port")]
+
+            # Si la IP no fue encontrada por crt.sh/HackerTarget → hallazgo
+            if ip and ip not in ips_conocidas:
+                idx_base += 1
+                nombres_str = ", ".join(nombres[:5]) or "—"
+                puertos_str = ", ".join(str(p) for p in puertos[:10]) or "—"
+                findings.append(Finding(
+                    id          = f"EASM-CNS-{idx_base:03d}",
+                    title       = f"Host expuesto detectado por Censys (no en escaneo activo) — {ip}",
+                    severity    = "HIGH",
+                    description = (
+                        f"Censys indexa el host {ip} asociado al dominio '{dominio}' "
+                        "pero no fue descubierto por crt.sh ni HackerTarget. Puede "
+                        "tratarse de infraestructura shadow, activos olvidados o "
+                        "exposición no intencionada."
+                    ),
+                    evidence    = (
+                        f"IP: {ip}\n"
+                        f"Nombres DNS (Censys): {nombres_str}\n"
+                        f"Puertos indexados: {puertos_str}\n"
+                        f"Dominio consultado: {dominio}\n"
+                        "Fuente: Censys API v2 (datos históricos — verificar estado actual)"
+                    ),
+                    affected    = ip,
+                    remediation = (
+                        "Verificar si el activo pertenece a la organización. "
+                        "Si es legítimo, incluirlo en el inventario de superficie de ataque. "
+                        "Si no, investigar posible shadow IT o activo olvidado."
+                    ),
+                    tags        = ["censys", "easm", "CENSYS_HOST_EXPOSED"],
+                ))
+
+            # Puertos sensibles abiertos según Censys (para IPs conocidas y nuevas)
+            sensibles = [p for p in puertos if p in _CENSYS_PUERTOS_SENSIBLES]
+            for puerto in sensibles:
+                # Evitar duplicados con hallazgos Shodan
+                ya_reportado = any(
+                    f"{ip}:{puerto}" in (getattr(f, "affected", "") or "")
+                    for f in findings
+                )
+                if ya_reportado:
+                    continue
+                idx_base += 1
+                findings.append(Finding(
+                    id          = f"EASM-CNS-{idx_base:03d}",
+                    title       = f"Puerto sensible {puerto} abierto según Censys — {ip}",
+                    severity    = "MEDIUM",
+                    description = (
+                        f"Censys ha indexado el puerto {puerto} como abierto en "
+                        f"la IP {ip}. Este puerto corresponde a un servicio de "
+                        "alto riesgo si está expuesto sin control de acceso."
+                    ),
+                    evidence    = (
+                        f"IP: {ip}  Puerto: {puerto}\n"
+                        f"Servicios Censys: {', '.join(s.get('service_name','?') for s in servicios if s.get('port') == puerto) or '—'}\n"
+                        "Fuente: Censys API v2"
+                    ),
+                    affected    = f"{ip}:{puerto}",
+                    remediation = (
+                        f"Comprobar si el puerto {puerto} debe estar expuesto a internet. "
+                        "Si no es necesario, restringir acceso con firewall."
+                    ),
+                    tags        = ["censys", "easm", "port"],
+                ))
+
+
 # ---------------------------------------------------------------------------
 # Comando: scan
 # ---------------------------------------------------------------------------
@@ -291,6 +659,24 @@ def cmd_scan(args: argparse.Namespace) -> int:
     certs_ok = [c for c in resultado.certs if not c.error]
     console.print(f"   {len(certs_ok)} certificados inspeccionados.")
 
+    # ── Nota Shodan al inicio (si no se proporcionó clave) ───────────────────
+    shodan_key_easm = (
+        getattr(args, "shodan_key", None)
+        or __import__("os").environ.get("SHODAN_API_KEY", "")
+    )
+    if not shodan_key_easm:
+        console.print(
+            "[dim]  ℹ Shodan no activo — usa --shodan-key para enriquecer con datos Shodan[/dim]"
+        )
+
+    # Leer claves Censys (opcional, v1.4)
+    censys_id     = getattr(args, "censys_id",     None) or __import__("os").environ.get("CENSYS_API_ID",     "")
+    censys_secret = getattr(args, "censys_secret", None) or __import__("os").environ.get("CENSYS_API_SECRET", "")
+    if not (censys_id and censys_secret):
+        console.print(
+            "[dim]  ℹ Censys no activo — usa --censys-id y --censys-secret para enriquecer con datos Censys[/dim]"
+        )
+
     # ── Motor de diffs ────────────────────────────────────────────────────
     console.print("\n[cyan]►[/cyan] [bold]Calculando diffs respecto al escaneo anterior…[/bold]")
     scan_anterior = storage.ultimo_scan(target)
@@ -317,6 +703,42 @@ def cmd_scan(args: argparse.Namespace) -> int:
     # Cerrar escaneo en SQLite
     storage.cerrar_scan(scan_id, assets_found=assets_total, diffs_found=len(diffs))
 
+    # ── Enriquecimiento Shodan (opcional) ────────────────────────────────────
+    findings_shodan: List[Finding] = []
+    if shodan_key_easm:
+        console.print("\n[cyan]►[/cyan] [bold]Enriquecimiento Shodan (por IP)…[/bold]")
+        ips_descubiertas = []
+        for sub in resultado.subdominios:
+            if sub.ips:
+                ips_descubiertas.extend(sub.ips)
+        if ips_descubiertas:
+            enricher = ShodanEASMEnricher(shodan_key_easm)
+            enricher._enrich_with_shodan(ips_descubiertas, shodan_key_easm, findings_shodan)
+            console.print(
+                f"   {len([f for f in findings_shodan if f.severity in ('HIGH','MEDIUM')])} "
+                f"hallazgos Shodan (MEDIUM+HIGH) · {len(findings_shodan)} totales"
+            )
+        else:
+            console.print("   [dim]Sin IPs resueltas para consultar Shodan.[/dim]")
+
+    # ── Enriquecimiento Censys (v1.4, opcional) ───────────────────────────
+    findings_censys: List[Finding] = []
+    if censys_id and censys_secret:
+        console.print("\n[cyan]►[/cyan] [bold]Enriquecimiento Censys (por dominio)…[/bold]")
+        # Recopilar IPs ya conocidas del escaneo activo
+        ips_conocidas: set = set()
+        for sub in resultado.subdominios:
+            if sub.ips:
+                ips_conocidas.update(sub.ips)
+
+        censys_enricher = CensysEASMEnricher(censys_id, censys_secret)
+        censys_enricher.enriquecer(target, ips_conocidas, findings_censys)
+        nuevos = len([f for f in findings_censys if "CENSYS_HOST_EXPOSED" in (getattr(f, "tags", None) or [])])
+        console.print(
+            f"   {nuevos} host(s) nuevos (CENSYS_HOST_EXPOSED) · "
+            f"{len(findings_censys)} hallazgos totales Censys"
+        )
+
     # ── Mostrar resultados ────────────────────────────────────────────────
     if diffs:
         console.print(_tabla_diffs(diffs))
@@ -332,6 +754,10 @@ def cmd_scan(args: argparse.Namespace) -> int:
 
     # ── Exportar informes si se pidió ─────────────────────────────────────
     findings = [d.finding for d in diffs if d.finding is not None]
+    # Incluir hallazgos Shodan en el informe si los hay
+    findings.extend(findings_shodan)
+    # Incluir hallazgos Censys en el informe si los hay (v1.4)
+    findings.extend(findings_censys)
     if findings:
         meta = meta_from_args(args, tool=TOOL, version=VERSION)
         meta.scope = target
@@ -750,6 +1176,21 @@ def construir_parser() -> argparse.ArgumentParser:
         "--alert-webhook", metavar="URL", dest="alert_webhook",
         help="URL del webhook para alertas CRITICAL/HIGH (alternativa: env EASM_ALERT_WEBHOOK)",
     )
+    p_scan.add_argument(
+        "--shodan-key", metavar="API_KEY", dest="shodan_key",
+        help="Clave API Shodan (o var SHODAN_API_KEY) — enriquece IPs descubiertas "
+             "con puertos, servicios y vulnerabilidades indexadas por Shodan",
+    )
+    p_scan.add_argument(
+        "--censys-id", metavar="ID", dest="censys_id",
+        help="ID de la API Censys v2 (o var CENSYS_API_ID) — enriquece el escaneo "
+             "con hosts detectados por Censys no visibles en crt.sh/HackerTarget (v1.4)",
+    )
+    p_scan.add_argument(
+        "--censys-secret", metavar="SECRET", dest="censys_secret",
+        help="Secret de la API Censys v2 (o var CENSYS_API_SECRET) — requerido junto "
+             "con --censys-id para activar el enriquecimiento Censys (v1.4)",
+    )
     add_report_args(p_scan)
 
     # ── history ───────────────────────────────────────────────────────────
@@ -794,6 +1235,11 @@ def construir_parser() -> argparse.ArgumentParser:
         "--nmap", action="store_true",
         help="Usar nmap como backend de escaneo de puertos",
     )
+    p_watch.add_argument(
+        "--shodan-key", metavar="API_KEY", dest="shodan_key",
+        help="Clave API Shodan (o var SHODAN_API_KEY) — enriquece IPs descubiertas "
+             "con datos Shodan en cada ciclo de watch",
+    )
 
     # ── diff ──────────────────────────────────────────────────────────────
     p_diff = subparsers.add_parser(