开发者
只读 Agent 端点
内测。让 Agent 读取你已确认的品牌事实和商品,除此之外什么都不能做。
项目所有者在技术 SEO → 站点文件 → 给 Agent里创建令牌来开启这个端点。令牌只显示一次,库里只存哈希;180 天后失效,再创建一个会替换它,关闭会吊销它。内测开放前,整个平台都是关闭的。
POST /api/agent/<projectId>/mcp 使用 JSON-RPC 2.0,带 Authorization: Bearer <token>。它响应 initialize、tools/list,以及对两个工具的 tools/call:
| 工具 | 返回 |
|---|---|
get_brand_facts | 已确认的品牌事实,已规范化。 |
get_products | 目录里的商品,每页 50 条并带 nextCursor;描述截到 500 字符;每次响应最大 100 KB。 |
它从不返回抓取到的页面,不能修改任何东西,也没有购物车和订单。限制:每令牌每分钟 30 次,每组织每天 1,000 次,每项目每月 1,000 次(超出返回 429)。我们保存每次调用的时间、工具名、大小和响应的哈希,不保存响应本身。
给 Agent 用的声明文件(/.well-known/api-catalog、/.well-known/ai-catalog.json、/.well-known/ard.json)根据你说明的网站服务生成,与其他站点文件一起保存,并用同样的方式核对。只为你真正运行的服务生成;没有 API 或 MCP 服务器的网站不需要这些文件。产品不声称对 Agent 友好会改变 AI 回答引用你的频率。