TheMattBerman/landing-page-factory

Site Extract

Verwenden Sie dies, wenn ein Benutzer eine Website-URL angibt und eine Landing Page ohne aufwändigen Intake-Prozess erstellen möchte.

Diese Stufe synthetisiert nicht. Sie extrahiert.

Wenn Sie eine Behauptung, ein Beweispunkt oder ein Vertrauenssignal nicht auf die Quelle zurückverfolgen können, kennzeichnen Sie es als fehlend oder abgeleitet. Stufen Sie es nicht stillschweigend zu einer Tatsache hoch.

Erforderliche Eingaben

• primäre URL
• optionale Produkt-URL
• optionales --deep
• optionale manuelle Kurzbeschreibungen, wenn der Quellzugriff unvollständig ist

Operatorziel

Erstellen Sie einen Quellendatensatz, dem nachgelagerte Skills vertrauen können.

Das bedeutet, extrahieren Sie:

• exakte Behauptungssprache
• exakte CTA-Sprache
• exakte Beweispunkte
• sichtbare Seitenmuster
• Mechanismensprache
• Vertrauenssignale
• visuelle Identität
• Kategoriekonventionen

Ausgabedateien

Schreiben Sie:

• workspace/brand/extract.md
• workspace/brand/extract.json
• workspace/brand/palette.json

Strenge Extraktionsregeln

1. Bewahren Sie nach Möglichkeit die genaue Sprache. Zitieren Sie, paraphrasieren Sie nicht.
2. Kennzeichnen Sie die Herkunft für jedes Beweiselement und jede wichtige Behauptung.
3. Unterscheiden Sie beobachtete Fakten von Schlussfolgerungen.
4. Wenn das Quellsignal dünn ist, sagen Sie es direkt.
5. Wenn der Mechanismus nach der Extraktion unklar bleibt, muss die nachgelagerte Strategie anhalten, bis das Problem gelöst ist.

Erforderliche Extraktionsstruktur

# Brand Extract: [Marke]
Quell-URLs:
- [url 1]
- [url 2]
Extrahiert: [Datum]
Vertrauensniveau: hoch | mittel | niedrig

## 1. Marke + Kategorie
- Markenname:
- Produktkategorie:
- Primäres Angebot:
- Geschäftsmodell:
- Geografie / Markthinweise:

## 2. Exakte Hero-Sprache
| Element | Exakter Text | Quell-URL | Herkunft |
|---|---|---|---|
| Überschrift | | | beobachtet |
| Unterüberschrift | | | beobachtet |
| Primärer CTA | | | beobachtet |
| Sekundärer CTA | | | beobachtet |

## 3. Behauptungsinventar
| Behauptung | Typ | Quell-URL | Abschnitt | Herkunft | Beweis erforderlich? |
|---|---|---|---|---|---|
|  | Nutzen / Mechanismus / Überlegenheit / Sozialer Beweis / Garantie | | | beobachtet / abgeleitet | ja / nein |

## 4. Beweisinventar
| Beweiselement | Klasse | Genaue Formulierung / Wert | Quell-URL | Abschnitt | Anmerkungen |
|---|---|---|---|---|---|
|  | Erfahrungsbericht / Statistik / Bewertungsanzahl / Logo / Presse / Garantie | verified_source / derived_source / missing | | | | |

## 5. CTA-Inventar
| CTA-Text | Ziel-Vermutung | Quell-URL | Oberhalb der Falte? | Anmerkungen |
|---|---|---|---|---|

## 6. Mechanismensprach-Inventar
- Einzigartige Mechanismusphrasen, die von der Marke wiederholt werden
- Produkterklärungsphrasen, die es wert sind, erhalten zu bleiben
- Sprache gescheiterter Alternativen
- Einwandbehandlungssprache

## 7. Vertrauenssignal-Inventar
- Garantien
- Versand / Rückgaben / Garantie
- Zertifizierungen / Presse / Logos
- Compliance / Sicherheit / Autoritätssignale
- Kategoriekonventionen, die Legitimität signalisieren

## 8. Seitenmuster-Inventar
| Abschnittsreihenfolge | Was erscheint | Was es tut | Erhaltenswert? |
|---|---|---|---|

## 9. Visuelles Motiv-Inventar
- dominante Farben
- Schriftfamilien / -klassen
- Produktfotografiestil
- UI / Screenshot-Stil, falls vorhanden
- Formensprache
- Dichte / Abstandsgefühl
- Vertrauenskritische Designkonventionen

## 10. Zielgruppensignale
- wer scheint angesprochen zu werden
- Hinweise auf das Bewusstseinsniveau
- Hinweise auf den Kenntnisstand
- explizite Schmerzenssprache
- explizite Wunschsprache

