快速回答
网页搜索 API 的主要术语是什么意思？
网页搜索 API 让程序运行搜索并以数据形式返回结果。对 AI 智能体来说，有用之处在于 grounding：为模型提供最新的来源作为回答依据。LLMWebSearch 返回带排名的结果，其中排名靠前的页面已读取为 Markdown，自 2026 年 10 月起每次搜索按 US$1.20/千次搜索 收取一个积分，并遵守 robots.txt。下面 35 个术语解释其余内容。
搜索术语
- 网页搜索 API
一种接口，按请求运行网页搜索并以结构化数据（通常是 JSON）返回结果，而不是返回给人看的页面。
- SERP
搜索引擎结果页：搜索引擎针对某个查询展示的内容。SERP API 将该页面作为数据返回，而不读取它列出的页面。
- 带排名的结果
搜索返回的页面列表，按搜索引擎判定的相关度顺序排列。LLMWebSearch 保持该顺序，并用
position为每个结果编号。- 摘要
每个结果标题下方的简短摘录。适合用来判断该读什么，但太短，无法单独回答大多数问题。
- 查询
发送给搜索的词语。智能体通常会先把用户的问题改写成一个或多个更短的查询，然后再搜索。
- 搜索运算符
查询中的特殊标记，例如用于精确短语的引号，或用于限定在单一域名的
site:。q参数会按原样传递它们。- 实时搜索
在请求当下运行的搜索，与之相对的是在早先建立的索引中查找。结果来自你调用当下执行的实时网页搜索，按搜索引擎的排名顺序返回；不提供任何来自旧索引的内容。
- 新闻搜索
仅限新闻文章的搜索，通常带有日期。将
topic设为news，并添加time_range以只保留近期报道。- 域名筛选
将结果限制在某些站点或排除其他站点的规则。
include_domains和exclude_domains参数各最多接受 20 个域名。
页面读取术语
- 网页阅读器
服务中打开排名靠前的结果页面并提取其正文的部分。我们的读取器自称为
LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/)；页面读取器页面介绍了它。- User-Agent
客户端随每个网页请求发送的名称。声明真实名称的读取器能让网站所有者识别它并为其设定规则。
- robots.txt
网站根目录下的文本文件，告知机器人可以抓取哪些路径。标准为 RFC 9309。我们的读取器遵守 robots.txt：它会以 LLMWebSearch 表明身份，遵守网站为它或为所有机器人写下的规则，并排除任何它无权读取的页面内容。
- Content Signals
robots.txt 中说明内容可如何使用的行，例如
ai-input=no表示拒绝用作 AI 输入。在 robots.txt 中设置 Content-Signal: ai-input=no 的网站，其页面内容不会出现在你的结果中。- 正文提取
保留页面的文章或文档正文，去掉菜单、页脚、cookie 横幅和广告，让模型读到真正重要的内容。
- Markdown
一种轻量文本格式，其中
#标记标题，-标记列表项。模型能很好地读取它，而且同一页面比 HTML 消耗更少 token。- 无头浏览器
没有窗口、由代码驱动的浏览器。它让阅读器能读到那些只有在 JavaScript 运行后才会出现的页面文本。
- 付费墙
为付费订阅用户保留内容的一道关卡。阅读器从不登录，也从不绕过付费墙；这类页面会返回空内容。
- content_status
这个字段说明某条结果的页面是否被读取，以及如果没读取，原因是什么：
ok、not_requested、blocked_by_robots、target_refused以及文档中列出的其他值。
AI 术语
- LLM
大语言模型：一种在文本上训练、能生成文本的模型。它的知识止于某个训练日期，所以任何近期信息都需要靠搜索获取。
- Grounding
给模型提供来源，让它据此作答，然后要求它引用这些来源。带页面文本的搜索结果是在网页上做 grounding 最常用的方式。
- Tool calling
也叫函数调用。模型请求运行某个工具，例如
web_search，并自行选择参数；你的代码执行它并返回输出。- MCP
模型上下文协议：一种把工具暴露给 AI 客户端（如 Claude Desktop 或 Cursor）的开放标准。一个小型 MCP server 就能把搜索 API 包装成一个工具。
- AI agent
一种程序：由模型决定下一步、调用工具、读取工具结果，如此循环直到任务完成。网页搜索常常是它的第一个工具。
- RAG
检索增强生成：先取出相关文本，放进 prompt，再生成回答。用网页搜索 API 时，检索这一步就是实时网页。
- 深度研究
一种 agent 模式：规划大量查询、读取大量页面，并写出带引用的报告。针对一个问题，它可能执行几十次搜索。
- Context window
模型一次能接收的文本量，以 token 计。设置
max_chars可以限制每个页面有多少内容进入这个窗口。- Token
模型读取和计费的单位，大致相当于一个短词或词的一部分。干净的 Markdown 比原始 HTML 消耗更少的 token。
- Citation
把答案中的某句话链接到它的来源。返回来源而非写好的答案，能让你的模型精确引用它读到的内容。
- Hallucination
模型编造出来的、语气笃定的说法。基于新鲜来源做 grounding 并要求引用可以减少它，但无法消除它。
计费与账户条款
- 积分
每次调用所消耗的量。1 积分支付一次查询：最多 20 条排名结果，其中前 3 条的页面会被读取并以 Markdown 返回。读取 4 到 10 个页面为 2 积分。以错误结束的调用不收费。
- 积分包
一次预付的积分批量，低至 5,000 次搜索 至 1,000,000 次查询。查询积分永不过期：这个月没用完的，明年还在。
- 充值
一笔为你的余额充值的加密货币支付，至少 US$25。之后再用余额购买积分包。
- 速率限制
一个账户每分钟可发起的调用次数。每个账户都有每分钟调用上限，显示在控制面板中；联系支持即可提高。
- x402
一种协议，让客户端用稳定币为单次 HTTP 请求付款，无需账户。部分搜索 API 接受它；LLMWebSearch 则是从预付余额中扣费。
- KYC
了解你的客户：身份证件或自拍等身份核验。LLMWebSearch 不作任何要求；无 KYC 页面 说明了仍然适用的规则。