> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shodan

> Conecta Shodan a Myrmex: agrega la clave de API de tu cuenta para mapear la exposición externa y enriquecer investigaciones en tiempo real.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Conecta **Shodan** para que Myrmex pueda mapear tu superficie de ataque externa —hosts expuestos a internet, servicios, puertos y banners— y enriquecer investigaciones con inteligencia de dispositivos e IPs. Myrmex consulta la API REST de Shodan en tiempo real a través de un [Collector](/es/documentation/agent-endpoint-security/collector-mode).

<Note>
  Myrmex consulta Shodan bajo demanda y lee los resultados en tiempo real: nada se almacena del lado de Myrmex.
</Note>

## Qué puede hacer Myrmex

<CardGroup cols={2}>
  <Card title="Exposición externa" icon="globe">
    Descubre hosts expuestos a internet, puertos abiertos y servicios en ejecución.
  </Card>

  <Card title="Enriquecimiento de IP y host" icon="magnifying-glass">
    Enriquece indicadores durante el trabajo de [Threat Intelligence](/es/documentation/detection-response/threat-intelligence).
  </Card>

  <Card title="CVEs conocidas" icon="bug">
    Saca a la luz vulnerabilidades reportadas en servicios expuestos.
  </Card>

  <Card title="Recon con IA" icon="robot">
    Deja que [Orion](/es/documentation/multi-agent-system/orion) use Shodan para reconocimiento.
  </Card>
</CardGroup>

## Antes de comenzar

* Una cuenta de Shodan. Algunos endpoints (búsqueda de hosts, escaneo bajo demanda) necesitan un plan pago o créditos de consulta/escaneo disponibles.
* Un [Collector](/es/documentation/agent-endpoint-security/collector-mode) que pueda alcanzar `api.shodan.io` por HTTPS saliente.

## Paso 1 — Crear la credencial en Shodan

<Steps>
  <Step title="Inicia sesión">
    Ve a `account.shodan.io` e inicia sesión.
  </Step>

  <Step title="Copia tu clave de API">
    En la página **Account**, copia tu **API Key**.
  </Step>

  <Step title="Pégala en Myrmex">
    La agregarás como el token de API en el siguiente paso.
  </Step>
</Steps>

<Note>
  Shodan se autentica con la clave de API pasada como parámetro de consulta (`?key=<APIKEY>`): no hay usuario ni contraseña.
</Note>

## Paso 2 — Agregar la integración en Myrmex

Desde el **Directory**, elige **Add Integration → Shodan** y luego completa:

| Field           | Descripción                                                                                                 |
| --------------- | ----------------------------------------------------------------------------------------------------------- |
| **Name**        | Un nombre único para esta instancia de Shodan.                                                              |
| **Description** | Nota opcional para identificar la cuenta.                                                                   |
| **Collector**   | El [Collector](/es/documentation/agent-endpoint-security/collector-mode) que se conecta a la API de Shodan. |
| **API URL**     | El host de la API de Shodan (por defecto `api.shodan.io`).                                                  |
| **Port**        | Puerto de la API (por defecto `443`).                                                                       |
| **API Key**     | La clave de API de tu cuenta de Shodan.                                                                     |

## Conectar

Haz clic en **Connect** para validar la clave de API. Shodan aparecerá entonces en **Environment → Integrations**, y podrás usarlo —en vivo— en [Threat Intelligence](/es/documentation/detection-response/threat-intelligence) y en recon.