## 11. Fehlende / schwache Bereiche
- fehlende Mechanismusdetails
- nicht unterstützte Behauptungen
- dünne Beweise
- nicht zugängliche Seiten
- alles, was eine Operator-Entscheidung erfordert

JSON-Vertrag

extract.json muss maschinenlesbare Schlüssel enthalten für:

• brand
• category
• offer
• hero_language
• claims[]
• proof_inventory[]
• cta_inventory[]
• mechanism_language[]
• trust_cues[]
• page_patterns[]
• visual_motifs[]
• audience_signals[]
• missing_flags[]
• confidence

Firecrawl-Integration

Die Auswahl des Anbieters ist hier obligatorisch.

Wenn FIRECRAWL_API_KEY verfügbar ist, MÜSSEN Sie Firecrawl für die Site-Extraktion verwenden. Ersetzen Sie Firecrawl nicht stillschweigend durch generisches Browsen, WebFetch oder Single-Page-Scraping, wenn Firecrawl konfiguriert oder erwartet wird.

Wenn Firecrawl von der Laufzeitumgebung blockiert, nicht verfügbar oder der Schlüssel fehlt:

1. sagen Sie dies explizit
2. fragen Sie den Operator, ob:
   • Firecrawl bereitgestellt/konfiguriert werden soll
   • der lokale Firecrawl-Extraktionsbefehl außerhalb der Sandbox ausgeführt werden soll
   • eine herabgestufte manuelle/basische Extraktion akzeptiert werden soll
3. Fahren Sie nicht stillschweigend mit einer herabgestuften Extraktion für einen Release-Qualitäts-Durchlauf fort.

Verwenden Sie eine herabgestufte Extraktion nur ohne Nachfrage, wenn der Benutzer diese Herabstufung bereits explizit genehmigt hat.

Wenn Firecrawl verfügbar ist, verwenden Sie die v2-API mit dem branding-Format:

curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "formats": ["branding", "markdown", "screenshot"],
    "onlyMainContent": false,
    "maxAge": 172800000
  }'

Das branding-Format gibt eine strukturierte Markenidentität zurück:

• Logo-URL
• Farbpalette (primär, sekundär, Akzent, Hintergrund, Text)
• Schriftfamilien
• Abstandsskala
• UI-Komponentenstile
• Farbschema (hell/dunkel)

Das markdown-Format liefert Seiteninhalt zur Extraktion von Behauptungen und Beweisen. Das screenshot-Format liefert eine visuelle Referenz (URL läuft nach 24h ab).

Verwenden Sie scripts/firecrawl-extract.sh, um dies automatisch auszuführen und alle Ausgaben zu speichern.

Deep-Modus

Wenn --deep verwendet wird:

1. Scrapen Sie die Startseite
2. Scrapen Sie eine Produkt-/Dienstleistungsseite
3. Scrapen Sie eine beweislastige Seite, falls verfügbar
4. Scrapen Sie Preisseiten, FAQ- oder Über-uns-Seiten, falls verfügbar
5. Führen Sie die Ergebnisse mit Quell-URLs zusammen, die an jedes Artefakt angehängt werden

Standardmäßige Deep-Priorität:

• Produktseite
• Bewertungs-/Testimonial-Seite
• FAQ-/Preisseite
• Über-uns-Seite

Fallback-Verhalten

Wenn Firecrawl oder das Scraping fehlschlägt:

• erfassen Sie, was zugänglich ist
• markieren Sie blockierte Abschnitte explizit
• fordern Sie vom Operator Screenshots oder Text für fehlende Vertrauens-/Beweis-/Mechanismusdaten an
• erfinden Sie keine extrahierte Struktur, als ob sie beobachtet worden wäre

Wenn Firecrawl von Cowork oder einem anderen Sandbox-Proxy blockiert wird:

• geben Sie an, dass api.firecrawl.dev von der Laufzeitumgebung erlaubt sein muss
• empfehlen Sie den lokalen Preflight-Befehlspfad, anstatt so zu tun, als sei WebFetch gleichwertig

Stop-/Continue-Logik

Fortfahren, wenn:

• das Angebot identifizierbar ist
• der CTA ableitbar ist
• zumindest einige Beweise oder Vertrauenssignale extrahierbar sind

Herabstufen, wenn:

• Beweise schwach sind
• die visuelle Identität unvollständig ist
• Kategoriekonventionen unklar sind

Anhalten und Operator benachrichtigen, wenn:

• ein einzigartiger Mechanismus nicht identifiziert werden kann
• die Quelle zu dünn ist, um echte Behauptungen von Marketingnebel zu unterscheiden
• regulierte Behauptungen ohne klaren Beweis erscheinen

Übergabe

Nach der Extraktion führen Sie /page-strategy aus.

Springen Sie nicht direkt zum Copy, es sei denn, das Strategie-Artefakt existiert bereits.