Signal OPS

Una piattaforma di fusione di intelligence sui segnali a spettro completo e multi-sorgente per la ricerca e la formazione sulla sicurezza. Signal OPS raccoglie decine di fonti di raccolta aperte — database WiFi/Bluetooth/stazioni cellulari, scanner di esposizione internet, indici di telecamere, feed di volo ADS-B, tracciamento satellitare TLE e reti SDR/APRS — in un'unica mappa tattica e API Flask, correlando i domini RF, cellulare, spazio aereo, orbitale e di sorveglianza in un unico quadro operativo in tempo reale, con riepiloghi opzionali delle minacce assistiti da AI sovrapposti.

Caratteristiche

• Scansione RF/OSINT unificata — una singola chiamata si dirama in parallelo verso fonti WiFi, Bluetooth, stazioni cellulari, IoT, telecamere e aeromobili, deduplica e valuta i risultati.
• Scoperta telecamere — Shodan, FOFA, BinaryEdge, Windy Webcams, nodi di sorveglianza OpenStreetMap e Insecam, per coordinate o per paese.
• Intelligence cellulare — ricerche su stazioni cellulari (WiGLE, OpenCellID) con risoluzione offline MCC/MNC → operatore/paese ed euristiche per IMSI-catcher / Stingray.
• Rilevamento minacce wireless — rilevamento di punti di accesso rogue / evil-twin e identificazione di tracker Bluetooth (AirTag, Tile, SmartTag…).
• Monitoraggio spazio aereo — ADS-B live tramite adsb.fi e OpenSky, decodifica di squawk di emergenza, euristiche per droni e mappa di calore del GPS-jamming derivata dal NAC-P degli aeromobili.
• Tracciamento orbitale — ingestione TLE CelesTrak con propagazione SGP4, classificazione delle missioni e sovrapposizione delle stazioni di terra SatNOGS.
• SDR e APRS — mappa pubblica dei ricevitori KiwiSDR e ricerche stazioni APRS.fi.
• Intelligence sulle minacce IP — aggregazione multi-sorgente (ipinfo, AbuseIPDB, CriminalIP, LeakIX, ZoomEye) con scansione porte leggera e punteggio di rischio combinato.
• Watchlist e avvisi — traccia BSSID, SSID, IP, MAC o hex ICAO specifici e ricevi corrispondenze durante le scansioni.
• Analisi AI (opzionale) — Google Gemini riepiloga i risultati delle scansioni in valutazioni e livelli di rischio quando viene fornita una chiave.

Quasi ogni sorgente è opzionale. Se una chiave non è impostata, quel fetcher viene saltato con garbo — le sorgenti gratuite (OpenStreetMap, Insecam, ipinfo.io, ADS-B, CelesTrak, KiwiSDR) funzionano senza alcuna chiave.

Screenshot

Mappa SIGINT — vista unificata multi-sorgente

La mappa principale fonde i layer WiFi, Bluetooth, cellulare, telecamere e aeromobili sulla stessa area, con overlay attivabili per telecamere OSM, reti ALPR/Flock e distretti di polizia.

Sorveglianza e CCTV

Feed di sorveglianza	Scoperta CCTV

L'elenco di sorveglianza valuta ogni dispositivo (es. "Sospetto 35/100: telecamera non autenticata") e fonde router, TV e telecamere esposte da WiGLE, Insecam e OSM. La vista CCTV raggruppa le telecamere scoperte per sorgente con rischio per singola telecamera e stato live/metadati.

Intelligence stazioni cellulari e SDR / APRS

Mappa di calore stazioni cellulari	Rete SDR / APRS

L'intelligence sulle stazioni cellulari traccia la densità delle torri con ricerca operatore MCC/MNC; la vista SDR mappa i ricevitori pubblici KiwiSDR e le stazioni APRS con ricerca callsign.

Requisiti

• Python 3.9+
• I pacchetti Python elencati di seguito

Dipendenze principali:

flask
requests
python-dotenv

Consigliati (abilitano la piena funzionalità — caching, rate limiting, propagazione satellitare):

cachetools        # geo-cache limitata (ripiega su un dict illimitato se mancante)
flask-limiter     # rate limiting delle richieste
sgp4              # propagazione posizione satellitare per /api/satellites
google-genai      # analisi AI Gemini (solo se usi GEMINI_API_KEY)

