सिग्नल ओप्स

सुरक्षा अनुसंधान और प्रशिक्षण के लिए एक पूर्ण-स्पेक्ट्रम, सर्व-स्रोत सिग्नल इंटेलिजेंस फ्यूज़न प्लेटफ़ॉर्म। सिग्नल ओप्स दर्जनों खुले संग्रह स्रोतों — वाई-फाई/ब्लूटूथ/सेल-टावर डेटाबेस, इंटरनेट-एक्सपोज़र स्कैनर, कैमरा इंडेक्स, ADS-B उड़ान फ़ीड, सैटेलाइट TLE ट्रैकिंग, और SDR/APRS नेटवर्क — को एक ही सामरिक मानचित्र और Flask API में खींचता है, RF, सेलुलर, एयरस्पेस, कक्षीय, और निगरानी डोमेन को एक वास्तविक-समय परिचालन चित्र में सहसंबंधित करता है, जिसमें वैकल्पिक AI-सहायता प्राप्त खतरा सारांश शामिल हैं।

विशेषताएँ

• एकीकृत RF/OSINT स्कैन — एक कॉल वाई-फाई, ब्लूटूथ, सेल-टावर, IoT, कैमरा, और विमान स्रोतों तक समानांतर में फैलता है, डीडुप्लिकेट करता है, और परिणामों को स्कोर करता है।
• कैमरा खोज — Shodan, FOFA, BinaryEdge, Windy Webcams, OpenStreetMap निगरानी नोड्स, और Insecam, निर्देशांक या देश द्वारा।
• सेलुलर इंटेलिजेंस — ऑफ़लाइन MCC/MNC → ऑपरेटर/देश समाधान और IMSI-कैचर / Stingray अनुमान के साथ सेल-टावर लुकअप (WiGLE, OpenCellID)।
• वायरलेस खतरा पहचान — दुष्ट / ईविल-ट्विन एक्सेस पॉइंट पहचान और ब्लूटूथ ट्रैकर (AirTag, Tile, SmartTag…) पहचान।
• एयरस्पेस निगरानी — adsb.fi और OpenSky के माध्यम से लाइव ADS-B, आपातकालीन-स्क्वॉक डिकोडिंग, ड्रोन अनुमान, और विमान NAC-P से प्राप्त GPS-जैमिंग हीटमैप।
• कक्षीय ट्रैकिंग — SGP4 प्रसार, मिशन वर्गीकरण, और SatNOGS ग्राउंड-स्टेशन ओवरले के साथ CelesTrak TLE अंतर्ग्रहण।
• SDR और APRS — सार्वजनिक KiwiSDR रिसीवर मानचित्र और APRS.fi स्टेशन लुकअप।
• IP खतरा इंटेलिजेंस — बहु-स्रोत एकत्रीकरण (ipinfo, AbuseIPDB, CriminalIP, LeakIX, ZoomEye) हल्के पोर्ट स्कैन और संयुक्त जोखिम स्कोरिंग के साथ।
• वॉचलिस्ट और अलर्ट — विशिष्ट BSSID, SSID, IP, MAC, या ICAO हेक्स ट्रैक करें और स्कैन के दौरान हिट प्राप्त करें।
• AI विश्लेषण (वैकल्पिक) — Google Gemini स्कैन परिणामों को आकलन और जोखिम स्तरों में सारांशित करता है जब एक कुंजी प्रदान की जाती है।

लगभग हर स्रोत वैकल्पिक है। यदि कोई कुंजी सेट नहीं है, तो वह फ़ेचर शालीनता से छोड़ दिया जाता है — मुफ्त स्रोत (OpenStreetMap, Insecam, ipinfo.io, ADS-B, CelesTrak, KiwiSDR) बिना किसी कुंजी के काम करते हैं।

स्क्रीनशॉट

SIGINT मानचित्र — एकीकृत बहु-स्रोत दृश्य

मुख्य मानचित्र वाई-फाई, ब्लूटूथ, सेल, कैमरा, और विमान परतों को एक ही क्षेत्र पर जोड़ता है, जिसमें 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      # Gemini AI विश्लेषण (केवल यदि आप 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        # पॉलीगॉन फीचर्स (US थाने)
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     # सक्रिय बनाम लापता कुंजियाँ
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 / Cell
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) कुछ ISPs पर TLS हस्तक्षेप से प्रभावित हो सकते हैं और डिफ़ॉल्ट रूप से कुछ स्कैन सूचियों में अक्षम हैं — उन्हें VPN/प्रॉक्सी के पीछे फिर से सक्षम करने के लिए स्रोत में इनलाइन टिप्पणियाँ देखें।
• दर सीमाएँ प्रदाताओं के बीच व्यापक रूप से भिन्न होती हैं; मुफ्त टियर छोटे हो सकते हैं (उदाहरण के लिए WiGLE सेल ~100 क्वेरी/दिन है)। ऐप जहाँ कर सकता है छोड़ देता है या पीछे हट जाता है, लेकिन प्रत्येक प्रदाता की सीमाओं के भीतर रहना आपकी ज़िम्मेदारी है।
• स्थानीय डेटासेट वैकल्पिक हैं लेकिन लाइव Overpass क्वेरी की तुलना में कैमरा/थाना लुकअप को नाटकीय रूप से तेज़ करते हैं।