354 lines
7.9 KiB
Markdown
354 lines
7.9 KiB
Markdown
# 双语支持
|
||
|
||
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
|
||
<html lang="zh-CN"> <!-- 中文 -->
|
||
<html lang="en"> <!-- 英文 -->
|
||
```
|
||
|
||
### 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
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta http-equiv="Content-Language" content="zh-CN">
|
||
</head>
|
||
```
|
||
|
||
### 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)
|