Installa tutto:

pip install flask requests python-dotenv cachetools flask-limiter sgp4 google-genai

Configurazione

1. Clona ed entra nel progetto

git https://github.com/emrekybs/signalops.git
unzip signalops-v1.zip

2. (Opzionale) crea un ambiente virtuale

python -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate

3. Installa le dipendenze

pip install -r requirements.txt

Se non hai un requirements.txt, usa la riga pip install della sezione Requisiti sopra.

4. Configura il tuo ambiente

Copia il file di esempio e inserisci le chiavi che hai:

cp .env.example .env

Poi apri .env e incolla le tue chiavi API. Ogni chiave è opzionale — lascia vuota qualsiasi riga (o cancellala) per disabilitare quella sorgente. Vedi la sezione successiva per cosa fa ciascuna e dove ottenerla.

5. (Opzionale) aggiungi dataset locali

Per ricerche istantanee offline di telecamere e distretti, posiziona questi file in una directory data/ (o punta DATA_DIR altrove):

data/CAMERAS_WITH_NETWORK_DATA.geojson   # Feature Point (telecamere)
data/police_precincts_usa.geojson        # Feature Polygon (distretti USA)
data/camera_networks.json                # metadati condivisione rete
data/tiles/{z}/{x}/{y}.json              # dataset telecamere a tile opzionale

Se questi file sono assenti, l'app ripiega automaticamente su query live OpenStreetMap Overpass.

6. Esegui

python app_v2.py

Il server si avvia su http://0.0.0.0:8080. Apri http://localhost:8080 nel tuo browser.

Controlla quali provider sono stati caricati correttamente in qualsiasi momento:

GET /api/status     # chiavi attive vs. mancanti
GET /api/debug      # booleano per chiave + test auth WiGLE live

Variabili d'ambiente

Crea un file .env nella radice del progetto. Di seguito l'elenco completo letto dall'app.

Chiavi API delle sorgenti dati (tutte opzionali)

Configurazione app

Sorgenti senza chiave (sempre attive)

Queste non richiedono configurazione: OpenStreetMap Overpass, Insecam, EarthCam, ipinfo.io, ADS-B (adsb.fi / OpenSky), CelesTrak TLE, SatNOGS e KiwiSDR.

.env.example

Salva questo come .env.example nel tuo repository così gli altri conoscono il formato:

# ── Ambiente Signal OPS ──
# Ogni chiave è opzionale. Lascia vuoto per disabilitare quella sorgente.

# WiFi / Bluetooth / Cellulare
WIGLE_API_NAME=
WIGLE_API_TOKEN=
OPENCELLID_API_KEY=

# Scanner esposizione internet
SHODAN_API_KEY=
CENSYS_API_ID=
CENSYS_API_SECRET=
ZOOMEYE_API_KEY=
FOFA_EMAIL=
FOFA_API_KEY=
HUNTERHOW_API_KEY=
NETLAS_API_KEY=
LEAKIX_API_KEY=
CRIMINALIP_API_KEY=
BINARYEDGE_API_KEY=

# Telecamere e reputazione IP
WINDY_API_KEY=
ABUSEIPDB_API_KEY=

# Aeromobili e radioamatori
ADSB_API_KEY=
APRS_FI_KEY=

# Analisi AI
GEMINI_API_KEY=
GEMINI_MODEL=gemini-2.0-flash

# Configurazione app
DATA_DIR=./data
FLASK_SECRET_KEY=

Panoramica API

Una selezione degli endpoint esposti (vedi il sorgente per l'insieme completo):

Note e limitazioni

• Alcuni provider (es. ZoomEye, CriminalIP) possono essere influenzati da interferenze TLS su certi ISP e sono disabilitati di default in un paio di elenchi di scansione — vedi i commenti inline nel sorgente per riabilitarli dietro VPN/proxy.
• I rate limit variano ampiamente tra i provider; i tier gratuiti possono essere piccoli (WiGLE cellulare è ~100 query/giorno, per esempio). L'app salta o arretra dove può, ma sei responsabile di rimanere entro i limiti di ciascun provider.
• I dataset locali sono opzionali ma accelerano drasticamente le ricerche di telecamere/distretti rispetto alle query live Overpass.