Referencia CLI

Comando principal: osint-agent

osint-agent [OPTIONS] [COMMAND]

Modos de ejecucion

Modo interactivo (default)

osint-agent

Abre el prompt osint> para sesion interactiva.

Query unica

osint-agent -q "Investiga la IP 185.220.101.34"
osint-agent -q "Analiza el dominio evil.com" --json

Flag	Descripcion
-q, --query TEXT	Query a ejecutar en modo no interactivo
--json	Salida en formato JSON

Modo batch desde fichero

osint-agent --batch iocs.txt
osint-agent --batch iocs.txt --limit 20 --json

Flag	Descripcion
--batch PATH	Ruta a fichero con un IOC por linea
--limit N	Maximo de IOCs a procesar (default: 10)
--json	Salida JSON por IOC

Modo batch desde feed

osint-agent --feed feodo --limit 5
osint-agent --feed urlhaus --limit 3 --json

Flag	Descripcion
--feed NAME	Nombre del feed: feodo, urlhaus, ipsum, c2intel, cloudflare
--limit N	Numero de IOCs a analizar del feed
--json	Salida JSON

Flags globales

Flag	Descripcion
--help	Muestra ayuda
--version	Muestra la version
--verbose	Salida detallada (debug)

Subcomandos de investigacion

investigation create

osint-agent investigation create "Caso Acme Corp" --goal "Due diligence"

Flag	Descripcion
NAME	Nombre de la investigacion
--goal TEXT	Objetivo de la investigacion

investigation list

osint-agent investigation list

Lista todas las investigaciones con su estado (activa, archivada).

investigation use

osint-agent investigation use caso-acme-corp

Activa una investigacion por su slug. Escribe el slug en data/.active.

investigation archive

osint-agent investigation archive caso-acme-corp

investigation reactivate

osint-agent investigation reactivate caso-acme-corp

Comandos de estado

status

osint-agent status

Muestra el resumen de la investigacion activa: nombre, objetivo, numero de evidencias, entidades, claims.

limits

osint-agent limits

Muestra el consumo de cuotas mensuales de operaciones.

Comandos en el prompt interactivo

Una vez dentro del prompt osint>:

Comando	Descripcion
/dashboard	Tabla de riesgo de todos los IOCs investigados en la sesion
/report save	Guarda informe Markdown en reports/
/report preview	Muestra preview del informe en terminal
/cache stats	Estadisticas del cache SQLite
/cache clear	Limpia el cache (siguiente consulta ira a la API)
/feeds list	Lista los feeds disponibles
/feeds <nombre> --limit N	Analiza los N IOCs mas recientes de un feed
/help	Lista de comandos disponibles
exit / quit	Salir del agente

MCP Server: osint-mcp

osint-mcp                                           # STDIO
osint-mcp --transport streamable-http --port 8080   # HTTP
osint-mcp --help

A2A Server: osint-a2a

osint-a2a                    # default: 0.0.0.0:9000
osint-a2a --port 9090        # puerto personalizado
osint-a2a --host 127.0.0.1   # solo localhost
osint-a2a --help

Ejemplos practicos

# Investigacion rapida de un IOC
osint-agent -q "Investiga la IP 8.8.8.8"

# Analisis de dominio con salida JSON para scripting
osint-agent -q "Analiza el dominio google.com" --json | jq '.risk_score'

# Analizar los 5 C2 mas activos de Feodo
osint-agent --feed feodo --limit 5

# Batch de una lista de IOCs con pausa de 3s entre cada uno
BATCH_DELAY_SECONDS=3 osint-agent --batch suspicious_ips.txt

# Iniciar investigacion y activarla
osint-agent investigation create "Phishing-Q1-2026" --goal "Identificar infraestructura"
osint-agent investigation use phishing-q1-2026

# Ver estado
osint-agent status