# 双语支持
Claude Code SEO Assistant 原生支持中文和英文两种语言，提供差异化的 SEO 优化建议。
---
## 🌏 支持的语言
### 🇨🇳 简体中文（zh-CN）
- **主要搜索引擎：** 百度、搜狗、Google
- **字符集：** UTF-8
- **标点符号：** 中文标点
### 🇺🇸 英语（en-US）
- **主要搜索引擎：** Google、Bing
- **字符集：** UTF-8
- **标点符号：** 英文标点
---
## 🔍 自动语言检测
工具会自动检测内容语言，使用以下方法：
### 1. 中文字符比例分析
```javascript
// 检测逻辑
const chineseCharRatio = (chineseChars / totalChars) * 100;
if (chineseCharRatio > 30%) {
language = 'zh-CN';
} else {
language = 'en-US';
}
```
### 2. HTML lang 属性
```html
```
### 3. URL 结构识别
```
/zh/about/ → 中文
/en/about/ → 英文
/about/ → 自动检测
```
---
## 📊 差异化建议
### Title 标题
| 语言 | 建议长度 | 关键词位置 | 示例 |
|------|---------|-----------|------|
| **中文** | 20-30 字符 | 靠前 | "Claude Code SEO - Next.js SEO 优化助手" |
| **英文** | 50-60 字符 | 靠前 | "Claude Code SEO - Next.js SEO Optimization Assistant" |
**中文示例：**
```typescript
{
title: 'Claude Code SEO - Next.js SEO 优化助手 \u6559\u7A0B' // 28 字符 ✅
}
```
**英文示例：**
```typescript
{
title: 'Claude Code SEO - Complete Next.js SEO Optimization Guide for 2025' // 68 字符 ⚠️ 过长
}
```
---
### Description 描述
| 语言 | 建议长度 | 内容重点 | 示例 |
|------|---------|---------|------|
| **中文** | 70-80 字符 | 核心价值 + 行动号召 | "强大的 Claude Code SEO 插件，为 Next.js 项目提供全面的 SEO 优化支持。立即提升搜索排名！" |
| **英文** | 150-160 字符 | 核心价值 + 行动号召 | "Powerful Claude Code SEO plugin providing comprehensive SEO optimization for Next.js projects. Boost your search rankings today!" |
**中文示例：**
```typescript
{
description: '强大的 Claude Code SEO 插件，为 Next.js 项目提供全面的 SEO 优化支持。自动审计、元数据生成、结构化数据。立即提升排名！' // 75 字符 ✅
}
```
**英文示例：**
```typescript
{
description: 'Powerful Claude Code SEO plugin providing comprehensive SEO optimization for Next.js projects. Features include automated audits, metadata generation, and structured data. Boost your rankings now!' // 185 字符 ⚠️ 过长
}
```
---
### 关键词密度
| 语言 | 建议密度 | 计算方式 | 注意事项 |
|------|---------|---------|---------|
| **中文** | 2-4% | (关键词字数 / 总字数) × 100 | 不要过度堆砌 |
| **英文** | 1-2% | (关键词出现次数 / 总词数) × 100 | 自然融入为主 |
**中文示例：**
```markdown
# SEO 优化（关键词出现 6 次）
SEO 优化是提升网站排名的关键。通过 SEO 优化技术，
可以改善网站在搜索引擎中的表现。SEO 优化包括...
```
**英文示例：**
```markdown
# SEO Optimization (keyword appears 4 times)
SEO optimization is key to improving website rankings.
Through SEO optimization techniques, you can enhance...
```
---
### 标题结构（H1-H6）
| 语言 | 建议层级 | 标题特点 |
|------|---------|---------|
| **中文** | H1-H4 | 通常不需要太深的层级 |
| **英文** | H1-H6 | 可以使用更深的层级 |
**中文结构：**
```markdown
# SEO 优化指南 ← H1
## 什么是 SEO ← H2
### SEO 的重要性 ← H3
#### 如何实施 SEO ← H4（通常到此为止）
```
**英文结构：**
```markdown
# SEO Optimization Guide ← H1
## What is SEO ← H2
### Importance of SEO ← H3
#### How to Implement ← H4
##### Step 1: Audit ← H5
###### Tools to Use ← H6（可以使用更深层级）
```
---
### 搜索引擎差异
| 搜索引擎 | 主要语言 | 特殊要求 | 优化重点 |
|---------|---------|---------|---------|
| **百度** | 中文 | 需要备案 | 国内访问速度、中文内容质量 |
| **搜狗** | 中文 | 微信生态 | 社交信号 |
| **Google** | 通用 | 无特殊要求 | 内容质量、用户体验 |
| **Bing** | 英文 | 无特殊要求 | 社交媒体、域名年龄 |
---
## 🛠️ 多语言网站优化
### hreflang 标签
为多语言网站设置正确的 hreflang：
```typescript
// app/layout.tsx
export const metadata = {
alternates: {
canonical: 'https://example.com',
languages: {
'zh-CN': 'https://example.com/zh',
'en': 'https://example.com/en',
},
},
}
```
### URL 结构建议
```
# 推荐：子目录
/zh/about/
/en/about/
# 或：子域名
zh.example.com/about/
en.example.com/about/
# 避免：URL 参数
/about?lang=zh ← 不推荐
```
---
## 📝 内容优化差异
### 中文内容特点
**优点：**
- ✅ 关键词密度更容易控制
- ✅ 标题长度更灵活
- ✅ 搜索竞争相对较小
**注意：**
- ⚠️ 避免关键词堆砌
- ⚠️ 注意同义词使用
- ⚠️ 关注百度移动优先索引
**示例：**
```markdown
# 优化建议
- 使用"搜索引擎优化"和"SEO"交替出现
- 标题控制在 30 字符以内
- Description 突出核心价值
```
### 英文内容特点
**优点：**
- ✅ 更多的 SEO 工具支持
- ✅ Google 算法更成熟
- ✅ 国际受众更广
**注意：**
- ⚠️ 关键词竞争激烈
- ⚠️ 注意拼写和语法
- ⚠️ 关注搜索意图（Search Intent）
**示例：**
```markdown
# Optimization Tips
- Mix "search engine optimization" and "SEO"
- Keep titles under 60 characters
- Focus on search intent (informational, navigational, transactional)
```
---
## 🔧 实用命令
### 检测语言
```bash
# 自动检测当前项目语言
/seo-check
# 输出会显示检测到的语言
✅ 检测到中文内容 (zh-CN)
```
### 语言特定优化
```bash
# 中文内容优化
/seo-audit # 自动使用中文 SEO 标准
# 英文内容优化
/seo-audit # 自动使用英文 SEO 标准
```
---
## 💡 最佳实践
### 1. 保持语言一致性
```typescript
// ❌ 混合语言
{
title: 'SEO 优化 Guide - Best Practices' // 不推荐
}
// ✅ 纯粹语言
{
title: 'SEO 优化指南 - 最佳实践', // 推荐
}
```
### 2. 使用正确的字符编码
```html
```
### 3. 针对不同搜索引擎优化
**针对百度：**
```typescript
{
// 百度更看重
title: '简洁明确的标题',
description: '详细描述',
keywords: ['关键词1', '关键词2'], // 百度仍关注 keywords
}
```
**针对 Google：**
```typescript
{
// Google 更看重
title: '包含关键词的自然标题',
description: '用户友好的描述',
// Google 忽略 keywords 标签
}
```
---
## 📚 相关资源
### 中文 SEO 资源
- [百度搜索资源平台](https://ziyuan.baidu.com/)
- [百度搜索优化指南](https://ziyuan.baidu.com/college/courseinfo?id=268)
- [搜狗站长平台](http://zhanzhang.sogou.com/)
### 英文 SEO 资源
- [Google Search Central](https://developers.google.com/search)
- [Bing Webmaster Guidelines](https://www.bing.com/webmasters/help/webmaster-guidelines)
- [Moz SEO Guide](https://moz.com/beginners-guide-to-seo)
---
## 🎯 快速参考
| 维度 | 中文 SEO | 英文 SEO |
|------|---------|---------|
| **Title 长度** | 20-30 字符 | 50-60 字符 |
| **Description 长度** | 70-80 字符 | 150-160 字符 |
| **关键词密度** | 2-4% | 1-2% |
| **标题层级** | H1-H4 | H1-H6 |
| **主要搜索引擎** | 百度、搜狗、Google | Google、Bing |
| **特殊要求** | 百度备案 | 无 |
---
**相关文档：**
- [功能特性](features.md) - 所有功能介绍
- [评分系统](scoring-system.md) - 评分标准详解
- [命令参考](commands.md) - 命令使用说明
---
**需要帮助？** 访问 [GitHub Issues](https://github.com/huifer/claude-code-seo/issues)