Signal OPS

Полноспектральная платформа слияния сигнальной разведки из всех источников для исследований и обучения в области безопасности. Signal OPS объединяет десятки открытых источников сбора данных — базы WiFi/Bluetooth/сотовых вышек, сканеры интернет-экспозиции, индексы камер, потоки ADS-B авиарейсов, спутниковое отслеживание TLE и сети SDR/APRS — в единую тактическую карту и Flask API, коррелируя радиочастотную, сотовую, воздушную, орбитальную и наблюдательную области в единую оперативную картину реального времени, с опциональными AI-ассистируемыми сводками угроз поверх.

Возможности

• Единое RF/OSINT сканирование — один вызов параллельно распределяется по источникам WiFi, Bluetooth, сотовых вышек, IoT, камер и воздушных судов, дедуплицирует и оценивает результаты.
• Обнаружение камер — Shodan, FOFA, BinaryEdge, Windy Webcams, узлы наблюдения OpenStreetMap и Insecam, по координатам или по стране.
• Сотовая разведка — поиск сотовых вышек (WiGLE, OpenCellID) с офлайн-разрешением MCC/MNC → оператор/страна и эвристиками IMSI-ловушек / Stingray.
• Обнаружение беспроводных угроз — обнаружение мошеннических / evil-twin точек доступа и идентификация Bluetooth-трекеров (AirTag, Tile, SmartTag…).
• Мониторинг воздушного пространства — живой ADS-B через adsb.fi и OpenSky, декодирование аварийных сквоков, эвристики дронов и тепловая карта GPS-глушения, полученная из NAC-P воздушных судов.
• Орбитальное отслеживание — загрузка TLE CelesTrak с распространением SGP4, классификация миссий и наложение наземных станций SatNOGS.
• SDR и APRS — публичная карта приёмников KiwiSDR и поиск станций APRS.fi.
• IP-разведка угроз — агрегация из нескольких источников (ipinfo, AbuseIPDB, CriminalIP, LeakIX, ZoomEye) с лёгким сканированием портов и комбинированной оценкой риска.
• Список наблюдения и оповещения — отслеживание конкретных BSSID, SSID, IP, MAC или ICAO hex и получение совпадений во время сканирования.
• AI-анализ (опционально) — Google Gemini обобщает результаты сканирования в оценки и уровни риска при наличии ключа.

Почти каждый источник опционален. Если ключ не задан, соответствующий загрузчик корректно пропускается — бесплатные источники (OpenStreetMap, Insecam, ipinfo.io, ADS-B, CelesTrak, KiwiSDR) работают вообще без ключей.

Скриншоты

Карта SIGINT — единое многопоточное представление

Основная карта объединяет слои WiFi, Bluetooth, сотовых, камер и воздушных судов над одной областью, с переключаемыми оверлеями для камер OSM, сетей ALPR/Flock и полицейских участков.

Наблюдение и CCTV

Лента наблюдения	Обнаружение CCTV

Список наблюдения оценивает каждое устройство (например, «Подозрение 35/100: Неаутентифицированная камера») и объединяет маршрутизаторы, телевизоры и открытые камеры из WiGLE, Insecam и OSM. Представление CCTV группирует обнаруженные камеры по источникам с оценкой риска для каждой камеры и статусом живого/метаданных.

Разведка сотовых вышек и SDR / APRS

Тепловая карта сотовых вышек	Сеть SDR / APRS

Разведка сотовых вышек отображает плотность вышек с поиском оператора MCC/MNC; представление SDR отображает публичные приёмники KiwiSDR и станции APRS с поиском позывных.

Требования

• Python 3.9+
• Пакеты Python, перечисленные ниже

Основные зависимости:

flask
requests
python-dotenv

Рекомендуемые (включают полную функциональность — кэширование, ограничение скорости, распространение спутников):

