# 快速开始

本指南将帮助你快速上手 Claude Code SEO Assistant，完成你的第一个 SEO 审计。

---

## 🎯 第一步：启动 Claude Code

在你的项目目录中启动 Claude Code：

```bash
cd /path/to/your-nextjs-project
claude-code
```

Claude Code 会自动检测已安装的 SEO 插件。

---

## 🔍 第二步：运行第一个 SEO 检查

最简单的开始方式是使用快速 SEO 检查命令：

```bash
/seo-check
```

这个命令会：
- ✅ 自动检测你的 Next.js 路由系统（App Router / Pages Router）
- ✅ 扫描所有页面文件
- ✅ 检查基本的 SEO 元数据
- ✅ 生成快速报告

### 预期输出

```
✅ SEO 快速检查完成

📊 扫描统计
├─ 扫描页面: 12 个
├─ 路由系统: Next.js App Router
├─ 检测语言: 中文 (zh-CN)

⚠️  发现的问题
├─ 3 个页面缺少 Description
├─ 5 个页面标题过长
├─ 2 个页面缺少 OG 标签

✅  建议操作
├─ 运行 /seo-audit 进行完整审计
├─ 使用 /metadata 生成缺失的元数据
└─ 查看 [功能特性](features.md) 了解更多功能
```

---

## 📋 第三步：理解 Claude Code SEO 的三种使用方式

Claude Code SEO 提供三种不同级别的工具：

### 1. **Skills** - 自动触发的智能助手

Skills 会在适当的上下文中自动激活，无需手动调用。

#### 何时自动触发？

```javascript
// 当你打开或编辑包含元数据的文件时
// metadata-optimizer 和 seo-auditor 会自动分析

app/page.tsx
├── export const metadata = { ... }  // ← 触发 metadata-optimizer
└── <script type="application/ld+json">  // ← 触发 structured-data
```

#### 7 个自动 Skills

| Skill | 触发条件 | 功能 |
|-------|---------|------|
| [metadata-optimizer](../skills/metadata-optimizer/SKILL.md) | 编辑元数据文件 | 自动优化 Title、Description |
| [seo-auditor](../skills/seo-auditor/SKILL.md) | 打开页面文件 | 快速 SEO 检查和评分 |
| [structured-data](../skills/structured-data/SKILL.md) | 编辑 JSON-LD | 结构化数据验证 |
| [content-optimizer](../skills/content-optimizer/SKILL.md) | 编辑内容 | 关键词密度、可读性分析 |
| [guest-blogger](../skills/guest-blogger/SKILL.md) | 提及客座博客 | 搜索机会和生成邮件 |
| [off-page-seo](../skills/off-page-seo/SKILL.md) | 提及外链 | 竞争对手分析 |
| [local-seo](../skills/local-seo/SKILL.md) | 检测本地商家信息 | NAP、GBP 优化建议 |

### 2. **Slash Commands** - 手动调用的命令

使用 `/` 前缀的命令执行特定 SEO 任务。

#### 基础 SEO 命令

```bash
# 快速 SEO 检查
/seo-check [文件路径]

# 全面 SEO 审计
/seo-audit [目录路径]

# 生成元数据
/metadata [页面路径]

# 生成结构化数据
/structured-data [页面路径] [schema-type]

# 生成 robots.txt
/robots-txt [域名]

# 生成 llm.txt
/llm-txt [--verbose]
```

#### 内容策略命令

```bash
# 内容策略分析
/content-strategy [--deep-analysis]

# 支柱页面分析
/pillar-pages [主题] [--analyze]

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

# E-E-A-T 审计
/ee-audit [--detailed]

# 生成作者简介
/author-bio [作者姓名]
```

#### 站外 SEO 命令

```bash
# 竞争对手外链分析
/competitor-backlinks [竞争对手URL] [--deep]

# 断链建设
/broken-links [--niche <主题>] [--template]

# 摩天大楼技术
/skyscraper [--topic <主题>] [--template]

# HARO 机会
/haro-opportunities [--category <分类>] [--recent]

# 外链跟踪
/link-tracker [--add] [--status] [--report]
```

#### 本地 SEO 命令

```bash
# 本地 SEO 审计
/local-seo-audit [--deep]

# NAP 一致性检查
/nap-check [--standardize]

# 本地关键词优化
/local-keywords [--city <城市>] [--analyze]

# GBP 优化
/gbp-optimizer [--analyze] [--review-template]
```

> 💡 **提示:** 查看完整命令列表和参数说明，请参阅 [命令参考](commands.md)

### 3. **Sub-agents** - 深度分析专家

使用 Agent 启动专门的 SEO 分析专家，进行更复杂的多步骤分析。

```bash
# 启动 SEO 分析专家
Agent: seo-analyzer

# 启动内容优化专家
Agent: content-optimizer
```

#### Sub-agents 适用场景

- 需要多步骤分析的复杂任务
- 需要上下文理解的深度优化
- 跨文件的全局 SEO 策略分析

---

## 🎓 第四步：尝试更多功能

### 示例 1: 生成完整的元数据

```bash
# 为你的首页生成优化的元数据
/metadata app/page.tsx
```

输出示例：

