Strumento di threat intelligence per terminale in un unico file: feed di minacce in tempo reale, ricerche di indicatori, controlli passivi dei siti e ricerca da CVE a exploit, utilizzando solo livelli API gratuiti.
Versione 1.2.0 · Python 3.9+ · licenza MIT · Changelog
Uno strumento da terminale in singolo file per il threat intelligence: feed di minacce in tempo reale, ricerche di indicatori, controlli passivi della reputazione dei siti e ricerca CVE → exploit. Funziona come schermata interattiva (TUI) o tramite comandi one-shot, e utilizza solo livelli API gratuiti e servizi senza chiave.
Tutte le ricerche sono passive: lo strumento interroga motori di terze parti su un indicatore e non si connette mai direttamente al target.
pip install)cursesexploitdb (searchsploit), metasploit-framework, template nuclei — tutti presenti di default su Kaligit clone https://github.com/hunt3r-1/cybersec-intel.git
cd cybersec-intel
./install.sh
install.sh crea .env da .env.example (modalità 600) e inserisce un launcher cybersec-intel in ~/.local/bin che esegue intel.py da questa cartella. ./uninstall.sh rimuove il launcher e lascia la cartella intatta.
Nessun installer necessario se preferisci: copia .env.example in .env ed esegui python3 intel.py.
cybersec-intel # interactive screen
python3 intel.py # same, from this folder
cybersec-intel --version
Le chiavi vengono lette dal file .env accanto a intel.py (template: .env.example). Ogni chiave è opzionale e ogni servizio dispone di un piano gratuito. Una chiave mancante disabilita solo quella fonte; tutto il resto continua a funzionare.
| Variabile | Servizio | Utilizzata per |
|---|---|---|
VT_API_KEY | VirusTotal | reputazione di IP, dominio, URL, hash; relazioni in modalità deep e comportamento sandbox |
ABUSEIPDB_API_KEY | AbuseIPDB | punteggio di abuso IP, categorie di attacco, controllo blocco /24, feed blacklist |
OTX_API_KEY | AlienVault OTX | pulses, DNS passivo, malware collegati, intelligence su exploit CVE, feed dei pulses sottoscritti |
NVD_API_KEY | NVD | dettaglio CVE, feed CVE critiche, feed CISA KEV (la chiave aumenta il rate limit) |
SHODAN_API_KEY | Shodan | lookup host: servizi, versioni, certificati TLS |
URLHAUS_AUTH_KEY | abuse.ch | una chiave per URLhaus, ThreatFox e MalwareBazaar |
MYTHREATINTEL_TOKEN | MyThreatIntel | fonte opzionale di leak / IOC |
Fonti senza chiave, sempre attive: Shodan InternetDB, Shodan CVEDB, CIRCL, OSV, FIRST EPSS, RDAP, crt.sh e l'indice nomi-sec PoC-in-GitHub.
Mantieni .env con permessi 600. Lo strumento non stampa mai le chiavi e le tiene fuori dal proprio file di cache.
| Tipo | Esempio |
|---|---|
| IPv4 / IPv6 | 8.8.8.8, 2606:4700:4700::1111 |
| Dominio | example.org |
| URL | http://example.org/path |
| Hash di file | MD5, SHA-1 o SHA-256 |
| CVE | CVE-2021-44228 |
| Advisory | GHSA-xxxx-xxxx-xxxx, PYSEC-2024-1 |
Gli indirizzi privati e riservati (10.x, 192.168.x, ::1, …) vengono rifiutati e non vengono mai inviati ad alcuna API.
| Vista | Tasto | Cosa mostra |
|---|---|---|
| Dashboard | F1 | quali chiavi sono caricate, guida, utilizzo della quota odierna |
| Threat feed | F2 | CVE critiche/alte NVD (7g), aggiunte CISA KEV (30g), IOC ThreatFox (24h), URL live URLhaus, pulses sottoscritti OTX, blacklist AbuseIPDB, ultimi CIRCL |
| Lookup | F3 | tutto ciò che è noto su un indicatore |
| Site check | F4 | verdetto di reputazione passiva (0–100) per un URL, dominio o IP |
| Tasto | Azione |
|---|---|
F1–F4, ← → | cambia vista |
↑ ↓, PgUp PgDn, Home | scorri (funzionano anche 8/2/4/6 del tastierino numerico su dashboard e feed) |
Enter | esegue il lookup / site check per l'indicatore digitato |
Tab | modalità selezione: evidenzia le righe che contengono un IP, dominio, hash, URL o CVE |
Enter (in modalità selezione) | pivot — cerca l'indicatore evidenziato |
Tab / Esc (in modalità selezione) | esci dalla modalità selezione |
Ctrl+B | torna al lookup precedente |
Ctrl+D | modalità deep per il lookup corrente (IP, dominio, hash) |
r | aggiorna il feed / ripeti il site check |
Ctrl+E | esporta la vista corrente in CSV in exports/ |
Ctrl+R | salva un report Markdown (lookup e site check) |
Esc | cancella la riga di input |
q | esci (da dashboard o feed) |
Incolla 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
| Opzione | Significato |
|---|---|
--lookup INDICATOR | cerca un IP, dominio, URL, hash, CVE, GHSA o id PYSEC |
--prescan URL|DOMAIN|IP | controllo reputazionale passivo con un punteggio da 0 a 100 |
--poc CVE | cerca PoC pubblici ed exploit pronti per un CVE |
--file PATH | ricerca in blocco; # avvia un commento, i duplicati vengono saltati |
--prescan-file PATH | controllo sito in blocco, termina con un riepilogo del punteggio |
--deep | con --lookup / --file: aggiunge le fonti in modalità deep |
--feed | stampa il feed delle minacce ed esce |
--csv PATH | scrive i risultati anche in CSV (funziona con le modalità in blocco) |
--json | stampa JSON invece della vista testuale (un array nelle modalità in blocco) |
--version | stampa la versione |
Il codice di uscita è 2 quando un singolo indicatore viene rifiutato (non riconosciuto o privato).
IP — host Shodan (servizi, versioni, TLS, tag), Shodan InternetDB (porte, CVE), AbuseIPDB (punteggio, categorie di attacco, report più recenti), VirusTotal, ThreatFox, URLhaus, pulse OTX, DNS passivo OTX e malware collegati, proprietario della rete RDAP e contatto per gli abusi.
Dominio — VirusTotal, ThreatFox, URLhaus, pulse OTX, DNS passivo OTX, registrazione RDAP ed età del dominio, sottodomini crt.sh.
URL — URLhaus, VirusTotal, ThreatFox (per host), OTX.
Hash — VirusTotal, MalwareBazaar (famiglia, tag, YARA, verdetti dei vendor), ThreatFox, OTX.
CVE — NVD (CVSS, CWE, prodotti interessati, date KEV, riferimenti con tag exploit), Shodan CVEDB (KEV, EPSS, uso in ransomware), ricerca PoC (sotto), intelligence OTX sui CVE, CIRCL.
GHSA / PYSEC — advisory OSV, poi i motori CVE e la ricerca PoC tramite l'alias CVE dell'advisory.
Nelle ricerche per IP, ogni CVE elencato da Shodan per l'host mostra la sua probabilità EPSS e un contrassegno come [msf:2 edb:1 nuclei] EXPLOIT quando esiste localmente un exploit pronto. I CVE sfruttabili sono elencati per primi.
--deep o Ctrl+D)Opt-in, perché il piano gratuito di VirusTotal consente 4 richieste al minuto.