Panthera(P.)uncia

Subdomain Center 与 Exploit Observer 的官方 CLI 工具

GitHub stars

Puncia 是两个 A.R.P. Syndicate 情报 API 的官方命令行客户端——只需指向一个域名、一个品牌或一个漏洞 ID，即可在几秒内获得结构化 JSON 数据，无需浏览器：

🕸️ Subdomain Center — 互联网规模的子域名枚举、子域名接管发现、影子 IT 发现以及品牌仿冒 / 仿冒域名（域名抢注）检测。
💥 Exploit Observer — 覆盖 150 多种标识符体系（CVE、GHSA、EDB、MSF、ZDI、国家级行为体情报源等）的漏洞利用与漏洞情报，支持 CVE/GHSA 富化（EPSS + VEDAS 成熟度评分）以及 SBOM 扫描。

$ puncia subdomain arpsyndicate.io
╭──────────────────────────────────────────────────────────────────────╮
│ Panthera(P.)uncia v0.38                                              │
│ 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

实际应用

品牌仿冒与钓鱼域名检测
在仿冒、相似和域名抢注域名被用于攻击您或您的客户之前，发现它们。
影子 IT 与外部攻击面发现
识别并监控在官方渠道之外暴露的子域名和基础设施。
子域名接管侦察
枚举目标的完整子域名足迹，这是发现悬空/易被接管记录的关键第一步。
高级漏洞研究与监控
发现并跟踪已知和新兴威胁，包括冷门或未列出的漏洞。
CVE/GHSA 数据的上下文富化
为已知漏洞添加深度和可操作情报（EPSS + VEDAS 成熟度评分），以便更好地确定优先级。
软件物料清单（SBOM）中的漏洞检测
使用结构化 SBOM 数据分析软件组件中的已知漏洞利用和安全问题。
与 CI/CD 及威胁情报工作流无缝集成
在开发或安全流水线中自动化情报收集和漏洞检查。
监控国家级漏洞利用趋势
通过跟踪被外国行为体标记但尚未被主流数据库识别的漏洞，保持领先于威胁。
基于关键字的子域名发现
在互联网上发现包含给定关键字的主机，独立于特定的父域名。
批量威胁情报处理
运行批量查询（域名、漏洞等），以便在大型数据集或企业资产清单中进行可扩展分析。
红队被动侦察
使用被动数据源（不与目标直接交互）进行隐蔽侦察。
开源情报（OSINT）收集
结合子域名和漏洞利用情报，增强 OSINT 调查。
合规与风险管理支持
丰富漏洞数据，以更深入的上下文支持合规审计（例如 ISO 27001、SOC 2）。

安装

从 PyPi 安装 - pip3 install puncia
从源码安装 - pip3 install .

30 秒快速上手

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] [--api-key K] [--concurrency N]
                               [--timeout S] [--retries N] [--quiet]

运行 puncia --help 查看完整参考。结果输出到 stdout；横幅、进度条、警告和错误都输出到 stderr，因此 puncia subdomain example.com > out.json 始终会生成干净、有效的 JSON。

退出码： 0 成功 · 1 请求或输入错误 · 2 用法错误。

（付费）存储 API 密钥（storekey）- puncia storekey <api-key>
- 存储在 ~/.puncia，权限为 0600。$PUNCIA_API_KEY 会覆盖它，这在 CI 中通常正是您想要的。
（免费增值）查询域名，按域名聚类（subdomain / cuttlefish 引擎）- puncia subdomain <domain> <output-file>
- 分页（仅限已认证）： 已认证的结果没有总数上限。默认情况下，subdomain/replica/keyword 会遍历每一页并为您合并它们。传入 --offset（可带或不带 --limit）可自行获取恰好一个原始页面，例如用于可恢复或流式遍历：
```
puncia subdomain bigco.com --limit 50000 --offset 0
# stderr prints: note: more results available — continue with --offset 50000
puncia subdomain bigco.com --limit 50000 --offset 50000
```
  匿名请求在服务端会忽略 /（始终是最多 500 行的打乱样本）；puncia 会发出警告，而不是假装它们起了作用。

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("enrich", "CVE-2021-3450", apikey=api_key))
   print(await puncia.query_api("noncve", "exploitable", apikey=api_key))

   # 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；空结果（{} / []）会原样返回，而不会被当作错误处理。通过传入 session= 和共享的 limiter=，可以在多个查询之间复用同一个会话，正如 process_bulk() 所做的那样。

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}")

开发

git clone https://github.com/ARPSyndicate/puncia && cd puncia
pip install --upgrade pip     # editable installs need pip >= 21.3
pip install -e ".[dev]"
pytest                        # 42 offline tests, no API calls or network access

测试套件完全离线——它覆盖 URL 构造、输出路径包含、SBOM 解析、批量规划和速率限制器计时，而不触及网络，因此可以在任何环境中安全运行。

puncia

最受欢迎

Panthera(P.)uncia

Subdomain Center 与 Exploit Observer 的官方 CLI 工具

实际应用

安装

30 秒快速上手

用法

开发

CVE 富化

GHSA 富化

值得注意的提及