--- description: 对整个项目进行全面 SEO 审计 argument-hint: [directory] --- 执行完整的 SEO 审计，扫描所有页面和组件，生成详细报告和 SEO 评分（0-100 分）。 ## 功能 全面的 SEO 审计包括： - ✅ 元数据优化分析 - ✅ 结构化数据检查 - ✅ 内容质量评估 - ✅ E-E-A-T 权威性审计 ⭐ - ✅ 内容策略分析 ⭐ - ✅ 技术 SEO 检查 - ✅ 100 分制评分系统（6 个维度） - ✅ 优先级修复建议 ## 参数 - `$1` 或 `$ARGUMENTS`: 可选的项目目录路径 - 如果不提供，检查当前工作目录 - 应该是 Next.js 项目的根目录 - 支持相对路径和绝对路径 ## 使用示例 ### 示例 1：审计当前目录 ```bash /seo-audit ``` 输出： ``` 🔍 开始全面 SEO 审计... ✓ 检测到项目类型：Next.js App Router ✓ 扫描目录：app/ ✓ 发现页面：15 个 ✓ 发现组件：23 个 ✓ 分析配置文件 ✓ 检测语言：中文（75%） 📊 正在计算 SEO 评分... ═════════════════════════════════════════════════════ SEO 审计报告 ═════════════════════════════════════════════════════ 📈 总体评分：78/100 ⭐⭐⭐⭐ 评级：良好 - 你的网站 SEO 基础较好，但仍有改进空间 ═════════════════════════════════════════════════════ 📋 详细得分： 1️⃣ 元数据完整性：18/20 ✅ ├─ Title: 7/8 │ ├─ ✓ 所有页面都有 Title │ ├─ ⚠️ 3 个页面标题过长 │ └─ ⚠️ 2 个页面缺少目标关键词 ├─ Description: 8/8 ✅ └─ OG & Twitter: 3/4 └─ ⚠️ 缺少 Twitter Cards 2️⃣ 结构化数据：12/15 ⚠️ ├─ JSON-LD 存在: 7/7 ✅ ├─ 必需字段: 3/4 │ └─ ⚠️ 部分页面缺少 datePublished └─ 验证通过: 2/4 └─ ❌ 有警告需要修复 3️⃣ 内容质量：20/25 ⚠️ ├─ 标题结构: 5/6 │ └─ ⚠️ 1 个页面有多个 H1 ├─ 内容长度: 5/6 ✅ ├─ 关键词使用: 3/4 ├─ 链接质量: 4/4 ✅ ├─ 多媒体: 1/3 │ └─ ❌ 缺少视频和图表 └─ Featured Snippets: 2/2 ✅ 4️⃣ E-E-A-T 权威性：14/20 ⚠️ ├─ 专业度展示: 4/7 │ ├─ ❌ 缺少具体案例研究 (1/3) │ ├─ ✓ 技术准确性良好 (2/2) │ └─ ⚠️ 作者信息不完整 (1/2) ├─ 权威性建立: 5/7 │ ├─ ⚠️ 外部引用不足 (2/3) │ ├─ ✓ 内容独特 (2/2) │ └─ ⚠️ 支柱页面需要完善 (1/2) └─ 信任度建设: 5/6 ✅ ├─ ✓ 更新频率良好 ├─ ✓ 数据来源透明 └─ ⚠️ 缺少关于页面 (1/2) 5️⃣ 内容策略：6/10 ⚠️ ├─ 集群结构: 2/4 │ └─ ❌ 内部链接不足 ├─ 内容日历: 2/3 ✅ └─ 关键词蚕食: 2/3 ✅ 6️⃣ 技术 SEO：8/10 ✅ ├─ robots.txt: 3/3 ✅ ├─ 图片优化: 2/3 │ └─ ⚠️ 部分图片缺少 alt ├─ URL 结构: 2/2 ✅ └─ 移动友好: 1/2 └─ ⚠️ 响应式问题 ═════════════════════════════════════════════════════ 🎯 优先修复建议（按影响排序） 🔴 高优先级（+3 分以上） 1. [E-E-A-T] 添加案例研究和实际经验展示 (+2 分) → 在博客文章中添加真实案例 → 分享实践经验教训 2. [E-E-A-T] 完善作者信息和关于页面 (+2 分) → 创建详细的作者简介页面 → 添加关于页面 3. [内容策略] 优化集群内容的内部链接结构 (+2 分) → 确保所有相关内容互相链接 🟡 中优先级（+1-2 分） 4. [内容质量] 添加图表和视频内容 (+2 分) 5. [元数据] 添加 Twitter Cards 标签 (+1 分) 6. [结构化数据] 修复 JSON-LD 验证警告 (+2 分) 🟢 低优先级（+1 分以下） 7. [技术 SEO] 为图片添加 alt 文本 (+1 分) 8. [技术 SEO] 修复移动端响应式问题 (+1 分) ═════════════════════════════════════════════════════ 📈 改进路线图 第 1 周：权威性建设 [ ] 添加 3 个案例研究 [ ] 创建作者简介页面 [ ] 添加关于页面 第 2 周：内容优化 [ ] 优化内部链接结构 [ ] 添加图表和视频 第 3 周：技术完善 [ ] 添加 Twitter Cards [ ] 修复结构化数据 预期提升：78 分 → 90+ 分 ═════════════════════════════════════════════════════ 💡 下一步建议 需要我为任何建议提供详细的实施指导吗？ 使用以下命令获取更多帮助： /ee-audit --detailed # 详细 E-E-A-T 分析 /content-strategy # 内容策略建议 /pillar-pages --analyze # 支柱页面分析 ``` ### 示例 2：审计指定目录 ```bash /seo-audit ./my-app ``` 输出： ``` 🔍 开始全面 SEO 审计... ✓ 检测到项目类型：Next.js Pages Router ✓ 扫描目录：./my-app/pages/ ✓ 发现页面：22 个 ✓ 发现组件：31 个 ✓ 检测语言：英文 📊 正在计算 SEO 评分... [完整的审计报告...] ``` ### 示例 3：中文项目审计 ```bash /seo-audit ``` 输出： ``` 🔍 开始全面 SEO 审计... ✓ 检测项目类型：Next.js App Router ✓ 扫描目录：app/ ✓ 发现页面：18 个 ✓ 检测语言：中文（82%） 📊 正在计算 SEO 评分... ═════════════════════════════════════════════════════ SEO 审计报告 ═════════════════════════════════════════════════════ 📈 总体评分：82/100 ⭐⭐⭐⭐ 语言：中文项目 搜索引擎：百度、搜狗、Google [中文特定的分析和建议...] ``` ## 审计流程 ### 1. 项目检测 ``` 检测项目类型： - App Router（app/ 目录） - Pages Router（pages/ 目录） - 语言（中文/英文） - 项目规模 ``` ### 2. 全面扫描 ``` 扫描文件类型： - 页面文件（page.tsx, page.js） - 组件文件 - 配置文件（next.config.js, robots.txt） - 静态资源 ``` ### 3. 六维评分 ``` 计算 6 个维度的得分： 1. 元数据完整性（20 分） 2. 结构化数据（15 分） 3. 内容质量（25 分） 4. E-E-A-T 权威性（20 分） 5. 内容策略（10 分） 6. 技术 SEO（10 分） ``` ### 4. 报告生成 ``` 生成完整的审计报告： - 总体评分 - 详细得分分析 - 优先级建议 - 改进路线图 ``` ## 输出文件 可选地将审计报告保存为文件： ```bash /seo-audit --output report.md ``` 生成文件： - `seo-audit-report.md` - Markdown 格式报告 - `seo-audit-report.json` - JSON 格式数据 ## 详细模式 使用 `--detailed` 标志获取更详细的分析： ```bash /seo-audit --detailed ``` 包含额外信息： - 每个页面的详细得分 - 逐个文件的问题列表 - 竞争对手对比（如果提供） - 技术性能指标 ## 比较模式 比较两次审计的结果： ```bash # 首次审计 /seo-audit --save baseline # 后续审计 /seo-audit --compare baseline ``` 输出改进对比： ``` 📊 SEO 评分对比 上次评分：65/100 当前评分：78/100 提升：+13 分 ⬆️ 改进项目： ✓ 元数据完整性：12/20 → 18/20 (+6) ✓ 内容质量：15/25 → 20/25 (+5) ⚠️ E-E-A-T 权威性：12/20 → 14/20 (+2) ``` ## 集成工具 审计过程会使用： - Glob - 文件搜索 - Grep - 模式匹配 - Read - 内容分析 - Bash - 配置验证 ## 性能考虑 - 并行处理多个文件 - 智能缓存机制 - 增量扫描支持 - 快速跳过已检查文件 ## 评分等级 ``` ⭐⭐⭐⭐⭐ 90-100 优秀 ⭐⭐⭐⭐ 75-89 良好 ⭐⭐⭐ 60-74 一般 ⭐⭐ 40-59 需要改进 ⭐ 0-39 急需改进 ``` ## 后续操作 基于审计结果，推荐使用： ```markdown 📊 深度分析 /ee-audit --detailed # E-E-A-T 详细审计 /content-strategy --deep # 内容策略分析 /pillar-pages --analyze # 支柱页面分析 /topic-clusters --analyze # 集群内容分析 🔧 立即修复 /metadata [文件路径] # 优化元数据 /structured-data [文件路径] # 添加结构化数据 /author-bio [作者名] # 生成作者简介 📈 长期改进 Agent: seo-analyzer # 深度 SEO 分析 Agent: content-optimizer # 内容优化专家 ``` ## 注意事项 - 完整审计可能需要较长时间（大型项目） - 审计结果基于当前项目状态 - 建议定期审计（每月一次） - 评分基于 SEO 最佳实践 - 不同行业可能有特殊要求 ## 相关命令 - `/seo-check` - 快速 SEO 检查 - `/ee-audit` - E-E-A-T 详细审计 - `/content-strategy` - 内容策略分析 - `/pillar-pages` - 支柱页面分析 - `Agent: seo-analyzer` - 深度分析 ## 最佳实践 1. **定期审计** - 每月或重大更新后审计 2. **跟踪进度** - 保存审计结果对比 3. **优先修复** - 按影响程度修复问题 4. **持续改进** - 建立改进计划 5. **测试验证** - 使用工具验证修改