```javascript
export const metadata = {
  title: 'Claude Code SEO - Next.js SEO 优化助手 | 提升搜索排名',
  description: '强大的 Claude Code SEO 插件，为 Next.js 项目提供全面的 SEO 优化支持。自动审计、元数据生成、结构化数据、E-E-A-T 分析。',
  keywords: ['Claude Code', 'SEO', 'Next.js', 'SEO 优化', '结构化数据'],
  openGraph: {
    title: 'Claude Code SEO - Next.js SEO 优化助手',
    description: '强大的 Claude Code SEO 插件，为 Next.js 项目提供全面的 SEO 优化支持',
    url: 'https://yourdomain.com',
    siteName: 'Claude Code SEO',
    images: [{
      url: 'https://yourdomain.com/og-image.jpg',
      width: 1200,
      height: 630,
    }],
    locale: 'zh_CN',
    type: 'website',
  },
  twitter: {
    card: 'summary_large_image',
    title: 'Claude Code SEO - Next.js SEO 优化助手',
    description: '强大的 Claude Code SEO 插件，为 Next.js 项目提供全面的 SEO 优化支持',
    images: ['https://yourdomain.com/twitter-image.jpg'],
  },
}
```

### 示例 2: 运行完整的 SEO 审计

```bash
# 对整个项目进行全面审计
/seo-audit
```

这会生成详细的报告，包括：
- 📊 SEO 评分（0-100 分）
- 🔍 6 个维度的详细分析
- ⚠️ 优先级排序的问题列表
- 💡 具体的修复建议

### 示例 3: E-E-A-T 权威性审计

```bash
# 评估网站的权威性
/ee-audit --detailed
```

这会分析：
- ✅ 经验（Experience）- 案例研究、实际经验
- ✅ 专业能力（Expertise）- 技术准确性、专业背景
- ✅ 权威性（Authoritativeness）- 外部引用、支柱内容
- ✅ 信任度（Trustworthiness）- 联系信息、数据透明

---

## 📚 第五步：深入了解

### 推荐学习路径

1. **基础使用**（你在这里）
   - ✅ 运行第一个 `/seo-check`
   - ✅ 尝试 `/metadata` 生成元数据
   - ✅ 理解 Skills、Commands、Agents

2. **功能探索**
   - 查看 [功能特性](features.md) - 了解所有 7 大功能模块
   - 阅读 [命令参考](commands.md) - 掌握所有命令参数
   - 学习 [评分系统](scoring-system.md) - 理解 SEO 评分机制

3. **实战应用**
   - 查看 [使用示例](examples/) - 真实场景的完整示例
   - 阅读 [深度指南](guides/) - 专项 SEO 技能的深入讲解

4. **高级优化**
   - 元数据优化 → [元数据优化指南](guides/metadata-optimization.md)
   - 结构化数据 → [结构化数据指南](guides/structured-data.md)
   - 内容策略 → [内容策略指南](guides/content-strategy.md)
   - E-E-A-T 建设 → [权威性建设指南](guides/ee-at-building.md)
   - 站外 SEO → [站外 SEO 指南](guides/off-page-seo.md)
   - 本地 SEO → [本地 SEO 指南](guides/local-seo.md)

---

## 💡 最佳实践

### 1. 渐进式优化

不要试图一次性修复所有 SEO 问题。按优先级逐步改进：

```
🔴 高优先级（P0）
├─ 添加缺失的 Title 和 Description
├─ 修复结构化数据错误
└─ 确保移动友好

🟡 中优先级（P1）
├─ 优化现有元数据
├─ 改进内容结构
└─ 添加内链

🟢 低优先级（P2）
├─ 图片 alt 优化
├─ 社交分享按钮
└─ 页面加载速度
```

### 2. 持续监控

SEO 不是一次性的任务，而是一个持续的过程：

```bash
# 每周运行一次完整审计
/seo-audit

# 每月检查 E-E-A-T 评分
/ee-audit

# 每季度审查内容策略
/content-strategy --deep-analysis
```

### 3. 结合使用

结合使用不同的工具获得最佳效果：

- **Skills** - 在开发时获得即时建议
- **Commands** - 执行特定的 SEO 任务
- **Agents** - 进行复杂的多步骤分析

---

## ❓ 常见问题

### Q: 支持哪些项目类型？

**A:** 主要针对 Next.js 项目优化，但也支持：
- ✅ Next.js (App Router & Pages Router)
- ✅ React 项目
- ✅ 任何 Web 项目（部分功能）

### Q: SEO 评分的依据是什么？

**A:** 基于 Google 搜索质量指南和 SEO 最佳实践，详见 [评分系统](scoring-system.md)

### Q: 如何处理多语言网站？

**A:** 插件支持双语（中文/英文）SEO 差异化建议，详见 [双语支持](bilingual-support.md)

### Q: 可以自定义 SEO 规则吗？

**A:** 可以通过项目配置文件自定义部分规则，详见 [安装指南 > 配置选项](installation.md#配置选项)

---

## 🎉 下一步

恭喜你完成了快速开始！现在可以：

- 📖 查看 [功能特性](features.md) 了解所有功能
- 🔍 阅读 [使用示例](examples/) 学习真实场景
- 📚 浏览 [深度指南](guides/) 掌握高级技巧
- 🤝 查看 [贡献指南](contributing.md) 参与项目

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