# Claude Code SEO Assistant

<div align="center">

**一个权威性的 SEO 助手工具，为 Next.js 项目提供全面的 SEO 优化支持**

[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/huifer/claude-code-seo)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Next.js](https://img.shields.io/badge/Next.js-Ready-black.svg)](https://nextjs.org/)

</div>

## 📖 目录

- [快速导航](#-快速导航)
- [核心功能](#-核心功能)
- [快速开始](#-快速开始)
- [项目结构](#-项目结构)
- [致谢](#-致谢)

---

## 🚀 快速导航

### 入门指南
- **[安装指南](docs/installation.md)** - 三种安装方式（Plugin、项目级、个人级）
- **[快速开始](docs/getting-started.md)** - 第一个 SEO 检查和基础使用

### 核心文档
- **[功能特性](docs/features.md)** - 7 大功能模块完整介绍
- **[命令参考](docs/commands.md)** - 27 个 Slash Commands 详细说明
- **[Skills 详解](docs/skills.md)** - 7 个自动触发的 Skills 说明
- **[评分系统](docs/scoring-system.md)** - 6 维度 SEO 评分体系
- **[双语支持](docs/bilingual-support.md)** - 中英文 SEO 差异化建议

### 实用资源
- **[使用示例](docs/examples/)** - 真实场景的完整示例
- **[深度指南](docs/guides/)** - 专项 SEO 技能的深入教程
- **[外部资源](docs/resources/external-links.md)** - 官方文档和工具推荐
- **[贡献指南](docs/contributing.md)** - 如何参与项目贡献

---

## 🎯 核心功能

### 自动化 SEO 优化
- 🔍 **自动检测** - 识别 Next.js App Router / Pages Router
- 🌐 **双语支持** - 中文和英文 SEO 优化建议
- 📊 **SEO 评分** - 100 分制评分系统，6 个维度
- ⚡ **快速分析** - 一键生成 SEO 审计报告

### 7 大功能模块

#### 1. 基础 SEO
元数据优化（Title, Description, OG, Twitter Cards）、结构化数据生成和验证、robots.txt 和 llm.txt 生成、图片优化检查

#### 2. 内容优化
标题结构分析（H1-H6）、关键词密度和分布、内链机会识别、可读性评估

#### 3. E-E-A-T 权威性建设 ⭐
经验（Experience）评估、专业能力（Expertise）检查、权威性（Authoritativeness）分析、信任度（Trustworthiness）审计、作者简介页面生成

#### 4. 内容策略 ⭐
支柱页面（Pillar Pages）分析、集群内容（Topic Clusters）建议、内容日历规划、关键词蚕食检测、Featured Snippets 优化

#### 5. 客座博客
机会搜索和分析、投稿邮件模板、Google 高级搜索语法生成

#### 6. 站外 SEO ⭐
竞争对手外链分析、断链建设策略、摩天大楼技术实施、HARO 机会分析、行业目录提交、社交信号分析、品牌提及监测、外链跟踪管理

#### 7. 本地 SEO ⭐
NAP 一致性检查、本地关键词优化、Google Business Profile 优化、LocalBusiness Schema 生成、地图嵌入代码

> 📚 **查看完整功能介绍：** [功能特性](docs/features.md)

---

## ⚡ 快速开始

### 1. 安装

```bash
# HTTPS 方式（推荐）
git clone https://github.com/huifer/claude-code-seo.git \
  ~/.claude/plugins/claude-seo-assistant

# SSH 方式（需配置密钥）
git clone git@github.com:huifer/claude-code-seo.git \
  ~/.claude/plugins/claude-seo-assistant
```

> 📖 **详细安装指南：** [安装指南](docs/installation.md)

### 2. 快速 SEO 检查

```bash
/seo-check
```

### 3. 完整 SEO 审计

```bash
/seo-audit
```

### 4. E-E-A-T 权威性审计

```bash
/ee-audit --detailed
```

### 5. 本地 SEO 审计

```bash
/local-seo-audit --deep
```

> 📚 **更多命令和示例：** [命令参考](docs/commands.md) | [使用示例](docs/examples/)

---

## 📦 项目结构

```
claude-code-seo/
├── .claude-plugin/
│   └── plugin.json              # Plugin 配置
├── skills/                      # 7 个 Skills
│   ├── metadata-optimizer/
│   ├── seo-auditor/
│   ├── structured-data/
│   ├── content-optimizer/
│   ├── guest-blogger/
│   ├── off-page-seo/           ⭐
│   └── local-seo/              ⭐
├── commands/                    # 27 个 Slash Commands
├── agents/                      # 2 个 Sub-agents
├── templates/                   # 13 个模板
├── resources/                   # 5 个资源文件
├── docs/                        # 完整文档 ⭐
│   ├── README.md                # 文档导航
│   ├── installation.md          # 安装指南
│   ├── getting-started.md       # 快速开始
│   ├── features.md              # 功能特性
│   ├── commands.md              # 命令参考
│   ├── skills.md                # Skills 详解
│   ├── scoring-system.md        # 评分系统
│   ├── bilingual-support.md     # 双语支持
│   ├── examples/                # 使用示例
│   ├── guides/                  # 深度指南
│   ├── resources/               # 外部资源
│   └── contributing.md          # 贡献指南
├── LICENSE                      # MIT 许可证
└── README.md                    # 本文档
```

---

## 📊 SEO 评分示例

```
SEO 评分: 78/100

├─ 元数据完整性: 18/20  ⭐⭐⭐⭐⭐
├─ 结构化数据: 12/15    ⭐⭐⭐⭐
├─ 内容质量: 20/25      ⭐⭐⭐⭐
├─ E-E-A-T 权威性: 14/20  ⭐⭐⭐
├─ 内容策略: 6/10       ⭐⭐⭐
└─ 技术 SEO: 8/10       ⭐⭐⭐⭐

优先修复建议：
🔴 [P0] 添加案例研究和实际经验展示 (+3 分)
🟡 [P1] 完善作者信息和关于页面 (+2 分)
🟢 [P2] 优化集群内容的内部链接结构 (+1 分)
```

> 📖 **了解评分系统：** [评分系统详解](docs/scoring-system.md)

---

## 🤝 贡献

我们欢迎所有形式的贡献！

- 🐛 报告 Bug
- 💡 提出新功能建议
- 🔧 提交代码改进
- 📚 完善文档
- 🙏 分享使用经验

**如何贡献：** 查看 [贡献指南](docs/contributing.md)

---

## 📝 许可证

本项目采用 [MIT 许可证](LICENSE) - 查看 LICENSE 文件了解详情

---

## 🙏 致谢

- [Next.js](https://nextjs.org/) - React 框架
- [Schema.org](https://schema.org/) - 结构化数据标准
- [Google Search Central](https://developers.google.com/search) - SEO 指南

---

## 📮 联系方式

- **GitHub Issues:** [提交问题](https://github.com/huifer/claude-code-seo/issues)
- **文档首页:** [完整文档](docs/README.md)

---

<div align="center">

**让 SEO 优化变得简单高效** ⚡

Made with ❤️ by [Claude Code SEO Team](https://github.com/huifer/claude-code-seo)

[⬆ 返回顶部](#claude-code-seo-assistant)

</div>
