6 मुफ़्त थ्रेट इंटेल API पर IPs, डोमेन, हैश और CVE की जाँच करें — ब्राउज़र टैब के बीच स्विच किए बिना।

क्विक स्टार्ट · उपयोग · आर्किटेक्चर · API कुंजियाँ · स्क्रीनशॉट · योगदान

🚀 गर्व के साथ आधिकारिक Awesome OSINT रिपॉज़िटरी में शामिल।

📖 अवलोकन

ThreatLens एक एकल कमांड-लाइन टूल है जो सबसे भरोसेमंद मुफ़्त OSINT स्रोतों में थ्रेट इंटेलिजेंस लुकअप को एकीकृत करता है। किसी IP को पाँच अलग-अलग वेबसाइटों में पेस्ट करने के बजाय, ThreatLens उन सभी को समानांतर रूप से क्वेरी करता है, परिणामों को सामान्यीकृत करता है, और आपको एक स्पष्ट निर्णय देता है — टर्मिनल में, या एक सुसज्जित, रंग-कोडित Excel/JSON/CSV रिपोर्ट में।

SOC विश्लेषकों, इंसिडेंट रिस्पॉन्डरों, थ्रेट हंटरों, और किसी भी व्यक्ति के लिए बनाया गया जो शेल छोड़े बिना तेज़, विश्वसनीय IOC संवर्धन चाहता है।

ThreatLens क्यों

पाँच ब्राउज़र टैब के बजाय एक कमांड
कच्चे लॉग से सीधे IOC स्वतः निकालता है
एक विफल/दर-सीमित API कभी बाकी को नहीं रोकता
पूरी तरह से मुफ़्त API टियर पर काम करता है
स्थानीय SQLite कैश — बार-बार किए गए लुकअप तुरंत होते हैं
अनुरोध बजट सीमा अनियंत्रित API खर्च को रोकती है

इसके लिए नहीं

रीयल-टाइम/स्ट्रीमिंग डिटेक्शन पाइपलाइन
केवल सशुल्क/एंटरप्राइज़ इंटेल फ़ीड
पूर्ण SIEM या SOAR प्लेटफ़ॉर्म को बदलना

✨ विशेषताएँ

विशेषता	विवरण
🎯 IOC प्रकार	IP, डोमेन, URL, फ़ाइल हैश (MD5 / SHA1 / SHA256), CVE
🔌 एकीकृत API	AbuseIPDB, VirusTotal, AlienVault OTX, Shodan, URLScan.io, NVD, CISA KEV, EPSS
📄 लॉग पार्सिंग	सादे टेक्स्ट/लॉग फ़ाइलों से IOC स्वतः निकालें, साथ ही Zeek, Suricata `eve.json`, Sysmon (JSON), और सामान्य JSONL के लिए मूल समर्थन
🧭 CVE निर्णय कार्ड	प्रत्येक CVE के लिए नियतात्मक, व्याख्यायोग्य Patch / Isolate / Monitor / Not affected अनुशंसा, जो CISA KEV, EPSS, CVSS, और सहसंबद्ध एसेट एक्सपोज़र द्वारा संचालित
🗂️ एसेट इन्वेंटरी	महत्व और इंटरनेट-फेसिंग स्थिति के साथ होस्ट/IP की CSV आयात करें; CVE परिणामों के विरुद्ध सहसंबद्ध
📤 SIEM निर्यात	Splunk HEC, Elastic `_bulk`, और Microsoft Sentinel (आधुनिक Logs Ingestion API) में ऑप्ट-इन निर्यात
🧾 साक्ष्य पैक	बुनियादी चेन-ऑफ-कस्टडी के लिए SHA-256 मैनिफ़ेस्ट के साथ किसी जाँच का ZIP निर्यात
📊 रिपोर्ट	Excel (रंग-कोडित), JSON, CSV
💾 स्थानीय कैश	कॉन्फ़िगर करने योग्य TTL के साथ SQLite कैश — ज्ञात IOC को पुनः क्वेरी करना छोड़ें, साथ ही एक कैश्ड CISA KEV फ़ीड (24h TTL)
🛡️ सुरक्षा	रीडायरेक्ट अवरोधन, होस्ट अनुमति-सूची, लॉग में API-कुंजी संपादन, स्प्रेडशीट-फ़ॉर्मूला निष्क्रियीकरण, CSV/लॉग DoS सीमाएँ
🔒 लॉकफ़ाइल	पुनरुत्पादक इंस्टॉल के लिए SHA-256 हैश के साथ `requirements.lock`
💻 CLI अनुभव	समृद्ध प्रगति बार, रंगीन तालिकाएँ, और एक स्पष्ट निर्णय सारांश
🧩 आर्किटेक्चर	मॉड्यूलर एनरिचर/पार्सर/निर्यातक, टाइप्ड मॉडल, चिंताओं का सख्त पृथक्करण
✅ परीक्षित	`pytest` के साथ 155 यूनिट और इंटीग्रेशन परीक्षण; GitHub Actions के माध्यम से CI
⚡ लचीला	एक विफल API या SIEM गंतव्य कभी अन्य को अवरुद्ध नहीं करता — त्रुटियाँ पृथक और लॉग की जाती हैं

