Signal OPS

Uma plataforma de fusão de inteligência de sinais de espectro completo e de múltiplas fontes para pesquisa e treinamento em segurança. O Signal OPS reúne dezenas de fontes de coleta abertas — bancos de dados de WiFi/Bluetooth/torres de celular, scanners de exposição à internet, índices de câmeras, feeds de voo ADS-B, rastreamento de satélites TLE e redes SDR/APRS — em um único mapa tático e API Flask, correlacionando os domínios RF, celular, espaço aéreo, orbital e de vigilância em um único quadro operacional em tempo real, com resumos opcionais de ameaças assistidos por IA sobrepostos.

Recursos

• Varredura unificada RF/OSINT — uma única chamada distribui em paralelo para fontes de WiFi, Bluetooth, torres de celular, IoT, câmeras e aeronaves, deduplica e pontua os resultados.
• Descoberta de câmeras — Shodan, FOFA, BinaryEdge, Windy Webcams, nós de vigilância do OpenStreetMap e Insecam, por coordenadas ou por país.
• Inteligência celular — consultas de torres de celular (WiGLE, OpenCellID) com resolução offline MCC/MNC → operadora/país e heurísticas de IMSI-catcher / Stingray.
• Detecção de ameaças sem fio — detecção de pontos de acesso rogue / evil-twin e identificação de rastreadores Bluetooth (AirTag, Tile, SmartTag…).
• Monitoramento do espaço aéreo — ADS-B ao vivo via adsb.fi e OpenSky, decodificação de squawk de emergência, heurísticas de drones e um mapa de calor de interferência GPS derivado do NAC-P de aeronaves.
• Rastreamento orbital — ingestão de TLE do CelesTrak com propagação SGP4, classificação de missões e sobreposição de estações terrestres SatNOGS.
• SDR e APRS — mapa público de receptores KiwiSDR e consultas de estações APRS.fi.
• Inteligência de ameaças IP — agregação de múltiplas fontes (ipinfo, AbuseIPDB, CriminalIP, LeakIX, ZoomEye) com varredura de portas leve e pontuação de risco combinada.
• Lista de vigilância e alertas — rastreie BSSIDs, SSIDs, IPs, MACs ou hexadecimais ICAO específicos e receba alertas durante as varreduras.
• Análise de IA (opcional) — o Google Gemini resume os resultados da varredura em avaliações e níveis de risco quando uma chave é fornecida.

Quase todas as fontes são opcionais. Se uma chave não estiver definida, esse buscador é ignorado normalmente — as fontes gratuitas (OpenStreetMap, Insecam, ipinfo.io, ADS-B, CelesTrak, KiwiSDR) funcionam sem nenhuma chave.

Capturas de tela

Mapa SIGINT — visão unificada de múltiplas fontes

O mapa principal funde camadas de WiFi, Bluetooth, celular, câmeras e aeronaves sobre a mesma área, com sobreposições alternáveis para câmeras OSM, redes ALPR/Flock e delegacias de polícia.

Vigilância e CCTV

Feed de vigilância	Descoberta de CCTV

A lista de vigilância pontua cada dispositivo (por exemplo, "Suspeita 35/100: câmera não autenticada") e mescla roteadores, TVs e câmeras expostas do WiGLE, Insecam e OSM. A visão CCTV agrupa as câmeras descobertas por fonte, com risco por câmera e status ao vivo/metadados.

Inteligência de torres de celular e SDR / APRS

Mapa de calor de torres de celular	Rede SDR / APRS

A inteligência de torres de celular traça a densidade de torres com consulta de operadora MCC/MNC; a visão SDR mapeia receptores KiwiSDR públicos e estações APRS com consulta de indicativo.

Requisitos

• Python 3.9+
• Os pacotes Python listados abaixo

Dependências principais:

flask
requests
python-dotenv

Recomendado (habilita funcionalidade completa — cache, limitação de taxa, propagação de satélites):

