# Claude Code SEO Assistant
**一个权威性的 SEO 助手工具，为 Next.js 项目提供全面的 SEO 优化支持**
[](https://github.com/huifer/claude-code-seo)
[](LICENSE)
[](https://nextjs.org/)
## 📖 目录
- [快速导航](#-快速导航)
- [核心功能](#-核心功能)
- [快速开始](#-快速开始)
- [项目结构](#-项目结构)
- [致谢](#-致谢)
---
## 🚀 快速导航
### 入门指南
- **[安装指南](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)
---
**让 SEO 优化变得简单高效** ⚡
Made with ❤️ by [Claude Code SEO Team](https://github.com/huifer/claude-code-seo)
[⬆ 返回顶部](#claude-code-seo-assistant)