382 lines
9.6 KiB
Markdown
382 lines
9.6 KiB
Markdown
---
|
||
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. **测试验证** - 使用工具验证修改
|