
Panthera(P.)uncia - Subdomain Center और Exploit Observer के लिए आधिकारिक CLI उपयोगिता।
# Panthera(P.)uncia
### Subdomain Center और Exploit Observer के लिए आधिकारिक CLI उपयोगिता
[](https://pepy.tech/project/puncia)
<img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat">
<img alt="GitHub stars" src="https://img.shields.io/github/stars/ARPSyndicate/puncia">
<br>
<img src="https://assets.kitploit.com/production/public/readmes/6160/33d46e3bd32a568d803e1c86fae2d2bc3ae90d229a6a41d71f265865d5e55500.png" width=25%>
<br>
**Puncia** दो A.R.P. Syndicate इंटेलिजेंस API के लिए आधिकारिक कमांड-लाइन क्लाइंट है — इसे किसी डोमेन, ब्रांड या किसी वल्नरेबिलिटी ID पर इंगित करें और कुछ ही सेकंड में संरचित JSON प्राप्त करें, बिना किसी ब्राउज़र की आवश्यकता के:
- 🕸️ **[Subdomain Center](https://subdomain.center)** — इंटरनेट स्तर पर सबडोमेन एन्यूमरेशन, **सबडोमेन टेकओवर** का पता लगाना, **शैडो IT डिस्कवरी**, और **ब्रांड इम्पर्सोनेशन / मिलते-जुलते डोमेन (टाइपोस्क्वाट) का पता लगाना**।
- 💥 **[Exploit Observer](https://exploit.observer)** — 150+ पहचानकर्ता स्कीमों (CVE, GHSA, EDB, MSF, ZDI, राष्ट्र-राज्य फ़ीड्स और अन्य) में एक्सप्लॉइट और वल्नरेबिलिटी इंटेलिजेंस, प्रत्येक लुकअप पर EPSS + VEDAS परिपक्वता स्कोरिंग और SBOM स्कैनिंग के साथ।
```text
$ puncia subdomain arpsyndicate.io
╭──────────────────────────────────────────────────────────────────────╮
│ Panthera(P.)uncia v0.42 │
│ subdomain recon · brand impersonation · exploit intel · sbom analysis│
│ A.R.P. Syndicate — https://www.arpsyndicate.io │
╰──────────────────────────────────────────────────────────────────────╯
[
"advisories.arpsyndicate.io",
"asm.arpsyndicate.io",
"blog.arpsyndicate.io",
...
]
$ puncia sbom bom.json ./out
puncia ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% (128/128) 0:00:41
```
**कृपया ध्यान दें कि हालाँकि ये परिणाम कभी-कभी काफी गलत और अविश्वसनीय हो सकते हैं, फिर भी इनकी स्व-सुधार क्षमताओं के कारण ये समय-समय पर काफी भिन्न हो सकते हैं।**
**API कुंजी के साथ आक्रामक दर-सीमाओं से बचा जा सकता है: https://www.arpsyndicate.io/pricing.html**
## व्यावहारिक अनुप्रयोग
1. **ब्रांड प्रतिरूपण और फ़िशिंग डोमेन पहचान**
आपके ब्रांड पर आधारित रेप्लिका, लुकअलाइक और टाइपोस्क्वाट डोमेन को उजागर करें, इससे पहले कि उनका उपयोग आपके या आपके ग्राहकों के विरुद्ध किया जाए।
2. **शैडो IT और बाहरी हमला सतह खोज**
आधिकारिक चैनलों के बाहर बनाए गए उजागर सबडोमेन और अवसंरचना की पहचान करें और निगरानी करें।
3. **सबडोमेन टेकओवर रेकनासांस**
किसी लक्ष्य के पूर्ण सबडोमेन फ़ुटप्रिंट की गणना करें, जो डैंगलिंग/टेकओवर-प्रवण रिकॉर्ड की पहचान करने में एक महत्वपूर्ण पहला कदम है।
4. **उन्नत भेद्यता अनुसंधान और निगरानी**
ज्ञात और उभरते खतरों की खोज और ट्रैकिंग करें, जिनमें अस्पष्ट या अनसूचीबद्ध भेद्यताएँ भी शामिल हैं।
5. **स्कोर किया गया CVE/GHSA इंटेलिजेंस**
प्रत्येक लुकअप में EPSS + VEDAS परिपक्वता स्कोर और CVSS शामिल होते हैं, ताकि ज्ञात भेद्यताओं को संदर्भ में प्राथमिकता दी जा सके।
6. **सॉफ़्टवेयर बिल ऑफ़ मटेरियल्स (SBOM) में भेद्यता पहचान**
संरचित SBOM डेटा का उपयोग करके सॉफ़्टवेयर घटकों का ज्ञात शोषणों और सुरक्षा मुद्दों के लिए विश्लेषण करें।
7. **CI/CD और थ्रेट इंटेल वर्कफ़्लो के साथ सहज एकीकरण**
विकास या सुरक्षा पाइपलाइनों के भीतर इंटेलिजेंस संग्रह और भेद्यता जाँच को स्वचालित करें।
8. **राष्ट्र-राज्य शोषण प्रवृत्तियों की निगरानी**
विदेशी अभिकर्ताओं द्वारा चिह्नित लेकिन मुख्यधारा के डेटाबेस द्वारा अभी तक मान्यता प्राप्त नहीं की गई भेद्यताओं को ट्रैक करके खतरों से आगे रहें।
9. **कीवर्ड-आधारित सबडोमेन खोज**
किसी विशिष्ट पैरेंट डोमेन से स्वतंत्र, इंटरनेट पर दिए गए कीवर्ड वाले होस्ट को उजागर करें।
10. **बल्क थ्रेट इंटेलिजेंस प्रोसेसिंग**
बड़े डेटासेट या एंटरप्राइज़ एसेट इन्वेंटरी में स्केलेबल विश्लेषण के लिए बैच क्वेरी (डोमेन, भेद्यताएँ, आदि) चलाएँ।
11. **रेड टीम्स के लिए निष्क्रिय रेकनासांस**
निष्क्रिय डेटा स्रोतों का उपयोग करके (लक्ष्यों के साथ सीधा संपर्क नहीं) गुप्त रेकनासांस संचालित करें।
12. **ओपन सोर्स इंटेलिजेंस (OSINT) संग्रह**
OSINT जाँचों को बढ़ाने के लिए सबडोमेन और शोषण इंटेलिजेंस को संयोजित करें।
13. **अनुपालन और जोखिम प्रबंधन सहायता**
गहरे संदर्भ के साथ अनुपालन ऑडिट (जैसे, ISO 27001, SOC 2) का समर्थन करने के लिए भेद्यता डेटा को समृद्ध करें।
## इंस्टॉलेशन
1. PyPi से - `pip3 install puncia`
2. स्रोत से - `pip3 install .`<br>
### 30-सेकंड क्विकस्टार्ट
```bash
pip3 install puncia
# subdomain footprint of a target (shadow IT / attack surface / takeover recon)
puncia subdomain example.com
# lookalike / typosquat / brand-impersonation domains
puncia replica example.com
# what's known about a CVE
puncia exploit CVE-2021-44228
```
## उपयोग
```
puncia <mode> <query> [output] [--match M] [--domain D] [--limit N] [--offset N]
[--crawl] [--filter KEY=VALUE] [--format json|csv]
[--api-key K] [--concurrency N]
[--timeout S] [--retries N] [--quiet]
```
पूर्ण संदर्भ के लिए `puncia --help` चलाएँ। परिणाम **stdout** पर प्रिंट होते हैं;
bैनर, प्रगति बार, चेतावनियाँ और त्रुटियाँ सभी **stderr** पर जाती हैं, इसलिए
`puncia subdomain example.com > out.json` हमेशा साफ़, वैध JSON देता है।
**एग्ज़िट कोड:** `0` सफलता · `1` अनुरोध या इनपुट त्रुटि · `2` उपयोग त्रुटि।
1. (सशुल्क) एक API कुंजी संग्रहीत करें (storekey) - `puncia storekey <api-key>`
- `~/.puncia` में `0600` अनुमतियों के साथ संग्रहीत। `$PUNCIA_API_KEY` इसे ओवरराइड करता है,
जो आमतौर पर CI में आपको चाहिए होता है।
2. (फ्रीमियम) डोमेन क्वेरी करें, डोमेन द्वारा क्लस्टर किए गए (सबडोमेन / `cuttlefish` इंजन) - `puncia subdomain <domain> <output-file>`
- **पेजिनेशन (केवल प्रमाणित):** एक प्रमाणित परिणाम की कोई कुल
सीमा नहीं होती। डिफ़ॉल्ट रूप से `subdomain`/`replica`/`keyword` हर पेज को पार करते हैं और
आपके लिए उन्हें मर्ज करते हैं, पेजों में डुप्लिकेट हटाते हुए; `--limit` (1–1,000,000) पेज का आकार सेट करता है, अन्यथा API का डिफ़ॉल्ट 200,000 प्रत्येक पेज पर स्पष्ट रूप से उपयोग किया जाता है। इसके बजाय स्वयं ठीक एक कच्चा पेज प्राप्त करने के लिए `--offset` पास करें, उदाहरण के लिए एक फिर से शुरू करने योग्य या स्ट्रीमिंग वॉक के लिए:
```bash
puncia subdomain bigco.com --limit 50000 --offset 0
# stderr prints: note: more results available — continue with --offset 50000 --limit 50000
puncia subdomain bigco.com --limit 50000 --offset 50000
```
संकेत उन पंक्तियों द्वारा आगे बढ़ता है जो पेज ने वास्तव में लौटाईं, इसलिए लगातार
मैन्युअल पेज कुछ पंक्तियों तक ओवरलैप हो सकते हैं — जब आप उन्हें
जोड़ते हैं तो डुप्लिकेट हटाएं।
अनाम अनुरोध सर्वर-साइड पर `--limit`/`--offset` को अनदेखा करते हैं (हमेशा 500 पंक्तियों तक का
फेरबदल किया गया नमूना); puncia चेतावनी देता है बजाय यह दिखाने के कि उन्होंने कुछ किया।
- **लाइव क्रॉल (केवल प्रमाणित):** `--crawl` संग्रहीत परिणामों को
एक लाइव डिस्कवरी पास के साथ पूरक करता है। एक दिया गया डोमेन वास्तव में केवल हर ~6h में एक बार
फिर से क्रॉल किया जाता है — उस विंडो के भीतर के अनुरोधों को कैश्ड क्रॉल परिणाम
तुरंत मिलता है। Puncia stderr पर परिणाम की रिपोर्ट करता है:
`crawl: fresh, 12 newly discovered name(s)` (साथ ही `partial` / `running` /
`cooldown` / `disabled`)। `partial`/`running` पर क्रॉल का हिस्सा
अभी भी सर्वर-साइड चल रहा है; बाकी के लिए एक मिनट में `--crawl` के साथ फिर से चलाएं।
```bash
puncia subdomain bigco.com --crawl
```
3. (फ्रीमियम) रेप्लिका डोमेन क्वेरी करें, ब्रांड द्वारा क्लस्टर किए गए (रेप्लिका / `octopus` इंजन) - `puncia replica <domain> --match <prefix|exact|substring> <output-file>`
4. (फ्रीमियम) कीवर्ड द्वारा क्वेरी करें, कीवर्ड द्वारा क्लस्टर किए गए (कीवर्ड / `ammonites` इंजन) - `puncia keyword <keyword> --match <exact|prefix> <output-file>`
- वैकल्पिक रूप से कीवर्ड को `--domain` के साथ एकल डोमेन तक सीमित करें:
`puncia keyword blog --domain bandcamp.com`
5. एक्सप्लॉइट और भेद्यता पहचानकर्ता क्वेरी करें (exploit)
- (मुफ़्त) वॉचलिस्ट (^WATCHLIST_IDES) — नवीनतम क्रॉल में **ट्रेंडिंग** CVEs और उसमें **पहली बार शोषण योग्य** बने CVEs; हर क्रॉल में पुनर्निर्मित - `puncia exploit ^WATCHLIST_IDES <output-file>`
- (मुफ़्त) विवरण के साथ भेद्यता और एक्सप्लॉइट पहचानकर्ता वॉचलिस्ट (^WATCHLIST_INFO) - `puncia exploit ^WATCHLIST_INFO <output-file>`
- (मुफ़्त) भेद्य प्रौद्योगिकियां वॉचलिस्ट (^WATCHLIST_TECH) - `puncia exploit ^WATCHLIST_TECH <output-file>`
- (मुफ़्त) भेद्यता/एक्सप्लॉइट आंकड़े एकत्र करें (^STATS) - `puncia exploit ^STATS <output-file>`
- (मुफ़्त) सेवा स्वास्थ्य (^HEALTH) - `puncia exploit ^HEALTH <output-file>`
- (फ्रीमियम) [समर्थित भेद्यता पहचानकर्ता](https://github.com/ARPSyndicate/docs?tab=readme-ov-file#supported-vulnerability-identifiers) - `puncia exploit <eoidentifier> --match <substring|prefix|exact> <output-file>`
- Metasploit मॉड्यूल उनके Rapid7 मॉड्यूल पेज (`ruby` बकेट) के रूप में वापस आते हैं।
एक सार्वजनिक PoC वाला CVE id लेकिन **अभी तक कोई प्रकाशित CVE रिकॉर्ड नहीं** (एक आरक्षित
id जो PoC लेखक ने पहले प्रकाशित किया) `** UNPUBLISHED ** ` से शुरू होने वाले विवरण के साथ
लौटाया जाता है जो साक्ष्य का सारांश देता है।
6. (सशुल्क) VEDAS समूह द्वारा गैर-CVE पहचानकर्ता (noncve) - `puncia noncve <browser/china/russia/europe/exploitable> <output-file>`
7. (सशुल्क) Nuclei टेम्पलेट उम्मीदवार (nuclei) - `puncia nuclei candidates <output-file>`
- वे CVEs जिनके पास VEDAS id है और **अभी तक कोई nuclei टेम्पलेट नहीं** है लेकिन
टेम्पलेट करने योग्य लगते हैं, उच्चतम प्राथमिकता पहले (`priority = feasibility × impact`)।
प्रत्येक पंक्ति में एक सुझाया गया टेम्पलेट आकार होता है (प्रोटोकॉल, विधि — `active`,
`oast`, `version`, `fingerprint-first` — क्या इसे प्रमाणीकरण चाहिए, क्या इस तक HTTP के ज़रिए पहुँचने की संभावना है, इसकी सतह, क्या यह पढ़ने या स्थिति बदलने वाला है, और XSS का प्रकार), पैकेज इकोसिस्टम, PoC स्रोत, पोर्टेबल afrog/xray/jaeles/goby टेम्पलेट, परीक्षण वातावरण, उसी उत्पाद के लिए मौजूदा टेम्पलेट, और स्कोर के पीछे के कारण।
- हर पेज स्वचालित रूप से फ़ेच और मर्ज किया जाता है; `--limit` पेज साइज़ सेट करता है (अधिकतम 1000) और `--offset` इसके बजाय ठीक एक पेज फ़ेच करता है (stderr तब बताता है कि आप रैंकिंग में कितनी दूर हैं और कैसे जारी रखें)।
- दोहराए जा सकने वाले `--filter KEY=VALUE` से सीमित करें: `min_feasibility`, `vendor`, `product`, `platform`, `cwe`, `method`, `protocol`, `kev`, `poc`, `portable`।
- **CSV निर्यात:** `--format csv`, या बस `.csv` में समाप्त होने वाला आउटपुट पथ दें — प्रति CVE एक पंक्ति, जिसमें `shape` ऑब्जेक्ट को उसके अपने कॉलम में समतल किया गया है (`protocol`, `method`, `authenticated`, `likely_http`, `surface`, `state_change`, `xss_kind`), सूची फ़ील्ड `;` से जोड़े गए हैं (कारण ` | ` से), और जिन सेल को स्प्रेडशीट फ़ॉर्मूला मान लेगी उन्हें निष्क्रिय बनाया गया है।
```bash
puncia nuclei candidates candidates.csv
puncia nuclei candidates wp.csv --filter platform=wordpress --filter poc=true
puncia nuclei candidates --filter kev=true --filter min_feasibility=0.5 --format csv > kev.csv
```
8. (मुफ़्त) Subdomain Center सेवा स्वास्थ्य (^HEALTH) - `puncia subdomain ^HEALTH <output-file>`
9. एकाधिक क्वेरी (bulk/sbom)
- (FREEMIUM) बल्क इनपुट JSON फ़ाइल फ़ॉर्मेट - `puncia bulk <json-file> <output-directory>`
```json
{
"subdomain": [
"domainA.com",
"domainB.com"
],
"replica": [
"domainA.com",
"domainB.com"
],
"keyword": [
"keywordA",
"keywordB"
],
"exploit": [
"eoidentifierA",
"eoidentifierB"
]
}
```
- (FREEMIUM) [SBOM इनपुट JSON फ़ाइल फ़ॉर्मेट](https://github.com/CycloneDX/bom-examples/blob/master/SBOM/protonmail-webclient-v4-0912dff/bom.json) - `puncia sbom <json-file> <output-directory>`
बल्क और SBOM रन क्वेरीज़ को डुप्लिकेट हटाते हैं, समानांतरता को `--concurrency`
(डिफ़ॉल्ट 10) तक सीमित करते हैं, और — जब कोई API कुंजी मौजूद न हो — तो अनुरोधों की गति को
स्वचालित रूप से फ़्री-टियर बजट के भीतर रखने के लिए नियंत्रित करते हैं। प्रत्येक परिणाम
`<output-directory>/<mode>/<query>.json` पर सहेजा जाता है; जो क्वेरी जैसी है वैसी
फ़ाइलनाम के रूप में उपयोग करने योग्य नहीं है (पथ विभाजक, नियंत्रण वर्ण, कोई Windows डिवाइस नाम,
200 से अधिक वर्ण, या किसी अन्य क्वेरी का केस-वेरिएंट) उसे साफ़ किया जाता है और उसमें
एक छोटा `~<hash>` प्रत्यय जोड़ा जाता है ताकि दो क्वेरीज़ कभी एक ही फ़ाइल साझा न कर सकें। जो रन
कोई भी मान्य क्वेरी नहीं पाता, वह `1` के साथ बाहर निकलता है; जिसमें विफल क्वेरीज़ हों, वह भी हर अन्य
परिणाम लिखने और stderr पर विफलताओं को सूचीबद्ध करने के बाद `1` के साथ बाहर निकलता है।
10. (FREEMIUM) बाहरी आयात
```python
import asyncio
import puncia
async def main():
# Without an API key (ratelimited)
print(await puncia.query_api("exploit", "CVE-2021-3450"))
print(await puncia.query_api("subdomain", "arpsyndicate.io"))
# With an API key
await puncia.store_key("ARPS-xxxxxxxxxx")
api_key = await puncia.read_key()
print(await puncia.query_api("subdomain", "arpsyndicate.io", apikey=api_key))
print(await puncia.query_api("replica", "arpsyndicate.io", match="exact", apikey=api_key))
print(await puncia.query_api("noncve", "exploitable", apikey=api_key))
# Nuclei template candidates: filtered, every page merged, saved as CSV
candidates = await puncia.query_api(
"nuclei", "candidates", "candidates.csv", apikey=api_key,
filters={"platform": "wordpress", "poc": "true"}, output_format="csv",
)
print(puncia.candidates_to_csv(candidates)) # or render CSV yourself
# Static endpoints (unauthenticated, unlimited)
print(await puncia.query_api("subdomain", "^HEALTH"))
print(await puncia.query_api("exploit", "^STATS"))
# Live crawl, with the outcome surfaced via a callback
await puncia.query_api(
"subdomain", "bigco.com", apikey=api_key, crawl=True,
on_crawl=lambda h: print("crawl status:", h.get("X-Crawl-Status")),
)
# Write straight to disk
await puncia.query_api("subdomain", "arpsyndicate.io", "out.json", apikey=api_key)
asyncio.run(main())
```
विफलताएँ `puncia.PunciaError` उठाती हैं; एक खाली परिणाम (`{}` / `[]`) को त्रुटि मानने के बजाय जैसा है वैसा ही लौटाया जाता है। अनाम कॉल प्रति API एक प्रक्रिया-व्यापी मुफ़्त-स्तरीय लिमिटर साझा करते हैं, इसलिए `query_api` पर एक लूप बिना किसी अतिरिक्त प्लंबिंग के सही गति से चलता है; `session=` पास करके कई क्वेरीज़ में एक ही सत्र का पुनः उपयोग करें (`timeout=` अभी भी प्रति अनुरोध लागू होता है), और अपना स्वयं का `limiter=` केवल तब पास करें जब आपको भिन्न गति-नियंत्रण चाहिए, ठीक वैसे ही जैसे `process_bulk()` करता है।
```python
from puncia import PunciaError, query_api
try:
data = await query_api("exploit", "CVE-2021-3450", apikey=api_key)
except PunciaError as exc:
print(f"lookup failed: {exc}")
```
<br>
## विकास
```bash
git clone https://github.com/ARPSyndicate/puncia && cd puncia
pip install --upgrade pip # editable installs need pip >= 21.3
pip install -e ".[dev]"
pytest # 154 offline tests, no API calls or network access
```
परीक्षण सूट पूरी तरह से ऑफ़लाइन है — यह URL निर्माण, आउटपुट-पथ
निहितार्थ, SBOM पार्सिंग, बल्क प्लानिंग, पेज वॉकिंग, CLI संकेत और
नेटवर्क को छुए बिना रेटलिमिटर टाइमिंग को कवर करता है, इसलिए इसे किसी भी
वातावरण में चलाना सुरक्षित है।
## उल्लेखनीय उल्लेख
- [Passive Subdomain Enumeration: Uncovering More Subdomains than Subfinder & Amass](https://osintteam.com/passive-subdomain-enumeration-uncovering-more-subdomains-than-subfinder-amass/)
- [Around 1000 exploitable cybersecurity vulnerabilities that MITRE & NIST ‘might’ have missed but China or Russia didn’t.](https://blog.arpsyndicate.io/over-a-1000-vulnerabilities-that-mitre-nist-might-have-missed-but-china-or-russia-did-not-871b2364a526)
- [Utilizing GitHub Actions for gathering Subdomain & Exploit Intelligence](https://blog.arpsyndicate.io/utilizing-github-actions-for-gathering-subdomain-exploit-intelligence-bbc79c19bb85)
- [Introducing Exploit Observer — More than Shodan Exploits, Less than Vulners](https://blog.arpsyndicate.io/introducing-exploit-observer-more-than-shodan-exploits-less-than-vulners-23eaea466e4a)
- [PUNCIA — The Panthera(P.)uncia of Cybersecurity](https://blog.arpsyndicate.io/puncia-the-panthera-p-uncia-of-cybersecurity-ft-puncia-subdomain-center-exploit-observer-9a9d8cca9576)
- [Subdomain Enumeration Tool Face-off - 2023 Edition](https://blog.blacklanternsecurity.com/p/subdomain-enumeration-tool-face-off-4e5)