7.9 KiB
7.9 KiB
双语支持
Claude Code SEO Assistant 原生支持中文和英文两种语言，提供差异化的 SEO 优化建议。
🌏 支持的语言
🇨🇳 简体中文（zh-CN）
- 主要搜索引擎： 百度、搜狗、Google
- 字符集： UTF-8
- 标点符号： 中文标点
🇺🇸 英语（en-US）
- 主要搜索引擎： Google、Bing
- 字符集： UTF-8
- 标点符号： 英文标点
🔍 自动语言检测
工具会自动检测内容语言，使用以下方法：
1. 中文字符比例分析
// 检测逻辑
const chineseCharRatio = (chineseChars / totalChars) * 100;
if (chineseCharRatio > 30%) {
language = 'zh-CN';
} else {
language = 'en-US';
}
2. HTML lang 属性
<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" |
中文示例：
{
title: 'Claude Code SEO - Next.js SEO 优化助手 \u6559\u7A0B' // 28 字符 ✅
}
英文示例：
{
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!" |
中文示例：
{
description: '强大的 Claude Code SEO 插件，为 Next.js 项目提供全面的 SEO 优化支持。自动审计、元数据生成、结构化数据。立即提升排名！' // 75 字符 ✅
}
英文示例：
{
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 | 自然融入为主 |
中文示例：
# SEO 优化（关键词出现 6 次）
SEO 优化是提升网站排名的关键。通过 SEO 优化技术，
可以改善网站在搜索引擎中的表现。SEO 优化包括...
英文示例：
# 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 | 可以使用更深的层级 |
中文结构：
# SEO 优化指南 ← H1
## 什么是 SEO ← H2
### SEO 的重要性 ← H3
#### 如何实施 SEO ← H4（通常到此为止）
英文结构：
# SEO Optimization Guide ← H1
## What is SEO ← H2
### Importance of SEO ← H3
#### How to Implement ← H4
##### Step 1: Audit ← H5
###### Tools to Use ← H6（可以使用更深层级）
搜索引擎差异
| 搜索引擎 | 主要语言 | 特殊要求 | 优化重点 |
|---|---|---|---|
| 百度 | 中文 | 需要备案 | 国内访问速度、中文内容质量 |
| 搜狗 | 中文 | 微信生态 | 社交信号 |
| 通用 | 无特殊要求 | 内容质量、用户体验 | |
| Bing | 英文 | 无特殊要求 | 社交媒体、域名年龄 |
🛠️ 多语言网站优化
hreflang 标签
为多语言网站设置正确的 hreflang：
// 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 ← 不推荐
📝 内容优化差异
中文内容特点
优点：
- ✅ 关键词密度更容易控制
- ✅ 标题长度更灵活
- ✅ 搜索竞争相对较小
注意：
- ⚠️ 避免关键词堆砌
- ⚠️ 注意同义词使用
- ⚠️ 关注百度移动优先索引
示例：
# 优化建议
- 使用"搜索引擎优化"和"SEO"交替出现
- 标题控制在 30 字符以内
- Description 突出核心价值
英文内容特点
优点：
- ✅ 更多的 SEO 工具支持
- ✅ Google 算法更成熟
- ✅ 国际受众更广
注意：
- ⚠️ 关键词竞争激烈
- ⚠️ 注意拼写和语法
- ⚠️ 关注搜索意图（Search Intent）
示例：
# Optimization Tips
- Mix "search engine optimization" and "SEO"
- Keep titles under 60 characters
- Focus on search intent (informational, navigational, transactional)
🔧 实用命令
检测语言
# 自动检测当前项目语言
/seo-check
# 输出会显示检测到的语言
✅ 检测到中文内容 (zh-CN)
语言特定优化
# 中文内容优化
/seo-audit # 自动使用中文 SEO 标准
# 英文内容优化
/seo-audit # 自动使用英文 SEO 标准
💡 最佳实践
1. 保持语言一致性
// ❌ 混合语言
{
title: 'SEO 优化 Guide - Best Practices' // 不推荐
}
// ✅ 纯粹语言
{
title: 'SEO 优化指南 - 最佳实践', // 推荐
}
2. 使用正确的字符编码
<head>
<meta charset="UTF-8">
<meta http-equiv="Content-Language" content="zh-CN">
</head>
3. 针对不同搜索引擎优化
针对百度：
{
// 百度更看重
title: '简洁明确的标题',
description: '详细描述',
keywords: ['关键词1', '关键词2'], // 百度仍关注 keywords
}
针对 Google：
{
// Google 更看重
title: '包含关键词的自然标题',
description: '用户友好的描述',
// Google 忽略 keywords 标签
}
📚 相关资源
中文 SEO 资源
英文 SEO 资源
🎯 快速参考
| 维度 | 中文 SEO | 英文 SEO |
|---|---|---|
| Title 长度 | 20-30 字符 | 50-60 字符 |
| Description 长度 | 70-80 字符 | 150-160 字符 |
| 关键词密度 | 2-4% | 1-2% |
| 标题层级 | H1-H4 | H1-H6 |
| 主要搜索引擎 | 百度、搜狗、Google | Google、Bing |
| 特殊要求 | 百度备案 | 无 |
相关文档：
需要帮助？ 访问 GitHub Issues