226 lines
6.6 KiB
Markdown
226 lines
6.6 KiB
Markdown
# Claude Code SEO Assistant
|
||
|
||
<div align="center">
|
||
|
||
**一个权威性的 SEO 助手工具，为 Next.js 项目提供全面的 SEO 优化支持**
|
||
|
||
[](https://github.com/huifer/claude-code-seo)
|
||
[](LICENSE)
|
||
[](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>
|