Signal OPS

Una plataforma de fusión de inteligencia de señales de espectro completo y de múltiples fuentes para la investigación y el entrenamiento en seguridad. Signal OPS integra docenas de fuentes de recopilación abiertas — bases de datos de WiFi/Bluetooth/torres de telefonía móvil, escáneres de exposición a Internet, índices de cámaras, fuentes de vuelos ADS-B, seguimiento de satélites TLE y redes SDR/APRS — en un único mapa táctico y una API Flask, correlacionando los dominios RF, celular, aeroespacial, orbital y de vigilancia en una única imagen operativa en tiempo real, con resúmenes de amenazas asistidos por IA opcionales superpuestos.

Características

• Escaneo unificado RF/OSINT — una sola llamada se distribuye en paralelo a fuentes de WiFi, Bluetooth, torres de telefonía móvil, IoT, cámaras y aeronaves, deduplica y puntúa los resultados.
• Descubrimiento de cámaras — Shodan, FOFA, BinaryEdge, Windy Webcams, nodos de vigilancia de OpenStreetMap e Insecam, por coordenadas o por país.
• Inteligencia celular — consultas de torres de telefonía móvil (WiGLE, OpenCellID) con resolución offline MCC/MNC → operador/país y heurísticas de IMSI-catcher / Stingray.
• Detección de amenazas inalámbricas — detección de puntos de acceso rogue / evil-twin y identificación de rastreadores Bluetooth (AirTag, Tile, SmartTag…).
• Monitoreo del espacio aéreo — ADS-B en vivo vía adsb.fi y OpenSky, decodificación de squawks de emergencia, heurísticas de drones y un mapa de calor de interferencia GPS derivado del NAC-P de las aeronaves.
• Seguimiento orbital — ingesta de TLE de CelesTrak con propagación SGP4, clasificación de misiones y superposición de estaciones terrestres SatNOGS.
• SDR y APRS — mapa público de receptores KiwiSDR y consultas de estaciones APRS.fi.
• Inteligencia de amenazas IP — agregación de múltiples fuentes (ipinfo, AbuseIPDB, CriminalIP, LeakIX, ZoomEye) con un escaneo de puertos ligero y puntuación de riesgo combinada.
• Lista de vigilancia y alertas — rastrea BSSIDs, SSIDs, IPs, MACs o códigos hex ICAO específicos y recibe coincidencias durante los escaneos.
• Análisis IA (opcional) — Google Gemini resume los resultados de los escaneos en evaluaciones y niveles de riesgo cuando se proporciona una clave.

Casi todas las fuentes son opcionales. Si una clave no está configurada, ese buscador se omite de forma elegante — las fuentes gratuitas (OpenStreetMap, Insecam, ipinfo.io, ADS-B, CelesTrak, KiwiSDR) funcionan sin ninguna clave.

Capturas de pantalla

Mapa SIGINT — vista unificada de múltiples fuentes

El mapa principal fusiona las capas de WiFi, Bluetooth, telefonía móvil, cámaras y aeronaves sobre la misma área, con superposiciones activables para cámaras OSM, redes ALPR/Flock y distritos policiales.

Vigilancia y CCTV

Fuente de vigilancia	Descubrimiento CCTV

La lista de vigilancia puntúa cada dispositivo (p. ej. "Sospecha 35/100: Cámara no autenticada") y fusiona routers, televisores y cámaras expuestas de WiGLE, Insecam y OSM. La vista CCTV agrupa las cámaras descubiertas por fuente con riesgo por cámara y estado en vivo/metadatos.

Inteligencia de torres de telefonía móvil y SDR / APRS

Mapa de calor de torres de telefonía móvil	Red SDR / APRS

La inteligencia de torres de telefonía móvil traza la densidad de torres con consulta de operador MCC/MNC; la vista SDR mapea receptores públicos KiwiSDR y estaciones APRS con consulta de indicativo.

Requisitos

• Python 3.9+
• Los paquetes de Python listados a continuación

Dependencias principales:

flask
requests
python-dotenv

