什么是面向 AI 智能体的网页搜索 API？

一次调用过程中会发生什么？

按顺序有五件事，不过供应商会隐藏其中一些：

1. 查询处理。 服务会清理查询并应用你的筛选条件：国家、语言、时间范围、包含或排除的域名。
2. 搜索。 它会用自己的索引或实时搜索引擎执行查询，得到一份排序后的 URL 列表。
3. 读取。 对排名靠前的结果，它会抓取每个页面，并检查站点是否允许。
4. 清洗。 它会去掉导航、广告和脚本，保留正文，通常为 Markdown。
5. 打包。 它把所有内容以 JSON 返回，可直接放进 prompt。

使用 LLMWebSearch 时，第 3 步默认覆盖前 3 条结果，使用 read 时最多可覆盖 10 条。

它和 SERP API 有什么不同？

SERP API 返回搜索结果页；面向 Agent 的网页搜索 API 返回结果背后的来源。SERP API 复刻的是人在搜索引擎上看到的内容：广告、地图、"People also ask" 框、购物卡片和十条蓝色链接。这适合 SEO 工具和排名跟踪。

Agent 需要的版面少、正文多。它想要的是一份干净的来源列表以及这些页面上的文字。用 SERP API 时，Agent 必须再调用另一个服务来读取每个链接。面向 Agent 的网页搜索 API 在一次调用中同时完成两件事。

它和网页读取 API 有什么不同？

读取器从 URL 出发；搜索 API 从问题出发。读取器（或抓取工具）接收一个你已经有的链接并返回其内容。它无法告诉你该读哪些页面。

Agent 往往两者都需要。它们先搜索找到候选页面，再读取最好的那些。一个同时具备读取能力的搜索 API 能为排名靠前的结果省掉第二步。当 Agent 已经有 URL（例如来自用户消息）时，一次读取调用就够了。LLMWebSearch 通过 extract 端点 提供该功能。

它和模型内置的搜索工具有什么不同？

内置工具在模型供应商一侧执行搜索，通常返回带引用的答案，而不是页面本身。OpenAI、Anthropic、Google 和 Microsoft 都各有一款。截至 2026 年 10 月 22 日，OpenAI 和 Anthropic 每 1,000 次搜索收费 $10，另加按 token 计的搜索内容费用。Gemini 3 grounding 在付费档每月 5,000 次免费搜索之后，每 1,000 次收费 $14。Grounding with Bing 每 1,000 次收费 $14。

Microsoft 声明 Grounding with Bing 的结果"无法直接访问以用于其他应用"。独立 API 返回原始来源，你可以存储、筛选并展示。它也能配合任何模型使用。内置工具对比 有详细说明。

结果来自哪里？

要么来自供应商自己的索引，要么来自调用时查询的实时搜索引擎。Brave 称每条结果都来自其自有独立索引。Perplexity 描述其索引包含"数千亿个网页"。Exa 的文档称其 lite 模式只提供缓存内容，从不实时抓取。

自有索引回答快，但由它们决定抓取什么以及抓取频率。实时搜索反映搜索引擎在那一刻显示的内容。LLMWebSearch 采用实时方式：结果来自你调用当下执行的实时网页搜索，按搜索引擎的排名顺序返回；不提供任何来自旧索引的内容。

网页搜索 API 如何收费？

2026 年常见四种模式，且经常混用：

• 按次搜索。 每次调用固定价格，例如截至 2026 年 10 月 22 日所见，Brave、Perplexity、Linkup 或 You.com 为每 1,000 次 $5。
• 按积分。 套餐出售积分，高级搜索会消耗更多积分。Tavily 的基础搜索为 1 积分，高级搜索为 2 积分。
• 按结果或按页面。 Valyu 按返回的结果收费；Firecrawl 每读取一个页面加收 1 积分。
• 按 token。 Jina 的搜索每次请求至少按 10,000 个 token 计费。

要同类对比：包含完整页面正文的价格与只含摘要的价格不是同一种产品。带日期的价格对比 对它们做了归一化处理。

选择之前该检查什么？

用你的二十条真实查询分别跑一遍每个候选产品，然后看七件事：

• 内容。 完整页面、针对查询的摘录，还是只有摘要？
• 新鲜度。 能否按时间范围筛选？结果是否带日期？
• 控制力。 能否限制结果数、页面数和每页字符数？
• 每次有效搜索的价格。 把你原本要单独付费的读取也算进去。
• 账单条款。 积分每月重置还是可以结转？是否需要信用卡或工作邮箱？
• 数据权利。 你是否可以存储结果？供应商是否用你的查询训练模型？
• 站点礼仪。 读取器是否遵守 robots.txt？

对于 LLMWebSearch：查询积分永不过期：这个月没用完的，明年还在。我们不会用你的查询或 API 返回的内容训练任何模型，也不会自行添加任何禁止存储结果的规则；你读取的页面所属网站的权利仍然适用。