让浏览器智能体搜索文档

WebMCP 是一个实验性的浏览器 API，允许页面向浏览器中运行的智能体提供工具。Nimbus 注册了一个工具 search_documentation，用于搜索站点的搜索索引。新站点已自带它。

新站点得到什么

在智能体调用该工具之前不会加载任何内容，不支持该 API 的浏览器会跳过它。结果遵循与站点搜索相同的规则：草稿和隐藏版本会被排除，noindex 页面也会被排除，除非它们设置了 searchable: true。

输入

结果： 一组匹配项，每项包含 title、heading、带锚点的 url，以及不超过 1,000 个字符的纯文本 excerpt。

错误

添加到较早的站点

前置条件

• 站点搜索使用默认提供者（search 未设为 false，也未使用自定义提供者）
• Pagefind 1.5.2 或更高版本

步骤

1. 复制组件

   从脚手架复制 src/components/WebMCP.astro 到项目的 src/components/。

2. 在 head 中渲染它

   在 src/layouts/BaseLayout.astro 中导入该组件，并在 <head> 中渲染：

   ---
   import WebMCP from "@/components/WebMCP.astro";
   ---
   <head>
     <!-- … -->
     <WebMCP />
   </head>

3. 构建站点

   npm run build

验证

打开任一已构建页面的 HTML，在 <head> 中查找该工具的设置：

<meta name="nimbus-webmcp" content="{&quot;search&quot;:&quot;pagefind&quot;,…}">

如果该标签缺失，说明站点的搜索没有使用默认提供者。该工具需要生产构建：在 astro dev 中它会返回 index_unavailable。

后续步骤

• 远程 MCP 服务器：让浏览器之外的智能体读取文档。
• 智能体发现：智能体用来找到站点的文件。