docs: document multi-url batch output and concurrency

Author: firede

README.md

@@ -23,6 +23,7 @@ If you use tools like Codex or Claude Code, note that they may already include b
 - `browser`: always uses headless browser
 - `raw`: send `Accept: text/markdown`, then print that single HTTP response body as-is (no fallback/conversion)
 - `--meta` (default `true`): control whether non-`raw` outputs include front matter (`title`/`description`). For `auto`/`static` direct markdown responses, it may do one extra HTML request to collect metadata.
+- One or more URL arguments are supported. For multiple URLs, requests run concurrently (configurable via `--concurrency`) and output is emitted in input order.
 
 ## Runtime dependency
 
@@ -79,7 +80,7 @@ It includes installation guidance and usage instructions for `agent-fetch`.
 ## Usage
 
 ```bash
-agent-fetch <url>
+agent-fetch <url> [url ...]
 ```
 
 Common flags:
@@ -89,10 +90,23 @@ agent-fetch --mode auto --timeout 20s --browser-timeout 30s https://example.com
 agent-fetch --mode browser --wait-selector 'article' https://example.com
 agent-fetch --mode static --meta=false https://example.com
 agent-fetch --mode raw https://example.com
+agent-fetch --mode static --concurrency 4 https://example.com https://example.org
 agent-fetch --header 'Authorization: Bearer <token>' https://example.com
 ```
 
-Fetched content is printed to `stdout` (`raw` mode prints the single HTTP response body unprocessed). Errors are printed to `stderr`.
+Fetched content is printed to `stdout` (`raw` mode prints the single HTTP response body unprocessed).  
+For multiple URLs, output uses task markers so each result maps back to its input URL:
+
+```text
+<!-- count: 3, succeeded: 2, failed: 1 -->
+<!-- task[1]: https://example.com/hello -->
+...markdown...
+<!-- /task[1] -->
+<!-- task[2](failed): https://abc.com -->
+<!-- error[2]: ... -->
+```
+
+Exit code is `0` when all tasks succeed, `1` when any task fails, and `2` for argument/usage errors.
 
 ## Build
 

README.zh.md

@@ -23,6 +23,7 @@
 - `browser`：始终使用无头浏览器
 - `raw`：带 `Accept: text/markdown` 发起一次 HTTP 请求，并将该响应体原样输出（不做回退/转换）
 - `--meta`（默认 `true`）：控制非 `raw` 输出是否附带 front matter（`title`/`description`）。对于 `auto`/`static` 的直返 markdown，可能会额外发起一次 HTML 请求用于补齐元信息。
+- 支持一个或多个 URL 参数。传入多个 URL 时会并发请求（可用 `--concurrency` 调整），并按输入顺序输出结果。
 
 ## 运行时依赖
 
@@ -79,7 +80,7 @@ Skill 位置：[`skills/agent-fetch`](./skills/agent-fetch/SKILL.md)。
 ## 使用方式
 
 ```bash
-agent-fetch <url>
+agent-fetch <url> [url ...]
 ```
 
 常用参数示例：
@@ -89,10 +90,23 @@ agent-fetch --mode auto --timeout 20s --browser-timeout 30s https://example.com
 agent-fetch --mode browser --wait-selector 'article' https://example.com
 agent-fetch --mode static --meta=false https://example.com
 agent-fetch --mode raw https://example.com
+agent-fetch --mode static --concurrency 4 https://example.com https://example.org
 agent-fetch --header 'Authorization: Bearer <token>' https://example.com
 ```
 
-抓取成功内容输出到 `stdout`（`raw` 模式为单次 HTTP 响应体原样输出）；错误信息输出到 `stderr`。
+抓取成功内容输出到 `stdout`（`raw` 模式为单次 HTTP 响应体原样输出）。  
+多个 URL 时，输出包含任务标记，便于与输入 URL 对齐：
+
+```text
+<!-- count: 3, succeeded: 2, failed: 1 -->
+<!-- task[1]: https://example.com/hello -->
+...markdown...
+<!-- /task[1] -->
+<!-- task[2](failed): https://abc.com -->
+<!-- error[2]: ... -->
+```
+
+退出码：全部成功为 `0`，部分或全部失败为 `1`，参数/用法错误为 `2`。
 
 ## 构建
 

skills/agent-fetch/SKILL.md

@@ -55,7 +55,8 @@ Browser runtime requirement:
 4. Use `static` mode when browser execution is not desired.
 5. Use `raw` mode when the exact HTTP response body is needed.
 6. Add repeated `--header` flags for auth/session requirements.
-7. Tune `--timeout`, `--browser-timeout`, `--network-idle`, and `--max-body-bytes` for slow or large pages.
+7. Tune `--timeout`, `--browser-timeout`, `--network-idle`, `--max-body-bytes`, and `--concurrency` for slow or large batches.
+8. For multiple URLs, rely on task markers in output to map each result back to its input URL.
 
 ## Command patterns
 
@@ -65,6 +66,12 @@ Default:
 agent-fetch https://example.com
 ```
 
+Multiple URLs with shared flags:
+
+```bash
+agent-fetch --mode static --concurrency 4 https://example.com https://example.org
+```
+
 Static-only:
 
 ```bash
@@ -92,5 +99,15 @@ agent-fetch --header "Authorization: Bearer <token>" https://example.com
 ## Output contract
 
 - Read fetched content from `stdout`.
-- Read errors from `stderr`.
-- Treat non-zero exit status as fetch failure.
+- For multiple URLs, parse output sections in this shape:
+
+```text
+<!-- count: N, succeeded: X, failed: Y -->
+<!-- task[1]: <input-url> -->
+...markdown...
+<!-- /task[1] -->
+<!-- task[2](failed): <input-url> -->
+<!-- error[2]: <error text> -->
+```
+
+- Treat exit code `0` as all successful, `1` as partial/complete task failure, and `2` as argument/usage error.