API Keys y registro

import { Aside } from ‘@astrojs/starlight/components’;

Minimo para empezar

Solo necesitas una API key para arrancar. VirusTotal es la mas recomendada porque cubre IPs, dominios y hashes.

# .env — configuracion minima
VIRUSTOTAL_API_KEY=tu_clave
LLM_PROVIDER=ollama
OLLAMA_MODEL=qwen3:14b

Todos los servicios

Servicio	Variable de entorno	Free tier	Link de registro
VirusTotal	VIRUSTOTAL_API_KEY	500 req/dia	virustotal.com/gui/join-us
AbuseIPDB	ABUSEIPDB_API_KEY	1.000 req/dia	abuseipdb.com/register
AlienVault OTX	ALIENVAULT_OTX_API_KEY	Ilimitado	otx.alienvault.com/api
Shodan	SHODAN_API_KEY	100 req/mes	account.shodan.io/register
IPInfo	IPINFO_TOKEN	50.000 req/mes	ipinfo.io/signup
URLScan.io	URLSCAN_API_KEY	5.000 req/dia	urlscan.io/user/signup
FRED	FRED_API_KEY	Gratuito	fred.stlouisfed.org
EIA	EIA_API_KEY	Gratuito	eia.gov/opendata
Cloudflare Radar	CLOUDFLARE_API_TOKEN	Gratuito	dash.cloudflare.com
ACLED	ACLED_ACCESS_TOKEN + ACLED_EMAIL	Gratuito (investigacion)	acleddata.com/register
AISStream	AISSTREAM_API_KEY	Gratuito	aisstream.io

Herramientas sin API key

Estas funcionan sin ninguna clave:

Herramienta	Que hace
WHOIS / RDAP	Informacion de registro de dominio
DNS lookup	Registros DNS (A, AAAA, MX, NS, TXT, CNAME)
crt.sh	Subdominios por Certificate Transparency
Feodo Tracker	Feed de IPs C2 de botnets
URLhaus	Feed de URLs distribuyendo malware
IPsum	Lista de IPs maliciosas
GDELT	Noticias globales y analisis de eventos
RSS Monitoring	Noticias de seguridad, finanzas, general
Country Risk	Indice de inestabilidad por pais
Anomaly Detection	Deteccion local de anomalias
Threat Classifier	Clasificacion local por palabras clave

Puedes empezar solo con las herramientas gratuitas para familiarizarte con la plataforma antes de registrarte en servicios externos.

Configuracion en .env

# Copia el template
cp .env.example .env

# Edita con tu editor
nano .env  # o vim, code, etc.

El fichero .env esta en el .gitignore — nunca se sube al repositorio.

Prioridad recomendada de keys

Si quieres maximo coverage con minimo registro:

1. VirusTotal — cubre IPs, dominios y hashes con una sola key
2. AbuseIPDB — complementa VirusTotal para IPs con datos de abuse reports
3. AlienVault OTX — ilimitado, muy util para contexto de amenazas
4. IPInfo — geolocalizacion precisa, 50K req/mes gratis
5. Shodan — para ver servicios expuestos (100 req/mes en free tier)
6. URLScan — necesario si investigas URLs de phishing/malware activamente

Las API keys se guardan en `.env` localmente. Nunca las compartas ni las commits al repositorio. El sistema nunca las envia a ninguna parte salvo a los servicios OSINT correspondientes.

Rate limits y cache

El sistema respeta los rate limits de cada servicio:

BATCH_DELAY_SECONDS=2    # Pausa entre IOCs en modo batch (default: 2s)
CACHE_TTL_SECONDS=86400  # Cache de 24h para evitar llamadas redundantes

Con el cache activo, investigar el mismo IOC dos veces en 24h solo consume una llamada a la API real.