365 lines
9.1 KiB
Markdown
365 lines
9.1 KiB
Markdown
# 快速开始
|
||
|
||
本指南将帮助你快速上手 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)
|