> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 怎么列出一个网站的 URL？Map 能找全站所有页面吗？

> POST /v1/web/map 从公开起始页出发，按 1–3 层链接深度最多返回 100 条去重 URL，不保证覆盖全站所有页面。

调用 `POST /v1/web/map` 并传入站点公开页面作为起点，即可发现该站点的站内 URL 列表。Map 不保证找全网站的全部页面：单次请求最多返回 100 条去重 URL，且只沿链接追踪 1–3 层（`max_depth` 默认 `1`）。

## 用深度与路径正则控制范围

优先从目录型页面（如帮助中心索引页）启动，并用过滤参数聚焦目标栏目，避免为无关路径付展开费用：

* **`limit`**：`1–100`（默认 `50`）。按每条返回 URL `$0.001` 计费；未发现任何链接时不扣费，并在 `note` 中提示可能原因（如外链页或由 JavaScript 动态生成的链接）。
* **`max_depth`**：从起始 `url` 向外追踪 `1–3` 层链接（默认 `1`）。
* **`select_paths` 与 `exclude_paths`**：各支持最多 10 条路径正则（单条不超过 200 字符；无法编译的正则返回 `400 bad_request`）。`include_external` 默认 `false`。

```bash
curl -sS https://api.beatapi.io/v1/web/map \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/help","select_paths":["/help/.*"],"max_depth":2,"limit":50}'
```

## 核对覆盖度并读取目标正文

在内容清单中同步记录起始 `url`、`max_depth` 与路径过滤条件，按主题分组后把重点页面交给 `POST /v1/web/read` 核对正文。若怀疑漏页，将 Map 结果与网站公开的 `sitemap.xml` 或官方目录对照补漏。

## 合同与相关问题

执行前免费检查对应合同：`data:web.search`, `data:web.read`, `data:web.map`。

[返回Web Search问题索引](/zh/faq/web)。