cachetools        # geo-cache limitada (usa um dict ilimitado como fallback se ausente)
flask-limiter     # limitação de taxa de requisições
sgp4              # propagação de posição de satélites para /api/satellites
google-genai      # análise de IA Gemini (apenas se você usar GEMINI_API_KEY)

Instale tudo:

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

Configuração

1. Clone e entre no projeto

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

2. (Opcional) crie um ambiente virtual

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

3. Instale as dependências

pip install -r requirements.txt

Se você não tiver um requirements.txt, use a linha pip install da seção Requisitos acima.

4. Configure seu ambiente

Copie o arquivo de exemplo e preencha as chaves que você possui:

cp .env.example .env

Em seguida, abra .env e cole suas chaves de API. Toda chave é opcional — deixe qualquer linha em branco (ou exclua-a) para desabilitar essa fonte. Veja a próxima seção para saber o que cada uma faz e onde obtê-la.

5. (Opcional) adicione conjuntos de dados locais

Para consultas instantâneas e offline de câmeras e delegacias, coloque estes arquivos em um diretório data/ (ou aponte DATA_DIR para outro local):

data/CAMERAS_WITH_NETWORK_DATA.geojson   # Feições de ponto (câmeras)
data/police_precincts_usa.geojson        # Feições de polígono (delegacias dos EUA)
data/camera_networks.json                # metadados de compartilhamento de rede
data/tiles/{z}/{x}/{y}.json              # conjunto de dados de câmeras em tiles (opcional)

Se esses arquivos estiverem ausentes, o aplicativo automaticamente recorre a consultas ao vivo do OpenStreetMap Overpass.

6. Execute

python app_v2.py

O servidor inicia em http://0.0.0.0:8080. Abra http://localhost:8080 no seu navegador.

Verifique quais provedores carregaram com sucesso a qualquer momento:

GET /api/status     # chaves ativas vs. ausentes
GET /api/debug      # booleano por chave + teste de autenticação WiGLE ao vivo

Variáveis de ambiente

Crie um arquivo .env na raiz do projeto. Abaixo está a lista completa lida pelo aplicativo.

Chaves de API de fontes de dados (todas opcionais)

Configuração do aplicativo

Fontes sem chave (sempre ativas)

Estas não precisam de configuração: OpenStreetMap Overpass, Insecam, EarthCam, ipinfo.io, ADS-B (adsb.fi / OpenSky), CelesTrak TLE, SatNOGS e KiwiSDR.

.env.example

Salve isto como .env.example no seu repositório para que outros saibam o formato:

# ── Ambiente Signal OPS ──
# Toda chave é opcional. Deixe em branco para desabilitar essa fonte.

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

# Scanners de exposição à 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âmeras e reputação de IP
WINDY_API_KEY=
ABUSEIPDB_API_KEY=

# Aeronaves e rádio amador
ADSB_API_KEY=
APRS_FI_KEY=

# Análise de IA
GEMINI_API_KEY=
GEMINI_MODEL=gemini-2.0-flash

# Configuração do aplicativo
DATA_DIR=./data
FLASK_SECRET_KEY=

Visão geral da API

Uma seleção dos endpoints expostos (veja o código-fonte para o conjunto completo):

Notas e limitações

• Alguns provedores (por exemplo, ZoomEye, CriminalIP) podem ser afetados por interferência de TLS em certos ISPs e estão desabilitados por padrão em algumas listas de varredura — veja os comentários inline no código-fonte para reabilitá-los atrás de uma VPN/proxy.
• Os limites de taxa variam amplamente entre provedores; os níveis gratuitos podem ser pequenos (o WiGLE celular é de ~100 consultas/dia, por exemplo). O aplicativo ignora ou recua quando possível, mas você é responsável por permanecer dentro dos limites de cada provedor.
• Os conjuntos de dados locais são opcionais, mas aceleram drasticamente as consultas de câmeras/delegacias em comparação com consultas Overpass ao vivo.