# 评分系统

Claude Code SEO Assistant 使用 100 分制的评分系统，从 6 个维度全面评估网站的 SEO 表现。

---

## 📊 总体评分

### 评分示例

```
SEO 评分: 78/100

├─ 元数据完整性: 18/20  ⭐⭐⭐⭐⭐
├─ 结构化数据: 12/15    ⭐⭐⭐⭐
├─ 内容质量: 20/25      ⭐⭐⭐⭐
├─ E-E-A-T 权威性: 14/20  ⭐⭐⭐
├─ 内容策略: 6/10       ⭐⭐⭐
└─ 技术 SEO: 8/10       ⭐⭐⭐⭐

优先修复建议：
🔴 [P0] 添加案例研究和实际经验展示 (+3 分)
🟡 [P1] 完善作者信息和关于页面 (+2 分)
🟢 [P2] 优化集群内容的内部链接结构 (+1 分)
```

---

## 🎯 六大评分维度

### 1. 元数据完整性（20 分）

评估页面元数据的覆盖度和质量。

| 评分项 | 分数 | 标准 |
|--------|------|------|
| Title 标签 | 5/5 | 长度合适、包含关键词、有品牌名 |
| Description | 5/5 | 长度合适、有行动号召、关键词自然 |
| Open Graph | 5/5 | OG Title、Description、Image 完整 |
| Twitter Cards | 5/5 | Card 类型、图片、描述完整 |

**扣分规则：**
- ❌ 缺少 Title: -5 分
- ⚠️ Title 过短/过长: -2 分
- ❌ 缺少 Description: -5 分
- ⚠️ Description 过短/过长: -2 分
- ❌ 缺少 OG 标签: -3 分
- ❌ 缺少 Twitter Cards: -2 分

**提升建议：**
```bash
# 生成优化的元数据
/metadata [页面路径]

# 检查所有页面
/seo-check
```

---

### 2. 结构化数据（15 分）

评估 JSON-LD 结构化数据的完整性和正确性。

| 评分项 | 分数 | 标准 |
|--------|------|------|
| 存在性 | 5/5 | 至少有一种结构化数据 |
| 必需字段 | 5/5 | 所有必需字段完整 |
| 验证通过 | 5/5 | 通过 Google 验证工具 |

**支持的 Schema 类型：**
- Article（文章）
- Organization（组织）
- LocalBusiness（本地商家）
- Product（产品）
- Review（评论）
- FAQPage（常见问题）
- HowTo（操作指南）
- Event（活动）

**扣分规则：**
- ❌ 完全没有结构化数据: -5 分
- ⚠️ 缺少必需字段: -2 分
- ⚠️ 验证失败: -3 分

**提升建议：**
```bash
# 生成结构化数据
/structured-data [页面路径] [schema-type]

# 验证现有数据
/seo-audit
```

---

### 3. 内容质量（25 分）

评估页面内容的 SEO 友好度和用户体验。

| 评分项 | 分数 | 标准 |
|--------|------|------|
| 标题结构 | 5/5 | H1-H6 层级清晰、逻辑正确 |
| 内容长度 | 5/5 | 字数符合建议（通常 >300 字） |
| 关键词优化 | 5/5 | 密度合适（中文 2-4%，英文 1-2%） |
| 多媒体元素 | 5/5 | 图片、视频有 alt/说明 |
| 内链外链 | 5/5 | 相关链接充足 |

**扣分规则：**
- ⚠️ 缺少 H1 或多个 H1: -3 分
- ⚠️ 内容过短: -3 分
- ⚠️ 关键词密度过高/过低: -2 分
- ⚠️ 图片缺少 alt: -2 分
- ⚠️ 缺少内链: -2 分

**提升建议：**
```bash
# 内容优化
/content-optimizer

# 关键词分析
/seo-audit
```

---

### 4. E-E-A-T 权威性（20 分）

评估网站的经验、专业能力、权威性和信任度。

| 评分项 | 分数 | 标准 |
|--------|------|------|
| 经验（Experience） | 5/5 | 案例研究、实际经验展示 |
| 专业能力（Expertise） | 5/5 | 技术准确性、专业背景 |
| 权威性（Authoritativeness） | 5/5 | 外部引用、支柱内容 |
| 信任度（Trustworthiness） | 5/5 | 透明度、安全性 |

**扣分规则：**
- ⚠️ 缺少案例研究: -3 分
- ⚠️ 作者信息不完整: -2 分
- ⚠️ 缺少外部引用: -2 分
- ⚠️ 没有联系信息: -3 分
- ⚠️ 缺少隐私政策: -2 分

**提升建议：**
```bash
# E-E-A-T 审计
/ee-audit --detailed

# 生成作者页面
/author-bio [作者姓名]
```

**相关文档：** [E-E-A-T 建设指南](guides/ee-at-building.md)

---

### 5. 内容策略（10 分）

评估内容结构和策略的成熟度。

| 评分项 | 分数 | 标准 |
|--------|------|------|
| 支柱内容 | 3/3 | 有明确的支柱页面 |
| 集群结构 | 3/3 | 主题集群完整 |
| 内容日历 | 2/2 | 有发布计划 |
| 关键词蚕食 | 2/2 | 无关键词冲突 |

**扣分规则：**
- ⚠️ 缺少支柱页面: -3 分
- ⚠️ 集群不完整: -2 分
- ⚠️ 有关键词蚕食: -2 分

