SuperAPI AI 工具集

nuxt-agent-ready-best-practices

前端与建站

查看项目

更新于 10-16 03:36

技能介绍

用途:让 Nuxt 4 站点可被自主 AI 智能体操作,而非仅被引用,对应 isitagentready.com(Cloudflare“Is Your Site Agent-Ready?”)扫描标准。与 GEO(被 AI 答案引用)不同,本技能关注智能体能否认证、发现 API、调用工具并执行操作。

主要能力:支持 Accept: text/markdown 内容协商、RFC 8288 Link 头、RFC 9727 API 目录(/.well-known/api-catalog)、Agent Skills 发现索引(/.well-known/agent-skills/index.json)、WebMCP(navigator.modelContext)、MCP Server Card、OAuth/OIDC 发现与 DNS-AID(_index._agents.<domain>)加 DNSSEC。规则分 discovery、content、auth、dns、security 等类别。

使用方式:先通过 nuxt-geo-best-practices 完成 robots.txt AI 爬虫白名单、llms.txt/llms-full.txt、XML sitemap,再叠加本技能的智能体操作层。在 wrangler dev 构建启动并 curl 验证各路由与头,部署到生产后必须复验(自引用 $fetch 缺陷仅在生产出现,务必用相对的 event.$fetch,不要用绝对 URL)。可用 POST https://isitagentready.com/api/scan {"url":"https://<domain>"} 复查。

限制与诚实规则:只发布真实存在的服务发现;虚构 OAuth/MCP 端点比低分更糟。营销站通常止步 Level 4,只有运行真实授权服务器与真实远程 MCP 服务器的站点才应发布 auth 与 MCP 表面并达到 Level 5。发布前需做安全加固:页面内嵌 API key 必须限定来源且由非特权账号持有、错误不得回显密钥、htmlToMarkdown 不得解码实体、Link 头在 /api/** 跳过。WebMCP 检查运行于无 GPU 无头浏览器且有 8 秒超时,重客户端 JS 会导致超时,可在 navigator.webdriver === true 时降级为静态页面。非电商站点的 x402、MPP、UCP、ACP 等商业检查仅供参考、不计分。