> 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.

# AI 搜到了一个链接，就算读过文章全文了吗？

> POST /v1/web/search 只返回候选链接与短摘要（news 类型无 snippet），不算读过全文；引用前必须把目标 URL 传给 POST /v1/web/read 并核对 results[].content。

不算。`POST /v1/web/search` 命中链接只代表找到了候选页面，不代表已经读过文章正文。搜索用于发现来源，不构成事实依据；引用具体日期、版本号或政策条款前，必须将选中的 URL 发给 `POST /v1/web/read` 并核对 `results[].content`。

## 采用「先搜后读」两步流程

1. **用 Search 筛选候选**：调用 `POST /v1/web/search`（`max_results` 为 `1–10`，默认 `5`）发现候选链接。仅在摘要中出现的信息一律标注为未核实；`type: "news"` 的结果不包含 `snippet` 字段，只带标题的新闻结果应先放入待读清单。
2. **用 Read 核实原文**：将选定链接提交给 `POST /v1/web/read`（`format` 可选默认 `markdown` 或 `text`，`max_chars` 范围 `500–100000`、默认 `20000`，可选 `query` 最长 400 字符用于按问题抽取相关段落）。

```bash
curl -sS https://api.beatapi.io/v1/web/read \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"urls":["https://example.com/article"],"format":"markdown","max_chars":8000}'
```

涉及 API 退役、政策变更、金融或医疗等高风险结论时，务必阅读原始页面正文后再下结论。

## 合同与相关问题

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

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