/geo-content-audit

功能说明

核心功能

GEO 内容审计分析内容在 AI 搜索引擎中的引用优化潜力，通过 6 维度评分系统识别引用障碍，并提供优先级排序的优化建议。

使用场景

• 评估博客文章的 AI 引用潜力
• 优化产品页面以提升 AI 搜索可见性
• 分析竞争对手内容的 GEO 表现
• 监控内容优化前后的 AI 引用率变化

执行流程

步骤 1: 内容读取

• 输入: 文件路径或 URL
• 处理:
  • 本地文件：使用 Read 工具直接读取
  • URL：使用 Bash (curl/wget) 获取内容
• 输出: 原始内容字符串

步骤 2: 权威性信号检测

使用 Grep 工具检测：

# 检测 Schema.org JSON-LD
grep -r '@type' --include='*.json' --include='*.ld'

# 检测作者信息
grep -r 'author' --include='*.md' --include='*.tsx' --include='*.jsx'

# 检测引用来源
grep -E '\[.*\]\(http.*\)' content.md

# 检测时间戳
grep -E '(20\d{2}-\d{2}-\d{2}|January|February|March|April|May|June|July|August|September|October|November|December)' content.md

评分逻辑:

• 作者信息完整（+7 分）
• 有引用来源（+7 分）
• 有时间戳（+6 分）

步骤 3: 实体关系分析

使用 Grep + Read 工具：

# 提取标题结构
grep -E '^#+\s' content.md

# 计算段落长度
awk 'NF {print length}' content.md

# 检测内部链接
grep -E '\[.*\]\(\/.*\)' content.md

# 检测外部链接
grep -E '\[.*\]\(http.*\)' content.md

评分逻辑:

• 标题层级清晰（+7 分）
• 段落长度适中（50-150 词）（+7 分）
• 内部链接丰富（+6 分）

步骤 4: 数据质量评估

手动分析：

• 内容准确性（+7 分）：无明显错误
• 数据新鲜度（+7 分）：6 个月内更新
• 内容完整性（+6 分）：覆盖全面

步骤 5: 生成优化建议

基于评分结果，生成：

1. 🔴 高优先级建议（影响 +10 分以上）
2. 🟡 中优先级建议（影响 +5-10 分）
3. 🟢 低优先级建议（影响 +1-5 分）

步骤 6: 生成报告

• 保存到：.claude-flow/cache/reports/geo/audit-时间戳.json
• 输出：Markdown 格式报告

输出示例

Markdown 输出（默认）

# 🤖 AI 引用优化分析

## 内容分析：blog/post.md

**分析时间：** 2024-01-15 14:30
**目标引擎：** ChatGPT, Claude, Perplexity, Google SGE

---

## 📊 总体评分：58/100 ⚠️

| 维度 | 得分 | 满分 | 状态 |
|------|------|------|------|
| 权威性 | 42/100 | 20 | 🔴 |
| 实体关系 | 68/100 | 20 | 🟡 |
| 内容结构 | 55/100 | 20 | 🟡 |
| 数据质量 | 75/100 | 20 | ✅ |
| 引用密度 | 60/100 | 10 | 🟡 |
| 技术优化 | 50/100 | 10 | 🔴 |

**目标评分：** 70+/100
**当前差距：** -12 分

---

## 🔴 高优先级问题（影响 +10 分以上）

### 1. 缺少作者权威性标识 (-15 分)
**问题：**
- ❌ 无作者 Schema.org 标记
- ❌ 缺少作者资质说明
- ❌ 无专业背景信息

