# 命令参考

Claude Code SEO Assistant 提供 27 个 Slash Commands，覆盖所有 SEO 功能模块。

---

## 📋 命令分类

- [基础 SEO 命令](#基础-seo-命令)
- [内容策略命令](#内容策略命令)
- [站外 SEO 命令](#站外-seo-命令)
- [本地 SEO 命令](#本地-seo-命令)

---

## 基础 SEO 命令

### `/seo-check` - 快速 SEO 检查

快速检查当前目录或指定文件的 SEO 基础要素。

**用法：**
```bash
/seo-check [文件路径]
```

**参数：**
- `文件路径`（可选）- 要检查的文件或目录路径，默认为当前目录

**示例：**
```bash
# 检查当前目录
/seo-check

# 检查指定文件
/seo-check app/page.tsx

# 检查指定目录
/seo-check app/blog
```

**输出：**
- 页面数量统计
- 缺失的元数据列表
- 基本问题诊断
- 快速修复建议

**相关文档：** [SEO 检查示例](examples/seo-check.md)

---

### `/seo-audit` - 全面 SEO 审计

对整个项目进行深度 SEO 审计，生成详细报告和评分。

**用法：**
```bash
/seo-audit [目录路径]
```

**参数：**
- `目录路径`（可选）- 要审计的目录，默认为当前项目

**示例：**
```bash
# 审计整个项目
/seo-audit

# 审计特定目录
/seo-audit app/blog
```

**输出：**
- 6 维度 SEO 评分（0-100 分）
- 详细问题列表和优先级
- 结构化数据验证结果
- 具体修复建议

**相关文档：** [评分系统](scoring-system.md)

---

### `/metadata` - 生成元数据

为指定页面生成优化的元数据（Title、Description、OG、Twitter Cards）。

**用法：**
```bash
/metadata [页面路径]
```

**参数：**
- `页面路径`（可选）- 页面文件路径

**示例：**
```bash
# 为当前页面生成
/metadata

# 为指定页面生成
/metadata app/about/page.tsx
```

**输出：**
```javascript
export const metadata = {
  title: '优化的标题',
  description: '优化的描述',
  openGraph: { ... },
  twitter: { ... },
}
```

**相关文档：** [元数据优化指南](guides/metadata-optimization.md)

---

### `/structured-data` - 生成结构化数据

为页面生成 JSON-LD 结构化数据。

**用法：**
```bash
/structured-data [页面路径] [schema-type]
```

**参数：**
- `页面路径`（可选）- 页面文件路径
- `schema-type`（可选）- Schema 类型（如 Article、Organization、LocalBusiness）

**示例：**
```bash
# 生成文章结构化数据
/structured-data app/blog/post-1.tsx Article

# 生成本地商家结构化数据
/structured-data app/contact.tsx LocalBusiness

# 自动检测类型
/structured-data
```

**输出：**
```javascript
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "文章标题",
  ...
}
</script>
```

**相关文档：** [结构化数据指南](guides/structured-data.md)

---

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

生成优化的 robots.txt 文件。

**用法：**
```bash
/robots-txt [域名]
```

**参数：**
- `域名`（必需）- 网站的域名

**示例：**
```bash
/robots-txt https://example.com
```

**输出：**
```
User-agent: *
Allow: /
Sitemap: https://example.com/sitemap.xml
```

---

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

为 AI 模型生成项目描述文件，帮助 AI 理解项目上下文。

**用法：**
```bash
/llm-txt [--verbose]
```

**参数：**
- `--verbose`（可选）- 生成更详细的描述

**示例：**
```bash
# 基本版本
/llm-txt

# 详细版本
/llm-txt --verbose
```

---

## 内容策略命令

### `/content-strategy` - 内容策略分析

分析内容策略，识别改进机会。

**用法：**
```bash
/content-strategy [--deep-analysis]
```

**参数：**
- `--deep-analysis`（可选）- 执行深度分析

**示例：**
```bash
# 基本分析
/content-strategy

# 深度分析
/content-strategy --deep-analysis
```

**输出：**
- 内容完整性评估
- 内容缺口识别
- 改进建议

**相关文档：** [内容策略指南](guides/content-strategy.md)

---

### `/pillar-pages` - 支柱页面分析

识别和分析支柱页面内容。

**用法：**
```bash
/pillar-pages [主题] [--analyze]
```

**参数：**
- `主题`（可选）- 要分析的支柱主题
- `--analyze`（可选）- 执行深度分析

**示例：**
```bash
# 列出所有支柱页面
/pillar-pages

# 分析特定主题
/pillar-pages "SEO 优化" --analyze
```

---

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

分析主题集群和内部链接结构。

**用法：**
```bash
/topic-clusters [--analyze] [--suggest]
```

**参数：**
- `--analyze`（可选）- 分析现有集群
- `--suggest`（可选）- 建议新的集群

**示例：**
```bash
# 分析现有集群
/topic-clusters --analyze

# 获取集群建议
/topic-clusters --suggest
```

---

### `/ee-audit` - E-E-A-T 权威性审计

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

**用法：**
```bash
/ee-audit [--detailed]
```

**参数：**
- `--detailed`（可选）- 生成详细报告

**示例：**
```bash
# 基本审计
/ee-audit

# 详细审计
/ee-audit --detailed
```

**输出：**
- E-E-A-T 总评分
- 4 个维度的详细分析
- 改进建议

**相关文档：** [E-E-A-T 建设指南](guides/ee-at-building.md) | [E-E-A-T 审计示例](examples/ee-audit.md)

---

### `/author-bio` - 生成作者简介

为作者生成专业的简介页面。

**用法：**
```bash
/author-bio [作者姓名]
```

**参数：**
- `作者姓名`（可选）- 作者姓名

**示例：**
```bash
/author-bio "张三"

# 使用当前 Git 用户
/author-bio
```

**相关文档：** [作者简介模板](../templates/author-bio-template.md)

---

## 站外 SEO 命令

### `/competitor-backlinks` - 竞争对手外链分析

分析竞争对手的外链策略。

**用法：**
```bash
/competitor-backlinks [竞争对手URL] [--deep]
```

**参数：**
- `竞争对手URL`（必需）- 竞争对手网站 URL
- `--deep`（可选）- 执行深度分析

**示例：**
```bash
# 基本分析
/competitor-backlinks https://competitor.com

# 深度分析
/competitor-backlinks https://competitor.com --deep
```

**输出：**
- 外链来源列表
- 权威性评分
- 获取机会分析

**相关文档：** [站外 SEO 指南](guides/off-page-seo.md)

---

### `/broken-links` - 断链建设

寻找断链建设机会。

**用法：**
```bash
/broken-links [--niche <主题>] [--template]
```

**参数：**
- `--niche`（可选）- 指定行业主题
- `--template`（可选）- 生成联系邮件模板

**示例：**
```bash
# 搜索断链
/broken-links

# 指定主题
/broken-links --niche "SEO"

# 生成邮件模板
/broken-links --template
```

**相关文档：** [断链建设模板](../templates/broken-link-outreach.md)

---

### `/skyscraper` - 摩天大楼技术

实施摩天大楼技术策略。

**用法：**
```bash
/skyscraper [--topic <主题>] [--template]
```

**参数：**
- `--topic`（可选）- 指定主题
- `--template`（可选）- 生成推广邮件模板

**示例：**
```bash
# 默认执行
/skyscraper

# 指定主题
/skyscraper --topic "链接建设"

# 生成模板
/skyscraper --template
```

**相关文档：** [摩天大楼技术模板](../templates/skyscraper-pitch.md)

---

### `/haro-opportunities` - HARO 机会

分析 HARO（Help a Reporter Out）机会。

**用法：**
```bash
/haro-opportunities [--category <分类>] [--recent]
```

**参数：**
- `--category`（可选）- 筛选分类
- `--recent`（可选）- 仅显示最新机会

**示例：**
```bash
# 所有机会
/haro-opportunities

# 筛选分类
/haro-opportunities --category "技术"

# 仅最新
/haro-opportunities --recent
```

**相关文档：** [HARO 响应模板](../templates/haro-response.md)

---

### `/link-tracker` - 外链跟踪

管理和跟踪外链接获取进度。

**用法：**
```bash
/link-tracker [--add] [--status] [--report]
```

**参数：**
- `--add`（可选）- 添加新外链
- `--status`（可选）- 查看状态
- `--report`（可选）- 生成报告

**示例：**
```bash
# 添加外链
/link-tracker --add

# 查看状态
/link-tracker --status

# 生成报告
/link-tracker --report
```

**相关文档：** [外链跟踪表格](../templates/link-tracking-sheet.md)

---

## 本地 SEO 命令

### `/local-seo-audit` - 本地 SEO 审计

执行本地 SEO 全面审计。

**用法：**
```bash
/local-seo-audit [--deep]
```

**参数：**
- `--deep`（可选）- 执行深度审计

**示例：**
```bash
# 基本审计
/local-seo-audit

# 深度审计
/local-seo-audit --deep
```

**输出：**
- NAP 一致性检查
- 本地关键词分析
- GBP 优化建议
- LocalBusiness Schema 验证

**相关文档：** [本地 SEO 指南](guides/local-seo.md) | [本地 SEO 审计示例](examples/local-seo.md)

---

### `/nap-check` - NAP 一致性检查

检查名称、地址、电话号码的一致性。

**用法：**
```bash
/nap-check [--standardize]
```

**参数：**
- `--standardize`（可选）- 生成标准化建议

**示例：**
```bash
# 检查一致性
/nap-check

# 标准化格式
/nap-check --standardize
```

**相关文档：** [NAP 标准化模板](../templates/nap-standardization.md)

---

### `/local-keywords` - 本地关键词优化

生成本地关键词建议。

**用法：**
```bash
/local-keywords [--city <城市>] [--analyze]
```

**参数：**
- `--city`（可选）- 指定城市
- `--analyze`（可选）- 分析竞争度

**示例：**
```bash
# 默认建议
/local-keywords

# 指定城市
/local-keywords --city "北京"

# 竞争分析
/local-keywords --analyze
```

**相关文档：** [本地关键词优化模板](../templates/local-keyword-optimization.md)

---

### `/gbp-optimizer` - GBP 优化

优化 Google Business Profile。

**用法：**
```bash
/gbp-optimizer [--analyze] [--review-template]
```

**参数：**
- `--analyze`（可选）- 分析当前 GBP
- `--review-template`（可选）- 生成评价响应模板

**示例：**
```bash
# 分析 GBP
/gbp-optimizer --analyze

# 生成评价响应
/gbp-optimizer --review-template
```

**相关文档：** [GBP 检查清单](../templates/local-seo-checklist.md) | [GBP 评价响应模板](../templates/gbp-review-response.md)

---

## 💡 命令使用技巧

### 1. 命令别名

部分命令支持简写：
```bash
/seo-check    → /check
/seo-audit    → /audit
/metadata     → /meta
/structured-data → /schema
```

### 2. 组合使用

可以组合多个命令获得全面分析：
```bash
# 完整的 SEO 工作流
/seo-check          # 快速检查
/seo-audit          # 完整审计
/ee-audit          # 权威性审计
/content-strategy   # 内容策略
```

### 3. 输出重定向

将命令输出保存到文件：
```bash
/seo-audit > seo-report.md
```

### 4. 定时执行

建议定期执行的命令：
```bash
# 每周
/seo-audit

# 每月
/ee-audit
/link-tracker --report

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

---

## 📚 命令 vs Skills vs Agents

| 类型 | 使用方式 | 触发方式 | 适用场景 |
|-----|---------|---------|---------|
| **Commands** | `/command-name` | 手动调用 | 特定 SEO 任务 |
| **Skills** | 自动触发 | 上下文识别 | 实时优化建议 |
| **Agents** | `Agent: agent-name` | 手动启动 | 复杂多步骤分析 |

**相关文档：**
- [Skills 详解](skills.md)
- [快速开始 - 使用方式](getting-started.md#第三步理解-claude-code-seo-的三种使用方式)

---

**需要帮助？**
- 查看 [使用示例](examples/)
- 阅读 [深度指南](guides/)
- 访问 [GitHub Issues](https://github.com/huifer/claude-code-seo/issues)
