@securestamp/cli

CLI de SecureStamp para verificar la confianza de emails y dominios desde la terminal.

Instalación

npm install -g @securestamp/cli

Uso rápido

# Verificar un email o dominio
ss check [email protected]
ss check empresa.com

# Buscar en el registro público
ss registry empresa.com

# Ver estado de tu plan y cuota
ss login ss_live_xxxx   # guardar API key (o ss_test_...)
ss status

# Output JSON
ss check empresa.com --json

Comandos

ss check <target>

Verifica el trust status de un email o dominio.

Options:
  -j, --json    Output raw JSON
  --no-color    Disable colors

Ejemplo de salida:

● [email protected]
  Domain:  empresa.com
  State:   CONFIABLE
  Score:   87/100
  Signals: SPF:✓  DKIM:✓  DMARC:✓
  Domain age: 5y
  ✓ Registered in SecureStamp
  Checked: 2026-06-02 22:00:00 UTC

ss registry <domain>

Consulta si un dominio está registrado en el registry público de SecureStamp.

El registro público se sirve desde securestamp.org, no desde la base de la API de producto. Desde 1.0.1 el CLI apunta ahí solo; no hace falta configurar nada.

Si venís de 1.0.0, ese release pedía la ruta contra securestamp.online y devolvía HTTP 404. El workaround era SS_API_BASE=https://securestamp.org ss registry <dominio>, y sigue funcionando: un SS_API_BASE explícito manda sobre el default.

ss batch

Verifica varios destinos (uno por línea) desde stdin o un archivo.

Options:
  -f, --file <path>      Leer destinos de un archivo en vez de stdin
  -j, --json             Salida NDJSON (un objeto JSON por línea)
  -c, --concurrency <n>  Máximo de requests concurrentes (default: 5)
  --fail-on-blocked      Salir con código 1 si algún destino está bloqueado

ss status

Muestra tu plan actual y el uso de cuota del período vigente. Requiere API key.

ss login <api-key>

Guarda tu API key en ~/.securestamp/config.json (permisos de archivo 600).
Las claves empiezan con ss_live_ o ss_test_; el CLI rechaza cualquier otro prefijo.
Obtén tu API key en securestamp.online/dashboard/api.

ss logout

Elimina la API key guardada localmente.

Variables de entorno

| Variable | Descripción | | ------------------ | -------------------------------------------------------------------------------------------- | | SS_API_KEY | Sobrescribe la key guardada en ~/.securestamp/config.json | | SS_API_BASE | Base URL de la API de producto (default: https://securestamp.online) | | SS_REGISTRY_BASE | Base URL del registro público (default: https://securestamp.org; gana sobre SS_API_BASE) |

API key

Sin API key: el CLI funciona en modo público (20 req/hora por IP, endpoint /api/trust/check).
Con API key: cuota según tu plan (1.000–50.000 req/mes).

Privacidad

El CLI envía solo el email o dominio a verificar, nunca el contenido de mensajes.
Los eventos de analytics (cli_check) envían únicamente planTier y riskLevel — sin identificadores de usuario ni emails.

Requisitos

• Node.js >= 20.0.0 (coincide con engines en package.json y con lo que exigen las dependencias)
• Acceso a internet para llamar a la API de SecureStamp

Desarrollo

cd plugins/cli
npm install
npm run dev -- check empresa.com   # tsx en modo dev
npm run build                       # compila a dist/