mingle-website/.claude/skills/claude-code-seo/docs/getting-started.md

快速开始

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

---

🎯 第一步：启动 Claude Code

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

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

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

---

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

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

/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 会在适当的上下文中自动激活，无需手动调用。

何时自动触发？

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

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

7 个自动 Skills

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

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

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

基础 SEO 命令

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

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

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

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

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

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

内容策略命令

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

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

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

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

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

站外 SEO 命令

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

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

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

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

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

本地 SEO 命令

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

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

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

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

💡 提示: 查看完整命令列表和参数说明，请参阅 命令参考

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

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

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

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

Sub-agents 适用场景

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

---

🎓 第四步：尝试更多功能

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

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

输出示例：

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 审计

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

这会生成详细的报告，包括：

• 📊 SEO 评分（0-100 分）
• 🔍 6 个维度的详细分析
• ⚠️ 优先级排序的问题列表
• 💡 具体的修复建议

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

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

这会分析：

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

---

📚 第五步：深入了解

推荐学习路径

1. 基础使用（你在这里）

   • ✅ 运行第一个 /seo-check
   • ✅ 尝试 /metadata 生成元数据
   • ✅ 理解 Skills、Commands、Agents

2. 功能探索

   • 查看 功能特性 - 了解所有 7 大功能模块
   • 阅读 命令参考 - 掌握所有命令参数
   • 学习 评分系统 - 理解 SEO 评分机制

3. 实战应用

   • 查看 使用示例 - 真实场景的完整示例
   • 阅读 深度指南 - 专项 SEO 技能的深入讲解

4. 高级优化

   • 元数据优化 → 元数据优化指南
   • 结构化数据 → 结构化数据指南
   • 内容策略 → 内容策略指南
   • E-E-A-T 建设 → 权威性建设指南
   • 站外 SEO → 站外 SEO 指南
   • 本地 SEO → 本地 SEO 指南

---

💡 最佳实践

1. 渐进式优化

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

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

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

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

2. 持续监控

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

# 每周运行一次完整审计
/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 最佳实践，详见 评分系统

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

A: 插件支持双语（中文/英文）SEO 差异化建议，详见 双语支持

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

A: 可以通过项目配置文件自定义部分规则，详见 安装指南 > 配置选项

---

🎉 下一步

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

• 📖 查看 功能特性 了解所有功能
• 🔍 阅读 使用示例 学习真实场景
• 📚 浏览 深度指南 掌握高级技巧
• 🤝 查看 贡献指南 参与项目

需要帮助？ 访问 GitHub Issues