SEO Content Optimization

Optimize page content for target keywords to rank on Google.

Prerequisites

• docs/seo-analysis.md must exist with keyword targets (run /00_seo-research first)

• Page must be built (sections installed, i18n added)

Workflow

• Read SEO Analysis - Get target keywords for this page from docs/seo-analysis.md

• Analyze Current Content - Review existing page, text in components and i18n files

• Optimize H1 - Ensure primary keyword is in H1 (naturally)

• Optimize Headings - Include keywords in H2/H3 where relevant

• Optimize Body Text - Integrate keywords naturally (max. 0.8% density)

• Optimize Meta - Title tag and meta description with keywords

• Update i18n - Apply changes to de.json and en.json

Reading docs/seo-analysis.md

The SEO analysis file contains per-page optimization guides. For each page, find:

Location in File

Per-Page Optimization Guide

[Page Name] /[route]

Primary Keyword: [keyword] Search Intent: [intent]

Secondary Keywords to Include:

• [keyword 1] - use in [section]
• [keyword 2] - use in [section]

What to Extract

For the page you're optimizing, note:

• Primary Keyword - Must be in H1 and title

• Title Recommendation - Use for meta title (50-60 chars)

• Meta Description Recommendation - Use for meta description (150-160 chars)

• H1 Recommendation - The actual H1 text to use

• H2 Topics - What H2 headings should cover

• Secondary Keywords - Where to use them in content

• Semantic Keywords - From the "Semantic Keywords (LSI)" section

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

Content Optimization Checklist

H1 (Most Important)

• 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)

H2 Headings

• Cover the H2 Topics listed in seo-analysis.md

• Include secondary keywords where natural

• Describe section content accurately

• Use question format for FAQ keywords

Body Text

• Keyword in first paragraph

• Natural keyword variations throughout

• Semantic keywords (LSI) from seo-analysis.md included

• Minimum 300 words per major section

Meta Title (50-60 chars)

Use the Title recommendation from seo-analysis.md, or follow this format:

[Primary Keyword] | [Brand] - [Benefit]

Example: Webdesign Zürich | Local Studios - Professionelle Websites

Meta Description (150-160 chars)

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.

Image Alt Text

• Descriptive and keyword-relevant

• Not keyword-stuffed

• Describes actual image content

Example Optimization

Step 1: Read seo-analysis.md for Homepage

Homepage /

Primary Keyword: Webdesign Zürich Search Intent: Transactional/Navigational

Secondary Keywords to Include:

• "Website erstellen lassen" - use in services section
• "Webdesign Agentur" - use in about section

Step 2: Update i18n

Before (generic):

{ "hero": { "title": "Willkommen bei uns", "subtitle": "Wir erstellen Websites" } }

After (SEO-optimized using seo-analysis.md):

{ "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"

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