cachetools        # ограниченный гео-кэш (использует неограниченный dict, если отсутствует)
flask-limiter     # ограничение скорости запросов
sgp4              # распространение позиций спутников для /api/satellites
google-genai      # AI-анализ Gemini (только если используется GEMINI_API_KEY)

Установка всего:

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

Настройка

1. Клонируйте и войдите в проект

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

2. (Опционально) создайте виртуальное окружение

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

3. Установите зависимости

pip install -r requirements.txt

Если у вас нет requirements.txt, используйте строку pip install из раздела «Требования» выше.

4. Настройте ваше окружение

Скопируйте пример файла и заполните ключи, которые у вас есть:

cp .env.example .env

Затем откройте .env и вставьте ваши API-ключи. Каждый ключ опционален — оставьте любую строку пустой (или удалите её), чтобы отключить этот источник. См. следующий раздел о том, что делает каждый ключ и где его получить.

5. (Опционально) добавьте локальные наборы данных

Для мгновенного офлайн-поиска камер и участков разместите эти файлы в каталоге data/ (или укажите DATA_DIR в другом месте):

data/CAMERAS_WITH_NETWORK_DATA.geojson   # Точечные объекты (камеры)
data/police_precincts_usa.geojson        # Полигональные объекты (участки США)
data/camera_networks.json                # метаданные совместного использования сетей
data/tiles/{z}/{x}/{y}.json              # опциональный тайловый набор данных камер

Если эти файлы отсутствуют, приложение автоматически переключается на живые запросы OpenStreetMap Overpass.

6. Запуск

python app_v2.py

Сервер запускается на http://0.0.0.0:8080. Откройте http://localhost:8080 в вашем браузере.

Проверьте, какие провайдеры загрузились успешно, в любое время:

GET /api/status     # активные vs. отсутствующие ключи
GET /api/debug      # логическое значение по ключу + живой тест аутентификации WiGLE

Переменные окружения

Создайте файл .env в корне проекта. Ниже приведён полный список переменных, читаемых приложением.

API-ключи источников данных (все опциональны)

Конфигурация приложения

Источники без ключей (всегда включены)

Эти не требуют настройки: OpenStreetMap Overpass, Insecam, EarthCam, ipinfo.io, ADS-B (adsb.fi / OpenSky), CelesTrak TLE, SatNOGS и KiwiSDR.

.env.example

Сохраните это как .env.example в вашем репозитории, чтобы другие знали формат:

# ── Окружение Signal OPS ──
# Каждый ключ опционален. Оставьте пустым, чтобы отключить этот источник.

# WiFi / Bluetooth / Сотовая
WIGLE_API_NAME=
WIGLE_API_TOKEN=
OPENCELLID_API_KEY=

# Сканеры интернет-экспозиции
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=

# Камеры и репутация IP
WINDY_API_KEY=
ABUSEIPDB_API_KEY=

# Воздушные суда и любительское радио
ADSB_API_KEY=
APRS_FI_KEY=

# AI-анализ
GEMINI_API_KEY=
GEMINI_MODEL=gemini-2.0-flash

# Конфигурация приложения
DATA_DIR=./data
FLASK_SECRET_KEY=

Обзор API

Выборка доступных конечных точек (полный набор см. в исходном коде):

Примечания и ограничения

• Некоторые провайдеры (например, ZoomEye, CriminalIP) могут быть подвержены TLS-помехам на определённых ISP и по умолчанию отключены в паре списков сканирования — см. встроенные комментарии в исходном коде, чтобы повторно включить их за VPN/прокси.
• Лимиты скорости сильно различаются между провайдерами; бесплатные тарифы могут быть небольшими (например, сотовая WiGLE — ~100 запросов в день). Приложение пропускает или отступает, где может, но вы несёте ответственность за соблюдение лимитов каждого провайдера.
• Локальные наборы данных опциональны, но значительно ускоряют поиск камер/участков по сравнению с живыми запросами Overpass.