seo-content-optimization

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SEO Content Optimization

SEO内容优化

Optimize page content for target keywords to rank on Google.
针对目标关键词优化页面内容,以在Google上获得排名。

Prerequisites

前提条件

  • docs/seo-analysis.md must exist with keyword targets (run
    /00_seo-research
    first)
  • Page must be built (sections installed, i18n added)
  • docs/seo-analysis.md文件必须存在且包含目标关键词(需先运行
    /00_seo-research
  • 页面已构建完成(已安装页面板块、添加i18n支持)

Workflow

工作流程

  1. Read SEO Analysis - Get target keywords for this page from docs/seo-analysis.md
  2. Analyze Current Content - Review existing page, text in components and i18n files
  3. Optimize H1 - Ensure primary keyword is in H1 (naturally)
  4. Optimize Headings - Include keywords in H2/H3 where relevant
  5. Optimize Body Text - Integrate keywords naturally (max. 0.8% density)
  6. Optimize Meta - Title tag and meta description with keywords
  7. Update i18n - Apply changes to de.json and en.json
  1. 读取SEO分析文档 - 从docs/seo-analysis.md中获取当前页面的目标关键词
  2. 分析现有内容 - 检查现有页面、组件文本及i18n文件中的内容
  3. 优化H1标题 - 确保主关键词自然融入H1标题
  4. 优化次级标题 - 在相关的H2/H3标题中加入关键词
  5. 优化正文文本 - 自然融入关键词(关键词密度最高0.8%)
  6. 优化Meta标签 - 为标题标签和Meta描述添加关键词
  7. 更新i18n文件 - 将修改应用到de.json和en.json文件

Reading docs/seo-analysis.md

读取docs/seo-analysis.md文件

The SEO analysis file contains per-page optimization guides. For each page, find:
SEO分析文件包含按页面划分的优化指南。针对每个页面,需找到以下内容:

Location in File

文件中的位置

markdown
undefined
markdown
undefined

Per-Page Optimization Guide

Per-Page Optimization Guide

[Page Name]
/[route]

[Page Name]
/[route]

Primary Keyword: [keyword] Search Intent: [intent]
ElementRecommendation
Title (50-60 chars)[recommendation]
Meta Description (150-160 chars)[recommendation]
H1[recommendation]
H2 Topics[list of H2s]
Keyword Density[target]
Internal Links[pages to link]
Secondary Keywords to Include:
  • [keyword 1] - use in [section]
  • [keyword 2] - use in [section]
undefined
Primary Keyword: [keyword] Search Intent: [intent]
ElementRecommendation
Title (50-60 chars)[recommendation]
Meta Description (150-160 chars)[recommendation]
H1[recommendation]
H2 Topics[list of H2s]
Keyword Density[target]
Internal Links[pages to link]
Secondary Keywords to Include:
  • [keyword 1] - use in [section]
  • [keyword 2] - use in [section]
undefined

What to Extract

需要提取的内容

For the page you're optimizing, note:
  1. Primary Keyword - Must be in H1 and title
  2. Title Recommendation - Use for meta title (50-60 chars)
  3. Meta Description Recommendation - Use for meta description (150-160 chars)
  4. H1 Recommendation - The actual H1 text to use
  5. H2 Topics - What H2 headings should cover
  6. Secondary Keywords - Where to use them in content
  7. Semantic Keywords - From the "Semantic Keywords (LSI)" section
针对当前正在优化的页面,需记录:
  1. 主关键词 - 必须出现在H1标题和页面标题中
  2. 标题建议 - 用于设置Meta标题(长度50-60字符)
  3. Meta描述建议 - 用于设置Meta描述(长度150-160字符)
  4. H1建议 - 需使用的H1文本内容
  5. H2主题 - H2标题应涵盖的主题
  6. 次要关键词 - 需在哪些内容板块中使用
  7. 语义关键词 - 来自“Semantic Keywords (LSI)”板块的内容

Keyword Integration Rules

关键词整合规则

DO:
  • Place primary keyword in H1 (required)
  • Include keyword in first 100 words
  • Use keyword variations and synonyms
  • Write naturally for humans first
  • Use keywords in image alt text
  • Follow the specific recommendations from seo-analysis.md
DON'T:
  • Keyword stuff (max. 0.8% density)
  • Force unnatural phrasing
  • Repeat exact keyword excessively
  • Sacrifice readability for SEO
建议做法:
  • 将主关键词放在H1标题中(必填)
  • 在前100个词中加入关键词
  • 使用关键词变体和同义词
  • 优先为人类读者创作自然的内容
  • 在图片替代文本中加入关键词
  • 遵循seo-analysis.md中的具体建议
禁止做法:
  • 关键词堆砌(密度最高0.8%)
  • 强行使用不自然的表述
  • 过度重复完全相同的关键词
  • 为了SEO牺牲内容可读性

Content Optimization Checklist

内容优化检查清单

H1 (Most Important)

H1标题(最重要)

  • Contains primary keyword from seo-analysis.md
  • Matches or adapts the H1 recommendation
  • Compelling and clear
  • Only ONE H1 per page
  • Different from meta title (can be similar)
  • 包含seo-analysis.md中的主关键词
  • 匹配或适配H1建议内容
  • 引人注目且清晰明确
  • 每页仅设置一个H1标题
  • 与Meta标题有所区别(可相似)

H2 Headings

H2标题

  • Cover the H2 Topics listed in seo-analysis.md
  • Include secondary keywords where natural
  • Describe section content accurately
  • Use question format for FAQ keywords
  • 涵盖seo-analysis.md中列出的H2主题
  • 在自然的情况下加入次要关键词
  • 准确描述板块内容
  • 针对FAQ类关键词使用问句格式

Body Text

正文文本

  • Keyword in first paragraph
  • Natural keyword variations throughout
  • Semantic keywords (LSI) from seo-analysis.md included
  • Minimum 300 words per major section
  • 第一段包含关键词
  • 全文自然分布关键词变体
  • 加入seo-analysis.md中的语义关键词(LSI)
  • 每个主要板块至少300词

Meta Title (50-60 chars)

Meta标题(50-60字符)

Use the Title recommendation from seo-analysis.md, or follow this format:
[Primary Keyword] | [Brand] - [Benefit]
Example:
Webdesign Zürich | Local Studios - Professionelle Websites
使用seo-analysis.md中的标题建议,或遵循以下格式:
[主关键词] | [品牌] - [核心价值]
示例:
Webdesign Zürich | Local Studios - Professionelle Websites

Meta Description (150-160 chars)

Meta描述(150-160字符)

Use the Meta Description recommendation from seo-analysis.md, or follow this format:
[What you offer] + [Unique value] + [CTA]
Example:
Professionelles Webdesign in Zürich für KMUs. Handcodierte Websites ab CHF 100/Monat. Jetzt kostenloses Erstgespräch vereinbaren.
使用seo-analysis.md中的Meta描述建议,或遵循以下格式:
[提供的服务] + [独特价值] + [行动号召]
示例:
Professionelles Webdesign in Zürich für KMUs. Handcodierte Websites ab CHF 100/Monat. Jetzt kostenloses Erstgespräch vereinbaren.

Image Alt Text

图片替代文本

  • Descriptive and keyword-relevant
  • Not keyword-stuffed
  • Describes actual image content
  • 描述性强且与关键词相关
  • 不堆砌关键词
  • 准确描述图片实际内容

Example Optimization

优化示例

Step 1: Read seo-analysis.md for Homepage

步骤1:读取首页的seo-analysis.md内容

markdown
undefined
markdown
undefined

Homepage
/

Homepage
/

Primary Keyword: Webdesign Zürich Search Intent: Transactional/Navigational
ElementRecommendation
Title (50-60 chars)Webdesign Zürich - Local Studios - Professionelle Websites
Meta Description (150-160 chars)Professionelles Webdesign in Zürich für KMUs. Handcodierte Websites ab CHF 100/Monat. Jetzt kostenloses Erstgespräch vereinbaren.
H1Webdesign Zürich für KMUs
H2 TopicsUnsere Leistungen, Warum wir, Preise, Kundenstimmen
Secondary Keywords to Include:
  • "Website erstellen lassen" - use in services section
  • "Webdesign Agentur" - use in about section
undefined
Primary Keyword: Webdesign Zürich Search Intent: Transactional/Navigational
ElementRecommendation
Title (50-60 chars)Webdesign Zürich - Local Studios - Professionelle Websites
Meta Description (150-160 chars)Professionelles Webdesign in Zürich für KMUs. Handcodierte Websites ab CHF 100/Monat. Jetzt kostenloses Erstgespräch vereinbaren.
H1Webdesign Zürich für KMUs
H2 TopicsUnsere Leistungen, Warum wir, Preise, Kundenstimmen
Secondary Keywords to Include:
  • "Website erstellen lassen" - use in services section
  • "Webdesign Agentur" - use in about section
undefined

Step 2: Update i18n

步骤2:更新i18n文件

Before (generic):
json
{
  "hero": {
    "title": "Willkommen bei uns",
    "subtitle": "Wir erstellen Websites"
  }
}
After (SEO-optimized using seo-analysis.md):
json
{
  "hero": {
    "title": "Webdesign Zürich für KMUs",
    "subtitle": "Professionelle Websites, die Kunden bringen. Handcodiert, schnell, SEO-optimiert."
  }
}
优化前(通用内容):
json
{
  "hero": {
    "title": "Willkommen bei uns",
    "subtitle": "Wir erstellen Websites"
  }
}
优化后(基于seo-analysis.md的SEO优化内容):
json
{
  "hero": {
    "title": "Webdesign Zürich für KMUs",
    "subtitle": "Professionelle Websites, die Kunden bringen. Handcodiert, schnell, SEO-optimiert."
  }
}

Keyword Density Check

关键词密度检查

Target: max. 0.8% keyword density
Formula:
(keyword count / total words) × 100
For a 500-word page targeting "Webdesign Zürich":
  • Max occurrences = 0.008 × 500 = 4 times
  • Use variations and synonyms to avoid stuffing:
  • Include variations: "Webdesign in Zürich", "Zürcher Webdesign", "Website Zürich"
目标:最高0.8%的关键词密度
计算公式:
(关键词出现次数 / 总词数) × 100
对于一篇500词、以"Webdesign Zürich"为目标关键词的页面:
  • 最大出现次数 = 0.008 × 500 = 4次
  • 使用关键词变体和同义词避免堆砌:
  • 可使用变体:"Webdesign in Zürich", "Zürcher Webdesign", "Website Zürich"

Output

输出结果

  • Updated messages/de.json with SEO-optimized text
  • Updated messages/en.json with SEO-optimized text
  • Meta title and description for the page
  • All headings optimized for keywords per seo-analysis.md recommendations
  • 经过SEO优化的messages/de.json文本
  • 经过SEO优化的messages/en.json文本
  • 页面的Meta标题和描述
  • 所有标题均已根据seo-analysis.md的建议完成关键词优化