Herramienta de inteligencia de amenazas para terminal en un solo archivo: fuentes de amenazas en vivo, consultas de indicadores, comprobaciones pasivas de sitios y búsqueda de CVE a exploit, usando únicamente niveles gratuitos de API.
Versión 1.2.0 · Python 3.9+ · licencia MIT · Registro de cambios
Una herramienta de terminal de un solo archivo para inteligencia de amenazas: fuentes de amenazas en vivo, consultas de indicadores, comprobaciones pasivas de reputación de sitios y búsqueda de CVE → exploit. Se ejecuta como una pantalla interactiva (TUI) o como comandos de una sola ejecución, y utiliza únicamente niveles gratuitos de API y servicios sin clave.
Todas las consultas son pasivas: la herramienta pregunta a motores de terceros sobre un indicador y nunca se conecta al objetivo en sí.
pip install)cursesexploitdb (searchsploit), metasploit-framework, plantillas de nuclei — todos presentes en Kali por defectogit clone https://github.com/hunt3r-1/cybersec-intel.git
cd cybersec-intel
./install.sh
install.sh crea .env a partir de .env.example (modo 600) y coloca un lanzador cybersec-intel en ~/.local/bin que ejecuta intel.py desde esta carpeta. ./uninstall.sh elimina el lanzador y deja la carpeta intacta.
No se necesita instalador si lo prefieres: copia .env.example a .env y ejecuta python3 intel.py.
cybersec-intel # interactive screen
python3 intel.py # same, from this folder
cybersec-intel --version
Las claves se leen del archivo .env junto a intel.py (plantilla: .env.example). Cada clave es opcional y cada servicio tiene un nivel gratuito. Una clave ausente solo desactiva esa fuente; todo lo demás sigue funcionando.
| Variable | Servicio | Se usa para |
|---|---|---|
VT_API_KEY | VirusTotal | reputación de IP, dominio, URL, hash; relaciones en modo profundo y comportamiento del sandbox |
ABUSEIPDB_API_KEY | AbuseIPDB | puntuación de abuso de IP, categorías de ataque, comprobación del bloque /24, feed de listas negras |
OTX_API_KEY | AlienVault OTX | pulses, DNS pasivo, malware vinculado, inteligencia de exploits CVE, feed de pulses suscritos |
NVD_API_KEY | NVD | detalle de CVE, feed de CVE críticas, feed de CISA KEV (la clave aumenta el límite de peticiones) |
SHODAN_API_KEY | Shodan | consulta de host: servicios, versiones, certificados TLS |
URLHAUS_AUTH_KEY | abuse.ch | una clave para URLhaus, ThreatFox y MalwareBazaar |
MYTHREATINTEL_TOKEN | MyThreatIntel | fuente opcional de filtraciones / IOC |
Fuentes sin clave, siempre activas: Shodan InternetDB, Shodan CVEDB, CIRCL, OSV, FIRST EPSS, RDAP, crt.sh y el índice nomi-sec PoC-in-GitHub.
Mantén .env con permisos 600. La herramienta nunca imprime las claves y las mantiene fuera de su archivo de caché.
| Tipo | Ejemplo |
|---|---|
| IPv4 / IPv6 | 8.8.8.8, 2606:4700:4700::1111 |
| Dominio | example.org |
| URL | http://example.org/path |
| Hash de archivo | MD5, SHA-1 o SHA-256 |
| CVE | CVE-2021-44228 |
| Aviso | GHSA-xxxx-xxxx-xxxx, PYSEC-2024-1 |
Las direcciones privadas y reservadas (10.x, 192.168.x, ::1, …) se rechazan y nunca se envían a ninguna API.
| Vista | Tecla | Qué muestra |
|---|---|---|
| Panel | F1 | qué claves están cargadas, ayuda, uso de cuota de hoy |
| Feed de amenazas | F2 | CVE críticas/altas de NVD (7d), adiciones a CISA KEV (30d), IOC de ThreatFox (24h), URL activas de URLhaus, pulses suscritos de OTX, lista negra de AbuseIPDB, lo último de CIRCL |
| Consulta | F3 | todo lo conocido sobre un indicador |
| Comprobación de sitio | F4 | veredicto de reputación pasiva (0–100) para una URL, dominio o IP |
| Tecla | Acción |
|---|---|
F1–F4, ← → | cambiar de vista |
↑ ↓, PgUp PgDn, Home | desplazarse (el teclado numérico 8/2/4/6 también funciona en el panel y el feed) |
Enter | ejecutar la consulta / comprobación de sitio para el indicador escrito |
Tab | modo de selección: resalta las filas que contienen una IP, dominio, hash, URL o CVE |
Enter (en modo de selección) | pivotar — consultar el indicador resaltado |
Tab / Esc (en modo de selección) | salir del modo de selección |
Ctrl+B | volver a la consulta anterior |
Ctrl+D | modo profundo para la consulta actual (IP, dominio, hash) |
r | actualizar el feed / repetir la comprobación de sitio |
Ctrl+E | exportar la vista actual a CSV en exports/ |
Ctrl+R | guardar un informe Markdown (consulta y comprobación de sitio) |
Esc | limpiar la línea de entrada |
q | salir (desde el panel o el feed) |
Pega con Ctrl+Shift+V.
cybersec-intel --lookup 8.8.8.8 # one-shot lookup
cybersec-intel --lookup example.org --deep # lookup plus deep mode
cybersec-intel --prescan http://example.org/x # passive site check with verdict
cybersec-intel --poc CVE-2021-44228 # exploit / PoC search only
cybersec-intel --feed # print the threat feed
cybersec-intel --file targets.txt # bulk lookup, one indicator per line
cybersec-intel --prescan-file sites.txt # bulk site check with summary table
| Opción | Significado |
|---|---|
--lookup INDICATOR | busca una IP, dominio, URL, hash, CVE, GHSA o id PYSEC |
--prescan URL|DOMAIN|IP | comprobación pasiva de reputación con una puntuación de 0–100 |
--poc CVE | busca PoCs públicos y exploits listos para usar de un CVE |
--file PATH | búsqueda masiva; # inicia un comentario, los duplicados se omiten |
--prescan-file PATH | comprobación masiva de sitios, termina con un resumen de puntuación |
--deep | con --lookup / --file: añade fuentes del modo profundo |
--feed | muestra el feed de amenazas y sale |
--csv PATH | también escribe los resultados en CSV (funciona con los modos masivos) |
--json | muestra JSON en lugar de la vista de texto (un array en los modos masivos) |
--version | muestra la versión |
El código de salida es 2 cuando se rechaza un único indicador (no reconocido o privado).
IP — host de Shodan (servicios, versiones, TLS, etiquetas), Shodan InternetDB (puertos, CVE), AbuseIPDB (puntuación, categorías de ataque, últimos informes), VirusTotal, ThreatFox, URLhaus, pulsos de OTX, DNS pasivo de OTX y malware vinculado, propietario de la red y contacto de abuso de RDAP.
Dominio — VirusTotal, ThreatFox, URLhaus, pulsos de OTX, DNS pasivo de OTX, registro y antigüedad del dominio de RDAP, subdominios de crt.sh.
URL — URLhaus, VirusTotal, ThreatFox (por host), OTX.
Hash — VirusTotal, MalwareBazaar (familia, etiquetas, YARA, veredictos de proveedores), ThreatFox, OTX.
CVE — NVD (CVSS, CWE, productos afectados, fechas de KEV, referencias etiquetadas como exploit), Shodan CVEDB (KEV, EPSS, uso en ransomware), búsqueda de PoC (más abajo), inteligencia de CVE de OTX, CIRCL.
GHSA / PYSEC — aviso de OSV, luego los motores de CVE y la búsqueda de PoC mediante el alias de CVE del aviso.
En las búsquedas de IP, cada CVE que Shodan enumera para el host muestra su probabilidad EPSS y una marca como [msf:2 edb:1 nuclei] EXPLOIT cuando existe un exploit listo localmente. Los CVE explotables se listan primero.
--deep o Ctrl+D)Opción voluntaria, porque el plan gratuito de VirusTotal permite 4 solicitudes por minuto.