Puncia 是两个 A.R.P. Syndicate 情报 API 的官方命令行客户端——只需向它提供一个域名、一个品牌或一个漏洞 ID,即可在数秒内获得结构化 JSON 结果,无需浏览器:
$ 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
pip3 install punciapip3 install .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 用法错误。
(付费)存储 API 密钥(storekey)- puncia storekey <api-key>
~/.puncia,权限为 0600。$PUNCIA_API_KEY 会覆盖它,
这通常正是你在 CI 中想要的方式。(免费增值)查询域名,按域名聚类(子域名 / 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
(免费增值)查询仿冒域名,按品牌聚类(replica / octopus 引擎)- puncia replica <domain> --match <prefix|exact|substring> <output-file>
(免费增值)按关键词查询,按关键词聚类(keyword / ammonites 引擎)- puncia keyword <keyword> --match <exact|prefix> <output-file>
--domain 将关键词限定到单个域名:
puncia keyword blog --domain bandcamp.com查询漏洞利用与漏洞标识符(exploit)
puncia exploit ^WATCHLIST_IDES <output-file>puncia exploit ^WATCHLIST_INFO <output-file>puncia exploit ^WATCHLIST_TECH <output-file>puncia exploit ^STATS <output-file>puncia exploit ^HEALTH <output-file>puncia exploit <eoidentifier> --match <substring|prefix|exact> <output-file>ruby 桶)。
一个 CVE id 若有公开 PoC 但尚无已发布的 CVE 记录(即 PoC 作者
先发布的保留 id),返回时描述会以
** UNPUBLISHED ** 开头,概述相关证据。(付费)按 VEDAS 组查询非 CVE 标识符(noncve)- puncia noncve <browser/china/russia/europe/exploitable> <output-file>
(付费)Nuclei 模板候选(nuclei)- puncia nuclei candidates <output-file>
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。--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
(免费)Subdomain Center 服务健康检查(^HEALTH) - puncia subdomain ^HEALTH <output-file>
多查询(bulk/sbom)
puncia bulk <json-file> <output-directory>{
"subdomain": [
"domainA.com",
"domainB.com"
],
"replica": [
"domainA.com",
"domainB.com"
],
"keyword": [
"keywordA",
"keywordB"
],
"exploit": [
"eoidentifierA",
"eoidentifierB"
]
}
puncia sbom <json-file> <output-directory>批量运行和 SBOM 运行会对查询去重,将并行度限制在 --concurrency
(默认 10),并且——当没有 API 密钥时——自动调整请求节奏以保持在
免费额度预算之内。每个结果都会写入
<output-directory>/<mode>/<query>.json;如果某个查询无法直接用作
文件名(包含路径分隔符、控制字符、Windows 设备名、
超过 200 个字符,或是另一个查询的大小写变体),则会被清理并附加
一个简短的 ~<hash> 后缀,以确保两个查询绝不会共用同一个文件。如果一次运行
完全没有找到有效查询,则退出码为 1;如果存在失败的查询,则在写入所有其他结果
并在 stderr 上列出失败项后,同样以退出码 1 结束。
import asyncio
import puncia