**提升建议：**
```bash
# 分析支柱页面
/pillar-pages --analyze

# 分析集群内容
/topic-clusters --analyze

# 内容策略
/content-strategy --deep-analysis
```

---

### 6. 技术 SEO（10 分）

评估技术层面的 SEO 优化。

| 评分项 | 分数 | 标准 |
|--------|------|------|
| robots.txt | 3/3 | 存在且正确 |
| URL 结构 | 2/2 | 清晰、语义化 |
| 移动友好 | 2/2 | 响应式设计 |
| 页面速度 | 2/2 | 加载时间合理 |
| HTTPS | 1/1 | 使用 HTTPS |

**扣分规则：**
- ❌ 缺少 robots.txt: -3 分
- ⚠️ URL 不规范: -1 分
- ⚠️ 非响应式: -2 分
- ⚠️ 页面过慢: -1 分
- ❌ 非 HTTPS: -1 分

**提升建议：**
```bash
# 生成 robots.txt
/robots-txt [域名]

# 生成 llm.txt
/llm-txt
```

---

## 🎨 优先级系统

根据影响程度和实施难度，建议分为三个优先级：

### 🔴 高优先级（P0）- +3 分以上

这些改进能够显著提升 SEO 评分：

1. **添加缺失的元数据**
   - Title、Description
   - 预期提升: +5-8 分

2. **实现结构化数据**
   - 至少一种 Schema 类型
   - 预期提升: +5-7 分

3. **提升 E-E-A-T 权威性**
   - 添加案例研究
   - 完善作者信息
   - 预期提升: +4-6 分

### 🟡 中优先级（P1）- +1-2 分

这些改进能够稳步提升评分：

1. **优化现有元数据**
   - 调整长度、关键词位置
   - 预期提升: +2-3 分

2. **改进内容结构**
   - 标题层级、内链
   - 预期提升: +2-3 分

3. **添加 Featured Snippets**
   - 结构化内容格式
   - 预期提升: +1-2 分

### 🟢 低优先级（P2）- +1 分以下

这些是锦上添花的优化：

1. **图片 alt 优化**
   - 描述性 alt 文本
   - 预期提升: +1 分

2. **社交分享按钮**
   - 增加社交信号
   - 预期提升: +1 分

3. **页面加载速度**
   - 优化图片、代码
   - 预期提升: +1 分

---

## 📈 评分等级

| 分数范围 | 等级 | 说明 |
|---------|------|------|
| 90-100 | 优秀 ⭐⭐⭐⭐⭐ | SEO 优化极佳，无明显问题 |
| 75-89 | 良好 ⭐⭐⭐⭐ | SEO 优化良好，有小幅改进空间 |
| 60-74 | 中等 ⭐⭐⭐ | SEO 基础合格，有明显改进空间 |
| 40-59 | 较差 ⭐⭐ | SEO 存在较多问题 |
| 0-39 | 很差 ⭐ | SEO 急需全面优化 |

---

## 🔍 如何提升评分

### 快速提升（+10 分以上）

```bash
# 1. 生成元数据
/metadata app/page.tsx

# 2. 添加结构化数据
/structured-data app/page.tsx Article

# 3. 完善作者信息
/author-bio "作者姓名"

# 4. 生成技术文件
/robots-txt https://example.com
/llm-txt
```

### 稳步提升（+5-10 分）

```bash
# 1. 内容优化
/content-optimizer

# 2. 关键词分析
/seo-audit

# 3. 内链优化
/topic-clusters --suggest
```

### 长期提升（持续优化）

```bash
# 1. E-E-A-T 建设
/ee-audit --detailed

# 2. 内容策略
/content-strategy --deep-analysis

# 3. 外链建设
/competitor-backlinks https://competitor.com
```

---

## 💡 最佳实践

### 1. 定期评分检查

```bash
# 每周
/seo-audit

# 每月
/ee-audit

# 每季度
/content-strategy --deep-analysis
```

### 2. 追踪评分变化

记录评分历史，评估改进效果：

```markdown
## SEO 评分历史

| 日期 | 总分 | 元数据 | 结构化数据 | 内容 | E-E-A-T | 策略 | 技术 |
|------|------|--------|-----------|------|---------|------|------|
| 2025-01-01 | 45 | 12 | 5 | 15 | 8 | 3 | 2 |
| 2025-01-15 | 62 | 18 | 10 | 18 | 10 | 4 | 2 |
| 2025-02-01 | 78 | 20 | 15 | 22 | 14 | 6 | 5 |
```

### 3. 渐进式优化

不要试图一次性达到满分，按优先级逐步改进：

```
第 1 周：修复所有高优先级问题 (+15 分)
第 2-3 周：优化中优先级项目 (+8 分)
第 4 周：完善低优先级细节 (+5 分)
```

---

## 📚 相关文档

**功能相关：**
- [功能特性](features.md) - 所有功能介绍
- [命令参考](commands.md) - 如何使用命令

**深度指南：**
- [元数据优化指南](guides/metadata-optimization.md)
- [结构化数据指南](guides/structured-data.md)
- [E-E-A-T 建设指南](guides/ee-at-building.md)
- [内容策略指南](guides/content-strategy.md)

**使用示例：**
- [E-E-A-T 审计示例](examples/ee-audit.md)
- [本地 SEO 示例](examples/local-seo.md)

---

**需要帮助？** 访问 [GitHub Issues](https://github.com/huifer/claude-code-seo/issues)
