Ta 8 Content Brief Generate

Step 1: Artikel identifizieren

Lade data/content-plans/priority.json.

Wenn keine Argumente:

• Filtere alle Artikel mit score >= 70 (High Priority) aus allen Clustern
• Filtere Pillar-Artikel heraus (bekommen eigenes Brief in ihrem Cluster-Durchlauf)
• Überspringe Artikel die bereits ein content_brief Objekt im Content-Plan haben
• Zeige Liste:

X High-Priority-Artikel ohne Content Brief gefunden:

| # | Cluster | Artikel | Score | Keyword |
|---|---------|---------|-------|---------|
| 1 | kleinbetriebe | Ist Zeiterfassung Pflicht? | 82 | zeiterfassung pflicht kleinbetriebe |
| 2 | kleinbetriebe | Welche Strafen drohen? | 71 | zeiterfassung strafen |

Alle verarbeiten? (ja | Nummern z.B. "1,2" | cluster-id | cluster-id article-id)

Wenn {cluster-id} angegeben:

• Verarbeite alle High-Priority-Artikel (score >= 70) dieses Clusters

Wenn {cluster-id} {article-id} angegeben:

• Verarbeite genau diesen Artikel (auch wenn score < 70)

Pillar-Artikel:

• Im Batch-Modus: Pillar-Artikel überspringen (ta-10 braucht ein anderes Brief-Format, siehe Step 9)
• Wenn ein Pillar-Artikel explizit per ID angefordert wird: Brief generieren

Skip-Logik: Überspringe Artikel die bereits ein content_brief Objekt im Content-Plan haben. Zeige:

Übersprungen: [Titel] (Brief vom [Datum] vorhanden. --force zum Überschreiben)

Step 2: Daten laden (pro Artikel)

1. Content-Plan: data/content-plans/{cluster-id}.json
   • primary_keyword, secondary_keywords, questions[], article_type, primary_entities[]
2. Q&A-Datenbank: data/qa-database/{cluster-id}.json
   • Lade alle Fragen die im questions Array des Artikels referenziert sind
   • Sammle ai_answer, entities, info_gain_score pro Frage
3. Topical Map: data/topical-authority/topical-map.json
   • questions[] des Clusters (PAA-Fragen als Unique-Gap-Kandidaten)
   • entities[] des Clusters
   • serp_features für das primary_keyword
   • content_gaps[] des Clusters

Step 3: SERP-Daten holen

Rufe DataForSEO auf für das primary_keyword des Artikels:

mcp__dataforseo__serp_organic_live_advanced
- keyword: {primary_keyword}
- language_code: {config.language_code}
- location_name: {config.location_name}
- depth: 10
- people_also_ask_click_depth: 4

Aus den Ergebnissen:

1. Top-10-URLs extrahieren (organische Ergebnisse)
   • Eigene Domain (config.domain) ausschließen
   • Non-Content-URLs ausschließen: /tag/, /category/, /author/, /page/, Social-Media-Domains (reddit.com, quora.com, youtube.com)
2. People Also Ask sammeln — alle PAA-Fragen speichern
3. SERP Features notieren — featured_snippet, paa, ai_overview vorhanden?

Wähle Top 5 URLs aus den verbleibenden organischen Ergebnissen (Rang 1-5).

Step 4: Konkurrenz-Seiten scrapen

Für jede der Top-5-URLs, verwende WebFetch:

WebFetch(url, "Extract the following from this page:
1. All H2 and H3 headings in order
2. All questions answered in the content (explicit questions in headings or implicit questions the text answers)
3. Named entities: people, organizations, laws, dates, statistics, tools mentioned
4. Approximate word count
5. The main topic/angle of the article
Return as structured data.")

Fehlerbehandlung pro URL:

• WebFetch fehlgeschlagen (Timeout, Paywall, JS-heavy): Logge URL als "scrape_failed", weiter mit nächster URL. Minimum 3 von 5 URLs müssen erfolgreich sein.
• Weniger als 3 erfolgreiche Scrapes: Warnung: "Nur X von 5 Konkurrenzseiten konnten analysiert werden. Brief-Qualität eingeschränkt."
• Weniger als 2 erfolgreiche Scrapes: Abbruch für diesen Artikel: "Zu wenige Konkurrenzseiten analysierbar. Überspringe [Titel]."

Thin-Content-Filter: Seiten mit geschätzter Wortanzahl < 300 als "thin_content" markieren und aus der Analyse ausschließen. Wenn dadurch weniger als 3 Seiten übrig: nächste URLs aus Rang 6-10 nachladen.

Step 5: Konkurrenz-Analyse

Für jede erfolgreich gescrapte Seite, strukturiere die Daten:

{
  "url": "https://example.com/article",
  "rank": 1,
  "word_count": 2400,
  "scrape_status": "success",
  "headings": [
    { "level": "h2", "text": "Ist Zeiterfassung Pflicht?" },
    { "level": "h3", "text": "BAG-Urteil 2022" }
  ],
  "questions_answered": [
    "Ist Zeiterfassung für Kleinbetriebe Pflicht?",
    "Welche Strafen drohen bei Verstößen?"
  ],
  "entities_mentioned": [
    { "name": "BAG-Urteil 2022", "type": "legal_reference" },
    { "name": "§ 3 ArbSchG", "type": "legal_reference" }
  ],
  "main_angle": "Rechtliche Pflicht der Zeiterfassung mit Fokus auf Ausnahmen"
}

Step 6: Semantischer Vergleich und Gap-Analyse

6a: Themen-Coverage-Matrix

Erstelle eine Matrix: Welche Themen/Fragen werden von wie vielen Konkurrenten abgedeckt?

| Thema/Frage | Comp. 1 | Comp. 2 | Comp. 3 | Comp. 4 | Comp. 5 | Coverage |
|-------------|:---:|:---:|:---:|:---:|:---:|---------|
| BAG-Urteil Pflicht | x | x | x | x | x | 5/5 |
| Bußgelder/Strafen | x | x | x | - | x | 4/5 |
| Ausnahmen Kleinbetriebe | x | - | x | - | - | 2/5 |
| Digitale vs. manuelle Erfassung | - | - | - | - | - | 0/5 |

Klassifiziere jedes Thema:

• Must-Have (4-5/5): Fast alle Konkurrenten decken es ab — muss im Artikel sein
• Should-Have (2-3/5): Mehrere Konkurrenten decken es ab — starke Empfehlung
• Differentiator (1/5): Nur ein Konkurrent — Chance zur Differenzierung
• Unique Gap (0/5): Kein Konkurrent deckt es ab — HÖCHSTE PRIORITÄT

6b: Unique Content Gap Identifikation (HÖCHSTE PRIORITÄT)

Sammle Unique-Gap-Kandidaten aus drei Quellen:

1. PAA-Fragen die kein Konkurrent beantwortet:

   • Vergleiche PAA-Fragen aus Step 3 mit questions_answered aller Konkurrenten
   • Semantischer Vergleich (nicht nur exakter Match)

2. Q&A-Datenbank-Fragen die kein Konkurrent beantwortet:

   • Vergleiche unsere Fragen aus questions[] des Artikels mit Konkurrenz-Coverage
   • Besonders wertvoll: Fragen mit info_gain_score >= 0.6

3. Themen aus content_gaps[] der Topical Map:

   • Gaps mit our_coverage: false die auch kein Konkurrent abdeckt

Für jeden Unique Gap:

{
  "question": "Gilt die Zeiterfassungspflicht auch für Minijobber?",
  "source": "paa",
  "competitors_covering": 0,
  "confidence": 0.85,
  "reasoning": "PAA-Frage bei Google, keiner der Top 5 beantwortet sie. Hohe Relevanz für Kleinbetriebe mit Minijobbern.",
  "recommended_placement": "Eigene H2-Sektion nach 'Ausnahmen'",
  "estimated_info_gain": "high"
}

Confidence Score (0-1) Berechnung:

• Quelle PAA (Google zeigt es = Nutzer fragen es): +0.3
• Quelle Q&A-DB mit info_gain >= 0.6: +0.3
• Quelle content_gaps mit covered_by_top10 >= 5: +0.2
• Kein Konkurrent beantwortet: +0.3
• 1 Konkurrent beantwortet: +0.1
• Thematische Relevanz zum primary_keyword: +0.1 bis +0.2
• Maximum: 1.0 (Cap)

6c: Entity-Gap-Analyse

Vergleiche Entitäten:

• Unsere Entitäten (aus Q&A-DB + Topical Map primary_entities[])
• Konkurrenz-Entitäten (aus Step 5 entities_mentioned)

Identifiziere:

• Entitäten die Konkurrenz hat aber wir nicht: "Entity Gap" — in Brief aufnehmen
• Entitäten die wir haben aber Konkurrenz nicht: "Entity Advantage" — hervorheben im Outline

Step 7: Recommended Outline generieren

Basierend auf der Analyse, erstelle ein empfohlenes Outline:

Sortierlogik:

1. Einleitung (immer zuerst)
2. Must-Have Themen (4-5/5 Coverage) — für Table Stakes
3. Should-Have Themen (2-3/5 Coverage) — für Vollständigkeit
4. Unique Gap Sektionen — für den entscheidenden Ranking-Vorteil (HÖCHSTE PRIORITÄT)
5. Differentiator-Themen (1/5) — für zusätzlichen Mehrwert
6. Fazit (immer zuletzt)

Für jede Outline-Sektion:

{
  "order": 1,
  "heading": "Ist Zeiterfassung für Kleinbetriebe Pflicht?",
  "heading_level": "h2",
  "category": "must_have",
  "coverage_count": 5,
  "source_question_ids": ["kleinbetriebe-q1", "kleinbetriebe-q3"],
  "key_entities": ["BAG-Urteil 2022", "§ 3 ArbSchG"],
  "competitors_covering": ["example.com", "competitor2.de", "competitor3.de", "competitor4.de", "competitor5.de"],
  "recommended_subsections": [
    {
      "heading": "Seit wann gilt die Pflicht?",
      "heading_level": "h3",
      "category": "must_have"
    }
  ],
  "content_guidance": "BAG-Urteil zitieren, § 3 ArbSchG nennen, Geltungsbereich für Kleinbetriebe explizit klarstellen.",
  "confidence": 0.95
}

Für Unique Gap Sektionen zusätzlich:

{
  "order": 5,
  "heading": "Gilt die Zeiterfassungspflicht auch für Minijobber?",
  "heading_level": "h2",
  "category": "unique_gap",
  "coverage_count": 0,
  "source_question_ids": [],
  "gap_source": "paa",
  "key_entities": ["Minijob-Zentrale", "§ 17 MiLoG"],
  "content_guidance": "Einzigartiger Content — kein Konkurrent beantwortet diese Frage. Recherche zu Minijob-Sonderregelungen nötig. Info Gain Potenzial: hoch.",
  "confidence": 0.85,
  "requires_additional_research": true
}

Step 8: Content Brief validieren

Prüfe das generierte Brief auf Vollständigkeit:

Step 9: Pillar-Brief (wenn Pillar explizit angefordert)

Wenn ein Pillar-Artikel verarbeitet wird, zusätzlich:

• Analysiere Top 5 für das Pillar-Keyword
• Identifiziere welche Themen die Konkurrenz als Übersicht vs. Detail behandelt
• Empfehle welche Cluster-Artikel-Themen im Pillar zusammengefasst werden vs. nur verlinkt
• Markiere Unique-Content-Sektion-Kandidaten (Kontext, Chronologie, Ausblick, Synthese — passend zu ta-10 Step 7b)

Step 10: Speichern

Schreibe content_brief Objekt in den Content-Plan data/content-plans/{cluster-id}.json — am jeweiligen Artikel-Objekt:

Für Cluster-Artikel: im articles[] Array am passenden Artikel Für Pillar: am pillar Objekt

{
  "content_brief": {
    "generated_date": "2026-02-24",
    "primary_keyword": "zeiterfassung pflicht kleinbetriebe",
    "serp_analysis": {
      "competitors_analyzed": 5,
      "competitors_failed": 0,
      "competitors_thin_content": 0,
      "competitor_details": [
        {
          "url": "https://competitor1.de/zeiterfassung-pflicht/",
          "rank": 1,
          "word_count": 2400,
          "scrape_status": "success"
        },
        {
          "url": "https://competitor2.de/arbeitszeiterfassung/",
          "rank": 2,
          "word_count": 1800,
          "scrape_status": "success"
        },
        {
          "url": "https://competitor3.de/zeiterfassung/",
          "rank": 4,
          "word_count": 180,
          "scrape_status": "thin_content"
        },
        {
          "url": "https://competitor4.de/zeiterfassung-gesetz/",
          "rank": 5,
          "word_count": null,
          "scrape_status": "scrape_failed",
          "failure_reason": "timeout"
        }
      ],
      "paa_questions": [
        "Ist Zeiterfassung für Kleinbetriebe Pflicht?",
        "Welche Strafen drohen bei fehlender Zeiterfassung?",
        "Gilt die Zeiterfassungspflicht auch für Minijobber?",
        "Ab wie vielen Mitarbeitern muss Zeiterfassung geführt werden?"
      ],
      "serp_features_detected": {
        "featured_snippet": true,
        "people_also_ask": true,
        "ai_overview": false
      },
      "competitor_word_count_median": 2100
    },
    "coverage_matrix": [
      {
        "topic": "BAG-Urteil und Pflicht",
        "coverage_count": 5,
        "category": "must_have",
        "covered_by": ["competitor1.de", "competitor2.de", "competitor3.de", "competitor4.de", "competitor5.de"]
      },
      {
        "topic": "Bußgelder und Strafen",
        "coverage_count": 4,
        "category": "must_have",
        "covered_by": ["competitor1.de", "competitor2.de", "competitor3.de", "competitor5.de"]
      },
      {
        "topic": "Ausnahmen für Kleinbetriebe",
        "coverage_count": 2,
        "category": "should_have",
        "covered_by": ["competitor1.de", "competitor3.de"]
      },
      {
        "topic": "Minijobber-Regelung",
        "coverage_count": 0,
        "category": "unique_gap",
        "covered_by": []
      }
    ],
    "unique_gaps": [
      {
        "question": "Gilt die Zeiterfassungspflicht auch für Minijobber?",
        "source": "paa",
        "competitors_covering": 0,
        "confidence": 0.85,
        "reasoning": "PAA-Frage bei Google, keiner der Top 5 beantwortet sie.",
        "recommended_placement": "Eigene H2-Sektion nach 'Ausnahmen'",
        "estimated_info_gain": "high"
      },
      {
        "question": "Welche kostenlosen Tools gibt es für die Zeiterfassung im Kleinbetrieb?",
        "source": "qa_db",
        "source_question_id": "kleinbetriebe-q8",
        "competitors_covering": 0,
        "confidence": 0.78,
        "reasoning": "Q&A-DB hat Antwort mit info_gain 0.7. Kein Konkurrent behandelt kostenlose Tools spezifisch.",
        "recommended_placement": "H2-Sektion im How-To-Block",
        "estimated_info_gain": "high"
      }
    ],
    "entity_analysis": {
      "shared_entities": [
        { "name": "BAG-Urteil 2022", "our_coverage": true, "competitor_count": 5 },
        { "name": "§ 3 ArbSchG", "our_coverage": true, "competitor_count": 4 }
      ],
      "entity_gaps": [
        { "name": "EU-Arbeitszeitrichtlinie 2003/88/EG", "competitor_count": 3, "recommendation": "In Sektion 'Rechtlicher Hintergrund' einbauen" }
      ],
      "entity_advantages": [
        { "name": "Minijob-Zentrale", "our_coverage": true, "competitor_count": 0 }
      ]
    },
    "recommended_outline": [
      {
        "order": 1,
        "heading": "Ist Zeiterfassung für Kleinbetriebe Pflicht?",
        "heading_level": "h2",
        "category": "must_have",
        "coverage_count": 5,
        "source_question_ids": ["kleinbetriebe-q1", "kleinbetriebe-q3"],
        "key_entities": ["BAG-Urteil 2022", "§ 3 ArbSchG"],
        "recommended_subsections": [
          { "heading": "Seit wann gilt die Pflicht?", "heading_level": "h3", "category": "must_have" },
          { "heading": "Rechtlicher Hintergrund: EU-Richtlinie und deutsches Recht", "heading_level": "h3", "category": "should_have" }
        ],
        "content_guidance": "BAG-Urteil zitieren, § 3 ArbSchG nennen, EU-Arbeitszeitrichtlinie als Entity Gap einbauen.",
        "confidence": 0.95
      },
      {
        "order": 4,
        "heading": "Gilt die Zeiterfassungspflicht auch für Minijobber?",
        "heading_level": "h2",
        "category": "unique_gap",
        "coverage_count": 0,
        "source_question_ids": [],
        "gap_source": "paa",
        "key_entities": ["Minijob-Zentrale", "§ 17 MiLoG"],
        "content_guidance": "Einzigartiger Content — kein Konkurrent beantwortet diese Frage. Recherche zu Minijob-Sonderregelungen nötig.",
        "confidence": 0.85,
        "requires_additional_research": true
      }
    ],
    "recommended_word_count": 2520,
    "validation": {
      "must_have_covered": true,
      "must_have_total": 3,
      "unique_gaps_found": 2,
      "outline_sections": 6,
      "entity_coverage_pct": 80,
      "low_confidence_sections": 1
    }
  }
}

Aktualisiere last_updated des Content-Plans.

Step 11: Report

=== Content Brief: [Titel] ===

Keyword: [primary_keyword]
Konkurrenz analysiert: [X] von 5 Seiten (Y fehlgeschlagen, Z thin content)
Konkurrenz-Wortanzahl: Median [X], Range [Min]-[Max]

Themen-Coverage:
- Must-Have (4-5/5): X Themen
- Should-Have (2-3/5): X Themen
- Differentiator (1/5): X Themen
- Unique Gaps (0/5): X Themen  <-- HÖCHSTE PRIORITÄT

Top Unique Gaps:
1. "[Frage]" (Confidence: 0.85, Quelle: PAA)
2. "[Frage]" (Confidence: 0.78, Quelle: Q&A-DB, info_gain: 0.7)

Entity-Analyse:
- Gemeinsame Entitäten: [X]
- Entity Gaps (Konkurrenz hat, wir nicht): [Y]
- Entity Advantages (wir haben, Konkurrenz nicht): [Z]

Recommended Outline ([X] H2-Sektionen):
1. [H2] (must_have, 5/5, Confidence: 0.95)
   - [H3]
   - [H3]
2. [H2] (must_have, 4/5, Confidence: 0.90)
3. [H2] (should_have, 3/5, Confidence: 0.80)
4. [H2] *** UNIQUE GAP *** (0/5, Confidence: 0.85)
5. [H2] (differentiator, 1/5, Confidence: 0.70)

Empfohlene Mindest-Wortanzahl: [X] (Median der Konkurrenz + 20%)

Brief gespeichert in: data/content-plans/[cluster].json -> [article-id].content_brief

--- Brief Validation ---
[OK] Must-Have-Themen: 5 von 5 abgedeckt
[OK] Unique Gaps: 2 identifiziert
[OK] Outline-Sektionen: 5 H2
[OK] Entity-Coverage: 80% der Konkurrenz-Entitäten
[INFO] 1 Sektion mit Confidence < 0.7
[INFO] Empfohlene Wortanzahl: 1.800
---

Nächster Schritt:
- /ta-9-content-create-article [cluster] [article-id] -> Artikel mit Content Brief erstellen

Bei Batch-Verarbeitung zusätzlich am Ende:

=== Zusammenfassung ===

[X] Content Briefs generiert
[Y] Artikel übersprungen (Brief vorhanden)
[Z] Artikel fehlgeschlagen (zu wenige Konkurrenzseiten)

Unique Gaps insgesamt: [N]
Top 3 Unique Gaps über alle Artikel:
1. [Cluster/Artikel]: "[Frage]" (Confidence: 0.85)
2. [Cluster/Artikel]: "[Frage]" (Confidence: 0.82)
3. [Cluster/Artikel]: "[Frage]" (Confidence: 0.78)

Re-Run-Verhalten

• Artikel die bereits ein content_brief Objekt im Content-Plan haben, werden übersprungen (Meldung: "Brief vom [Datum] vorhanden")
• Mit --force Flag: Bestehendes Brief wird überschrieben, vorherige Daten gehen verloren
• Bei --force wird eine Warnung angezeigt mit Zusammenfassung der Änderungen: neue/entfernte Unique Gaps, geänderte Coverage-Werte, aktualisierte Outline-Sektionen
• Im Batch-Modus gilt die Skip-Logik pro Artikel — Artikel mit Brief werden einzeln übersprungen, nicht der ganze Batch
• SERP-Daten und Konkurrenz-Scrapes werden bei jedem Lauf neu geholt (keine Caches)

Error Handling

Qualitätskriterien

• Jeder Brief basiert auf mindestens 3 erfolgreich gescrapten Konkurrenzseiten
• Unique Gaps sind tatsächlich einzigartig (nicht semantisch äquivalent zu einem Konkurrenz-Thema)
• Must-Have-Themen (4-5/5 Coverage) sind vollständig im Outline
• Confidence Scores sind nachvollziehbar berechnet (nicht geraten)
• Recommended Outline folgt logischer Lesereihenfolge (allgemein -> spezifisch)
• Entity Gaps und Advantages sind korrekt identifiziert
• Thin-Content-Seiten (< 300 Wörter) werden gefiltert
• Eigene Domain wird aus Konkurrenzanalyse ausgeschlossen
• content_brief Objekt ist valides JSON und folgt dem definierten Schema
• Keine doppelten Themen im Outline
• Pillar-Briefs enthalten Unique-Content-Sektion-Empfehlung
• Alle Confidence Scores liegen zwischen 0.0 und 1.0
• Brief wird direkt am Artikel-Objekt im Content-Plan gespeichert (nicht in separater Datei)
• Empfohlene Wortanzahl = Median der Konkurrenz + 20%