🚀 त्वरित शुरुआत

# 1. Clone & install
git clone https://github.com/AbdaullahAG/threatlens.git
cd threatlens
pip install -r requirements.txt

# 2. Configure your API keys
cp config/keys.env.example config/keys.env
# → edit config/keys.env and fill in your keys

# 3. Run your first scan
python main.py -i 45.33.32.156

💡 NVD (CVE लुकअप) बिना किसी API कुंजी के सीधे काम करता है। हर अन्य API एक निःशुल्क टियर प्रदान करता है जिसके लिए साइन अप करने में 2 मिनट से भी कम समय लगता है — नीचे API Keys देखें।

पुनरुत्पादनीय इंस्टॉल (लॉक की गई निर्भरताओं के साथ)

pip install --require-hashes -r requirements.lock

🧰 उपयोग

`# Investigate a single IP python main.py -i 45.33.32.156`	बुनियादी एकल-IOC लुकअप
`# Investigate multiple IOC types at once python main.py -i 45.33.32.156 -d malware.example.com \ -s d41d8cd98f00b204e9800998ecf8427e -c CVE-2021-44228`	एक ही रन में IOC प्रकारों को मिलाएँ और मिलाएँ
`# Parse a log file — all IOCs auto-extracted python main.py --file /var/log/apache2/access.log`	सीधे कच्चे लॉग से बल्क जाँच करें
`# Output JSON instead of Excel python main.py -i 8.8.8.8 --format json`	पाइपलाइनों के लिए मशीन-पठनीय आउटपुट
`# Use only specific APIs python main.py -i 8.8.8.8 --apis abuseipdb virustotal`	चयनित स्रोतों तक संवर्धन सीमित करें
`# Generate every report format at once python main.py --file access.log --format all`	एक ही रन में Excel + JSON + CSV
`# Lookup a CVE — no API key needed python main.py -c CVE-2021-44228 --apis nvd --format json`	NIST NVD के माध्यम से CVE संवर्धन (मुफ़्त, कोई कुंजी नहीं)
`# Verbose / debug mode python main.py -i 8.8.8.8 -v`	समस्या निवारण के लिए पूर्ण अनुरोध/प्रतिक्रिया लॉगिंग
`# Check a CVE against CISA KEV + EPSS, with an asset-aware decision python main.py -c CVE-2021-44228 --apis nvd cisa_kev epss \ --import-assets assets.csv --decision-cards`	पैच / अलग करें / निगरानी करें / प्रभावित नहीं होने की सिफ़ारिश
`# Parse a Suricata eve.json and export to Splunk python main.py --file eve.json --log-format suricata \ --export splunk`	SOC लॉग अंतर्ग्रहण → SIEM निर्यात
`# Build a hash-manifested evidence pack for the investigation python main.py -i 45.33.32.156 --evidence-pack`	चेन-ऑफ-कस्टडी के लिए SHA-256 मैनिफ़ेस्ट के साथ ZIP

सभी CLI फ़्लैग देखें

सबसे लोकप्रिय

ThreatLens

📖 अवलोकन

✨ विशेषताएँ

🚀 त्वरित शुरुआत

पुनरुत्पादनीय इंस्टॉल (लॉक की गई निर्भरताओं के साथ)

🧰 उपयोग