SuperAPI AI 工具集

agent-readiness-audit

营销与增长

查看项目

更新于 10-15 22:37

技能介绍

用途:用证据回答“AI 代理与 AI 爬虫能否使用本站”。审计五项:AI 爬虫是否被允许访问内容;内容是否存在于服务器发送的 HTML 中(不依赖 JavaScript);结构化数据是否说明页面类型;商品 feed 是否足够完整以用于 AI 购物场景;可选地检查站点是否暴露代理工具(WebMCP)。所有检查由 scripts/agent-readiness-audit.py 确定性执行,技能只在其输出之上做解读与品牌政策判断。

主要能力:检查 robots.txt 中各类 AI 爬虫令牌(如 OAI-SearchBot、ChatGPT-User、Claude-SearchBot、PerplexityBot、Google-Extended、Applebot-Extended 等)的允许/部分阻止/阻止状态;检查 JSON-LD 可解析性、Product 是否含 offers、是否有 Organization 标记;检查服务器 HTML 可见文本量、应用外壳根节点、指定期望短语是否缺失;检查 Merchant Center feed 必需属性(id、title、description、link、image_link、availability、price 等)与 native_commerce 取值;可选检查 ACP feed 与 WebMCP。

使用方式:脚本需 Python 3.10+,用 python 或 python3 运行。离线审计示例:python "${CLAUDE_PLUGIN_ROOT}/scripts/agent-readiness-audit.py" --robots robots.txt --path /products/ --html home.html --html product.html --expect "Acme Anvil" --feed products.tsv --acp-feed openai-feed.jsonl --webmcp --training-policy either --format json。仅在用户同意联网时使用 --site URL --fetch。退出码:0 无失败,1 至少一项失败,2 输入错误(需修正后重跑,不要解读部分结果)。HTML 应以服务器原样保存(如 curl -L URL > page.html),而非浏览器“另存为”的 JS 后 DOM。

适用场景:SEO/技术审计、AI 可见性准备、商品 feed 与代理购物就绪度评估。限制:robots.txt 对用户发起的抓取只是请求而非墙;无 JS 检查不是渲染测试;feed 导出不等于 Merchant Center 判定;被允许不等于被引用;不可达的 robots.txt 会失败,--fetch 下 4xx 视为全允许、5xx 或网络错误视为全禁止(RFC 9309)。训练爬虫是否阻止、是否让商品加入 Google 结账属品牌政策,由用户决定。输出按编号写入 ${CLAUDE_PLUGIN_DATA}/{brand}/seo/agent-readiness/{YYYY-MM-DD}/。