# FAQ Keyword Consistency Guide

**Last Updated:** 2026-01-18

Comprehensive guide for ensuring keyword consistency across blog post content, meta tags, and FAQs.

## Overview

Keyword consistency is critical for SEO performance. Inconsistent keyword variants (e.g., "Zeiterfassung App" vs "Zeiterfassung per App") can confuse search engines and dilute keyword signals.

## Identifying Primary Keyword

### 1. Check JSON File

The primary keyword is defined in the post JSON file:

```json
{
  "primary_keyword": "zeiterfassung app",
  "meta": {
    "title": "Zeiterfassung App: Die besten Lösungen 2026 | Ordio"
  }
}
```

### 2. Check Meta Title

The meta title should use the primary keyword variant (capitalized for display).

### 3. Verify Search Volume

Use SISTRIX data to confirm which variant has higher search volume:
- `docs/content/blog/posts/{category}/{slug}/data/keywords-sistrix.json`

## Common Inconsistencies

### Example: "Zeiterfassung App" vs "Zeiterfassung per App"

**Problem:**
- Primary keyword: `"zeiterfassung app"` (without "per")
- Meta title: `"Zeiterfassung App"` (without "per")
- FAQs: Use `"Zeiterfassung per App"` (with "per")

**Solution:**
- Standardize on primary keyword variant: `"Zeiterfassung App"` (without "per")
- Update all FAQs to use consistent variant

## Consistency Checklist

### Before Finalizing FAQs

- [ ] Primary keyword matches across:
  - [ ] JSON `primary_keyword` field
  - [ ] Meta title
  - [ ] Meta description
  - [ ] Content HTML (H1, H2 headings)
  - [ ] FAQ questions (3-5 FAQs)
  - [ ] FAQ answers (where natural)

- [ ] No inconsistent variants:
  - [ ] Check for "per App" vs "App"
  - [ ] Check for "mit App" vs "App"
  - [ ] Check for other variations

- [ ] Keyword integration is natural:
  - [ ] Not forced or stuffed
  - [ ] Reads naturally in German
  - [ ] Maintains grammatical correctness

## Review Process

### Step 1: Identify Primary Keyword

```bash
# Check JSON file
cat v2/data/blog/posts/{category}/{slug}.json | grep -A 2 "primary_keyword"
```

### Step 2: Check Consistency

```bash
# Search for keyword variants in FAQs
grep -n "per App\|mit App\|App" v2/data/blog/posts/{category}/{slug}.json
```

### Step 3: Standardize

- Update all FAQ questions to use primary keyword variant
- Update all FAQ answers to use primary keyword variant
- Verify meta title uses primary keyword variant

### Step 4: Validate

```bash
# Run keyword consistency check
python3 -c "
import json
import re

with open('v2/data/blog/posts/{category}/{slug}.json', 'r') as f:
    data = json.load(f)

primary_keyword = data.get('primary_keyword', '')
faqs = data.get('faqs', [])

# Count occurrences
per_app_count = 0
app_count = 0

for faq in faqs:
    q = faq.get('question', '') + ' ' + faq.get('answer', '')
    if 'per App' in q:
        per_app_count += 1
    if 'App' in q and 'per' not in q:
        app_count += 1

print(f'Primary keyword: {primary_keyword}')
print(f'\"per App\" occurrences: {per_app_count}')
print(f'\"App\" occurrences: {app_count}')
"
```

## Best Practices

### 1. Use Primary Keyword Consistently

- Always use the primary keyword variant defined in JSON
- Don't mix variants (e.g., don't use "per App" in FAQs if primary is "App")

### 2. Natural Integration

- Integrate keyword naturally in 3-5 FAQs
- Don't force keyword into every FAQ
- Maintain grammatical correctness

### 3. Variations Are Acceptable

- Natural variations are acceptable (e.g., "Zeiterfassungs-App" with hyphen)
- But avoid major variants (e.g., "per App" vs "App")

### 4. Review After Expansion

- Always check keyword consistency after FAQ expansion
- Run analysis tools to identify inconsistencies
- Fix before finalizing post

## Tools

### Analysis Scripts

- `analyze-faqs-seo.php` - Identifies keyword usage in FAQs
- `check-faq-uniqueness.php` - Checks for duplicate questions
- `suggest-faq-improvements.php` - Suggests keyword integration opportunities

### Manual Review

- Review JSON file for primary keyword
- Review meta title for consistency
- Review all FAQs for keyword variants
- Use grep to find inconsistencies

## Common Mistakes

### ❌ Mistake 1: Mixing Variants

**Wrong:**
- Primary keyword: `"zeiterfassung app"`
- FAQs use: `"Zeiterfassung per App"`

**Correct:**
- Primary keyword: `"zeiterfassung app"`
- FAQs use: `"Zeiterfassung App"`

### ❌ Mistake 2: Forcing Keyword

**Wrong:**
- Every FAQ contains primary keyword

**Correct:**
- Primary keyword in 3-5 FAQs naturally

### ❌ Mistake 3: Ignoring Meta Title

**Wrong:**
- Meta title uses different variant than primary keyword

**Correct:**
- Meta title uses primary keyword variant (capitalized)

## Success Criteria

Before marking FAQ review as complete:

- ✅ Primary keyword consistent across all content
- ✅ No inconsistent variants found
- ✅ Keyword in 3-5 FAQs naturally
- ✅ Meta title uses primary keyword variant
- ✅ All FAQs use consistent variant

## Related Documentation

- `docs/content/blog/FAQ_MANUAL_REVIEW_SEO_CHECKLIST.md` - Complete FAQ review checklist
- `docs/content/blog/BLOG_POST_IMPROVEMENT_PROCESS.md` - Blog post improvement process
- `.cursor/rules/blog-improvement-process.mdc` - Cursor rules for blog improvement