**修复方案：**
```html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "author": {
    "@type": "Person",
    "name": "张三",
    "jobTitle": "高级 SEO 专家",
    "worksFor": {
      "@type": "Organization",
      "name": "Your Company"
    },
    "credential": "Google 认证 SEO 专家，10 年行业经验",
    "sameAs": [
      "https://linkedin.com/in/zhangsan",
      "https://twitter.com/zhangsan"
    ]
  },
  "datePublished": "2024-01-15",
  "dateModified": "2024-01-15"
}
</script>

预期提升： +15 分

---

2. 实体关系不明确 (-12 分)

问题：

• ❌ 核心概念缺少明确定义
• ❌ 实体间关系不清晰
• ❌ 缺少知识图谱结构

修复方案：

## 什么是 SEO？
**SEO（Search Engine Optimization）** 是通过优化网站内容和结构，提高在搜索引擎结果中排名的过程。

### 核心实体关系
- **SEO** 包含：[技术 SEO](/technical-seo)、[内容 SEO](/content-seo)、[外链建设](/link-building)
- **技术 SEO** 影响：网站速度、移动友好性、网站架构
- **内容 SEO** 需要：关键词研究、内容质量、用户体验

预期提升： +12 分

---

3. 内容结构不利于 AI 理解 (-10 分)

问题：

• ❌ 段落过长（平均 450 词）
• ❌ 缺少结构化标记
• ❌ 概念密度过高

修复方案：

### TL;DR
SEO 是通过优化网站提高搜索引擎排名的过程，包含技术、内容和外链三大要素。（15 字总结）

### 什么是 SEO？
**定义：** SEO（Search Engine Optimization）是...
**重要性：** 80% 的流量来自有机搜索
**应用：** 适用于所有网站类型

### SEO 的三大支柱
#### 1. 技术 SEO
- **目标：** 优化网站技术基础
- **关键要素：**
  - 网站速度（< 3 秒）
  - 移动友好（响应式设计）
  - SSL 证书（HTTPS）

### 常见问题
#### Q: SEO 需要多长时间见效？
**A:** 通常 3-6 个月可见明显效果。

预期提升： +10 分

---

🟡 中优先级问题（影响 +5-10 分）

4. 数据新鲜度不足 (-5 分)

问题： 内容发布于 8 个月前

修复方案：

**最后更新：** 2024-01-15
**数据来源：** 2024 年 1 月最新统计
**下次审查：** 2024-04-15

## 更新日志
- 2024-01-15：更新 Google 算法最新变化
- 2023-12-01：添加 AI 搜索优化内容
- 2023-06-15：初次发布

预期提升： +5 分

---

📈 预期改进

优化前后对比

维度	优化前	优化后	提升
权威性	42	75	+33
实体关系	68	85	+17
内容结构	55	70	+15
数据质量	75	80	+5
总分	58	78	+20

AI 引用率预测

• ChatGPT: 15% → 65% (+50%)
• Claude: 12% → 60% (+48%)
• Perplexity: 18% → 70% (+52%)
• Google SGE: 10% → 55% (+45%)

预期流量增长

来自 AI 搜索的流量： +35-50%

---

📝 快速修复清单

立即执行（今天）

• 添加作者 Schema.org 标记
• 优化内容结构（添加 TL;DR、FAQ）
• 明确核心概念定义

本周完成

• 建立实体关系和内部链接
• 更新数据和添加时间戳
• 优化段落长度

持续改进

• 定期更新内容（每 3 个月）
• 监控 AI 引用变化
• 收集用户反馈

---

报告生成时间： 2024-01-15 下次审计建议： 优化完成后重新评估 数据文件： .claude-flow/cache/reports/geo/audit-20240115-143000.json

### JSON 输出

```json
{
  "reportId": "geo-audit-20240115",
  "timestamp": "2024-01-15T14:30:00Z",
  "content": {
    "file": "blog/post.md",
    "url": "https://yoursite.com/article"
  },
  "scores": {
    "overall": 58,
    "authority": 42,
    "entityRelationships": 68,
    "contentStructure": 55,
    "dataQuality": 75,
    "citationDensity": 60,
    "technicalOptimization": 50
  },
  "issues": [
    {
      "priority": "high",
      "category": "authority",
      "issue": "缺少作者权威性标识",
      "impact": -15,
      "fix": "添加作者 Schema 和引用来源"
    },
    {
      "priority": "high",
      "category": "entityRelationships",
      "issue": "实体关系不明确",
      "impact": -12,
      "fix": "明确定义核心概念和关系"
    }
  ],
  "suggestions": [
    {
      "priority": "high",
      "action": "添加作者 Schema.org 标记",
      "code": "<script type=\"application/ld+json\">...",
      "expectedImprovement": 15
    }
  ]
}

使用示例

基础用法

# 审计本地文件
/geo-content-audit blog/my-post.md

# 审计 URL
/geo-content-audit https://example.com/article

高级选项

# 详细模式
/geo-content-audit post.md --detailed

# 指定 AI 引擎
/geo-content-audit post.md --engines chatgpt,claude

# 输出 JSON 格式
/geo-content-audit post.md --output json

# 组合使用
/geo-content-audit post.md --detailed --engines all --output json

相关命令

• /geo-entity-extraction - 提取实体和构建知识图谱
• /geo-citation-monitor - 监控 AI 引用表现
• /seo-audit - 传统 SEO 审计
• /metadata - 元数据优化

注意事项

• 支持本地文件和 URL
• 自动检测内容语言（中/英）
• 如果内容过长（>5000 词），建议分段分析
• JSON 输出可用于自动化集成