返回更新列表
新发布Aug 6, 2026

puncia v0.35

Panthera(P.)uncia - 子域中心与漏洞利用观察者的官方 CLI 实用工具。

分享

Panthera(P.)uncia

Subdomain Center 与 Exploit Observer 的官方 CLI 工具

Downloads GitHub stars

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

  • 🕸️ Subdomain Center — 在互联网规模上提供子域名枚举、子域名接管发现、影子 IT 发现以及品牌仿冒 / 仿冒域名(typosquat)检测。
  • 💥 Exploit Observer — 覆盖 150 多种标识符体系(CVE、GHSA、EDB、MSF、ZDI、国家级威胁情报源等)的漏洞利用与漏洞情报,每次查询均附带 EPSS + VEDAS 成熟度评分,并支持 SBOM 扫描。
$ 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 .

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] [--filter KEY=VALUE] [--format json|csv]
                               [--api-key K] [--concurrency N]
                               [--timeout S] [--retries N] [--quiet]

运行 puncia --help 查看完整参考。结果输出到 stdout; banner、进度条、警告和错误都输出到 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 可改为自行获取恰好一个原始页, 例如用于可恢复或流式遍历:
      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 会通过一次实时发现过程补充已存储的 结果。给定域名实际上大约每 6 小时才会被重新爬取一次——该时间窗口内的 请求会立即获得缓存的爬取结果。Puncia 会在 stderr 上报告结果: crawl: fresh, 12 newly discovered name(s)(还有 partial / running / cooldown / disabled)。在 partial/running 时,部分爬取 仍在服务端进行;请在一分钟后用 --crawl 重新运行以获取其余结果。
      puncia subdomain bigco.com --crawl
      
  3. (免费增值)查询仿冒域名,按品牌聚类(replica / octopus 引擎)- puncia replica <domain> --match <prefix|exact|substring> <output-file>

  4. (免费增值)按关键词查询,按关键词聚类(keyword / ammonites 引擎)- puncia keyword <keyword> --match <exact|prefix> <output-file>

    • 可选地使用 --domain 将关键词限定到单个域名: puncia keyword blog --domain bandcamp.com
  5. 查询漏洞利用与漏洞标识符(exploit)

    • (免费)监视列表(^WATCHLIST_IDES)——最新爬取中趋势 CVE,以及其中首次变为可利用的 CVE;每次爬取都会重建 - 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>
    • (免费增值)支持的漏洞标识符 - puncia exploit <eoidentifier> --match <substring|prefix|exact> <output-file>
    • Metasploit 模块会以对应的 Rapid7 模块页面返回(ruby 桶)。 一个 CVE id 若有公开 PoC 但尚无已发布的 CVE 记录(即 PoC 作者 先发布的保留 id),返回时描述会以 ** UNPUBLISHED ** 开头,概述相关证据。
  6. (付费)按 VEDAS 组查询非 CVE 标识符(noncve)- puncia noncve <browser/china/russia/europe/exploitable> <output-file>

  7. (付费)Nuclei 模板候选(nuclei)- puncia nuclei candidates <output-file>

    • 拥有 VEDAS id 且尚无 nuclei 模板但看起来 可模板化的 CVE,按优先级从高到低排列(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),列表字段用 ; 连接(reasons 用 | 连接),并且会被电子表格视为公式的单元格会被置为无效。
      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>
{
    "subdomain": [
        "domainA.com",
        "domainB.com"
    ],
    "replica": [
        "domainA.com",
        "domainB.com"
    ],
    "keyword": [
        "keywordA",
        "keywordB"
    ],
    "exploit": [
        "eoidentifierA",
        "eoidentifierB"
    ]
}

批量运行和 SBOM 运行会对查询去重,将并行度限制在 --concurrency (默认 10),并且——当没有 API 密钥时——自动调整请求节奏以保持在 免费额度预算之内。每个结果都会写入 <output-directory>/<mode>/<query>.json;如果某个查询无法直接用作 文件名(包含路径分隔符、控制字符、Windows 设备名、 超过 200 个字符,或是另一个查询的大小写变体),则会被清理并附加 一个简短的 ~<hash> 后缀,以确保两个查询绝不会共用同一个文件。如果一次运行 完全没有找到有效查询,则退出码为 1;如果存在失败的查询,则在写入所有其他结果 并在 stderr 上列出失败项后,同样以退出码 1 结束。

  1. (FREEMIUM)外部导入
import asyncio
import puncia

分类