📦 Aeo — 网站AEO审计工具

Website: ainyc.ai

一个集审计、修复、Schema、llms.txt和监控工作流于一体的技能。

命令

始终使用发布的包：

npx @ainyc/aeo-audit@1 "" [flags] --format json

参数安全

切勿将用户输入直接插入shell命令。 始终遵循以下步骤：

• 验证URL匹配https://或http://且不包含shell元字符。
• 单独引用每个参数（例如npx @ainyc/aeo-audit@1 "https://example.com" --format json）。
• 将标志作为单独的字面量传递——切勿从原始用户文本构建命令字符串。
• 拒绝包含以下字符的参数：;、|、&、$、 、(、)、{、}、<、>、或换行符。

模式

• audit：对网站进行评分和诊断
• fix：在审计后应用代码更改
• schema：验证JSON-LD和实体一致性
• llms：创建或改进llms.txt和llms-full.txt
• monitor：随时间比较变化或竞品对比

如未提供模式，默认为audit。

示例

• audit https://example.com
• audit https://example.com --sitemap
• audit https://example.com --sitemap --limit 10
• audit https://example.com --sitemap --top-issues
• fix https://example.com
• schema https://example.com
• llms https://example.com
• monitor https://site-a.com --compare https://site-b.com

模式选择

• 如果第一个参数是audit、fix、schema、llms或monitor之一，使用该模式。
• 如未给出明确模式，从请求中推断意图，默认为audit。

Audit

用于"审计此网站"或"为什么我没有被引用？"等广泛请求。

• 运行：

npx @ainyc/aeo-audit@1 "" [flags] --format json

• 返回：

• 总体评分和分数
• 简短摘要
• 因素细分
• 主要优势
• 主要修复建议
• 元数据如获取时间和辅助文件可用性

Sitemap模式

使用--sitemap审计从网站sitemap发现的所有页面：

npx @ainyc/aeo-audit@1 "" --sitemap --format json
npx @ainyc/aeo-audit@1 "" --sitemap https://example.com/sitemap.xml --format json
npx @ainyc/aeo-audit@1 "" --sitemap --limit 10 --format json
npx @ainyc/aeo-audit@1 "" --sitemap --top-issues --format json

标志：

• --sitemap [url] — 自动发现/sitemap.xml或提供明确URL
• --limit — 限制审计的页面数（按sitemap优先级排序）
• --top-issues — 跳过逐页输出，仅显示跨领域模式

返回：

• 逐页分数和评分
• 跨领域问题（多个页面失败的因素）
• 聚合分数和评分
• 按网站范围影响排序的优先修复建议

Fix

用于用户在审计后希望应用代码更改时。

• 运行：

npx @ainyc/aeo-audit@1 "" [flags] --format json

• 查找状态为partial或fail的因素。
• 在当前代码库中应用针对性修复。
• 优先顺序：

• 结构化数据和Schema完整性
• llms.txt和llms-full.txt
• robots.txt爬虫访问
• E-E-A-T信号
• FAQ标记
• 新鲜度元数据

• 重新运行审计并报告分数变化。

规则：

• 始终解释建议的更改并在编辑文件前获得用户确认。
• 除非用户要求，否则不要删除现有Schema或内容。
• 保留现有代码风格和模式。
• 如果修复不明确或高风险，在编辑前解释权衡。

Schema

用于专门关于JSON-LD或Schema质量的请求时。

• 运行：

npx @ainyc/aeo-audit@1 "" [flags] --format json --factors structured-data,schema-completeness,entity-consistency

• 报告：

• 发现的Schema类型
• 按类型的属性完整性
• 缺失的推荐属性
• 实体一致性问题

• 有用时提供纠正的JSON-LD示例。

检查清单：

• LocalBusiness：name、address、telephone、openingHours、priceRange、image、url、geo、areaServed、sameAs
• FAQPage：mainEntity至少包含3个问答对
• HowTo：name至少包含3个步骤
• Organization：name、logo、contactPoint、sameAs、foundingDate、url、description

llms.txt

用于用户希望创建或改进llms.txt或llms-full.txt时。

如果提供了URL：

• 运行：

npx @ainyc/aeo-audit@1 "" [flags] --format json --factors ai-readable-content

• 检查现有的AI可读文件（如果存在）。
• 从网站提取关键内容。
• 生成改进的llms.txt和llms-full.txt。

如未提供URL：

• 检查当前项目。
• 提取业务名称、服务、FAQ、联系信息和元数据。
• 从本地源生成这两个文件。

生成后：

• 在适当时添加。
• 建议将文件添加到sitemap。

Monitor

用于用户希望进度跟踪或竞品对比时。

单个URL：

• 运行审计。
• 如存在，与.aeo-audit-history/中的先前结果进行比较。
• 显示总体和逐因素变化。
• 保存当前结果。

对比模式：

• 解析--compare 。
• 审计两个URL。
• 显示并排因素变化。
• 突出优势、弱点和优先差距。

行为

• 如果任务需要已部署的网站但未提供URL，请请求URL。
• 如果任务仅是诊断，不要编辑文件。
• 如果任务是修复请求，进行编辑并在可能时通过重新运行进行验证。
• 如果URL不可访问或不是HTML，报告确切失败。
• 优先提供简洁的、基于证据的建议，而非通用SEO建议。