Recomendadas (habilita la funcionalidad completa — caché, limitación de velocidad, propagación satelital):

cachetools        # geo-caché acotado (usa un dict sin límite si falta)
flask-limiter     # limitación de velocidad de solicitudes
sgp4              # propagación de posición satelital para /api/satellites
google-genai      # análisis IA Gemini (solo si usas GEMINI_API_KEY)

Instala todo:

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

Configuración

1. Clona y entra al proyecto

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

2. (Opcional) crea un entorno virtual

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

3. Instala las dependencias

pip install -r requirements.txt

Si no tienes un requirements.txt, usa la línea de pip install de la sección de Requisitos anterior.

4. Configura tu entorno

Copia el archivo de ejemplo y completa las claves que tengas:

cp .env.example .env

Luego abre .env y pega tus claves API. Cada clave es opcional — deja cualquier línea en blanco (o elimínala) para deshabilitar esa fuente. Consulta la siguiente sección para saber qué hace cada una y dónde obtenerla.

5. (Opcional) agrega conjuntos de datos locales

Para consultas instantáneas y offline de cámaras y distritos policiales, coloca estos archivos en un directorio data/ (o apunta DATA_DIR a otra ubicación):

data/CAMERAS_WITH_NETWORK_DATA.geojson   # Características de puntos (cámaras)
data/police_precincts_usa.geojson        # Características de polígonos (distritos de EE. UU.)
data/camera_networks.json                # metadatos de redes compartidas
data/tiles/{z}/{x}/{y}.json              # conjunto de datos de cámaras en teselas opcional

Si estos archivos están ausentes, la aplicación recurre automáticamente a consultas en vivo de OpenStreetMap Overpass.

6. Ejecuta

python app_v2.py

El servidor se inicia en http://0.0.0.0:8080. Abre http://localhost:8080 en tu navegador.

Verifica qué proveedores se cargaron correctamente en cualquier momento:

GET /api/status     # claves activas vs. faltantes
GET /api/debug      # booleano por clave + prueba de autenticación WiGLE en vivo

Variables de entorno

Crea un archivo .env en la raíz del proyecto. A continuación se muestra la lista completa que lee la aplicación.

Claves API de fuentes de datos (todas opcionales)

Configuración de la aplicación

Fuentes sin clave (siempre activas)

Estas no necesitan configuración: OpenStreetMap Overpass, Insecam, EarthCam, ipinfo.io, ADS-B (adsb.fi / OpenSky), CelesTrak TLE, SatNOGS y KiwiSDR.

.env.example

Guarda esto como .env.example en tu repositorio para que otros conozcan el formato:

# ── Entorno de Signal OPS ──
# Cada clave es opcional. Deja en blanco para deshabilitar esa fuente.

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

# Escáneres de exposición a 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=

# Cámaras y reputación IP
WINDY_API_KEY=
ABUSEIPDB_API_KEY=

# Aeronaves y radioaficionados
ADSB_API_KEY=
APRS_FI_KEY=

# Análisis IA
GEMINI_API_KEY=
GEMINI_MODEL=gemini-2.0-flash

# Configuración de la aplicación
DATA_DIR=./data
FLASK_SECRET_KEY=

Resumen de la API

Una selección de los endpoints expuestos (consulta el código fuente para el conjunto completo):

Notas y limitaciones

• Algunos proveedores (p. ej. ZoomEye, CriminalIP) pueden verse afectados por interferencia TLS en ciertos ISP y están deshabilitados por defecto en un par de listas de escaneo — consulta los comentarios en línea en el código fuente para re-habilitarlos detrás de una VPN/proxy.
• Los límites de velocidad varían ampliamente entre proveedores; los niveles gratuitos pueden ser pequeños (WiGLE celular es ~100 consultas/día, por ejemplo). La aplicación omite o retrocede cuando puede, pero eres responsable de mantenerte dentro de los límites de cada proveedor.
• Los conjuntos de datos locales son opcionales pero aceleran drásticamente las consultas de cámaras/distritos policiales en comparación con las consultas Overpass en vivo.