Communitygithub.com

Web Blueprint Generator

Verwandelt die Hypothesen des local-seo-pattern-aggregator in einen Web-Blueprint – URL-Architektur, JSON-LD-Schema pro Seitentyp, wiederkehrende Abschnitte, Überschriften und einen internen Verlinkungsplan. Er ist der Bauplan, bevor Seiten generiert werden.

Was ist Web Blueprint Generator?

Der Web Blueprint Generator ist eine zentrale Skill der YinyangSEO Academy (Klasse 1), die auf den Ergebnissen des local-seo-pattern-aggregator aufbaut. Seine Aufgabe ist es, aus den erkannten Suchmustern und lokalen SEO-Hypothesen einen detaillierten Bauplan für eine gesamte Website zu erstellen. Dieser Plan umfasst die vollständige URL-Architektur, spezifische JSON-LD-Schema-Vorlagen für jeden Seitentyp (z. B. Startseite, Dienstleistungsseite, lokale Landingpage), ein Muster für wiederkehrende Abschnitte, Überschriften und einen vollständigen internen Verlinkungsplan. Der Blueprint dient als verbindliche Vorlage für den nachgelagerten `landing-generator-servicio-barrio`, der die eigentlichen Seiten generiert. Er wird immer dann eingesetzt, wenn der Benutzer nach einer Architektur, Seitenstruktur oder einem Blueprint für ein Keyword fragt. Der Output besteht aus Dateien wie `url-map.yaml`, Seitenvorlagen und Schema-Vorlagen im Ordner `blueprint/{negocio-slug}/` und ist direkt für die automatisierte Generierung und Qualitätssicherung bereit.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Freskan23/clase-1-agentes-ia-webs/tree/HEAD/03-skills/web-blueprint-generator

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

📚 Itinerario YinyangSEO Academy · Klasse 1 — Agentsgestützte Websites und effizientes SEO. Diese Skill ist Teil des Repos von Klasse 1. Klone oder lade das gesamte Repo herunter und gib es deinem Agenten als Kontext, bevor du es ausführst. Das Repo wird während des Kurses aktualisiert.

Was macht Web Blueprint Generator?

Von erkannten Mustern zu einem Bauplan der Website. Bevor Seiten generiert werden, definiere, welche Seiten es gibt, mit welcher Struktur, welchem Schema und welcher internen Verlinkung. Ohne diese Schicht improvisiert der Agent jede Landingpage und das Ergebnis ist inkonsistent.

Eingaben

  • data/patterns/{kw}/{date}/hypotheses.md ← von local-seo-pattern-aggregator.
  • Zielunternehmen · Name, NAP, USP, Liste der tatsächlichen Dienstleistungen, Liste der abzudeckenden Gebiete.
  • Stack · Standard Astro (auch: Next.js, reines MDX).
  • Einschränkungen · Sprache, maximale Seitenanzahl, Lighthouse-Budget.

Prozess

  1. URL-Karte aus Mustern + Gebieten:
    • Startseite (/)
    • Pillar-Dienstleistungsseiten (/dienstleistungen/{slug}/)
    • Dienstleistung × Stadtteil (/{dienstleistung}/{stadtteil}/) — das Herzstück des lokalen SEO
    • Über uns, Kontakt, Rechtliches
    • Blog (optional)
  2. Für jeden Seitentyp definieren:
    • Title-Muster und Meta-Description-Muster (mit Variablen: {dienstleistung}, {stadtteil}, {stadt}, {telefon}).
    • H1-, H2-, H3-Muster.
    • Pflichtabschnitte (extrahiert aus den HIGH-Hypothesen des Aggregators).
    • JSON-LD-Schema pro Typ:
      • Startseite → LocalBusiness + Organization.
      • Pillar-Dienstleistungsseite → Service + BreadcrumbList.
      • Dienstleistung × Stadtteil → Service mit areaServed: PostalAddress + BreadcrumbList + FAQPage.
    • CTA (Telefon immer sichtbar, wenn die Gewinner es haben).
  3. Interner Verlinkungsplan:
    • Startseite → alle Pillar-Dienstleistungsseiten.
    • Pillar → alle zugehörigen Stadtteile.
    • Dienstleistung × Stadtteil → andere Stadtteile derselben Dienstleistung + Pillar-Dienstleistungsseite + verwandte Dienstleistungen.
    • Konsistenter nearby areas-Block.
  4. Plan für Mindestinhalte pro Seite: Länge, FAQ-Pflicht, soziale Beweise, NAP.
  5. Lighthouse-Budget (vererbt von den Mustern der Top 3): LCP, CLS, TBT, JS-Bundle.

Werkzeuge

  • LLM zum Verfassen von Mustern mit Variablen.
  • schema-dts zur Validierung von JSON-LD gegen offizielle Typen.
  • astro-seo oder next-sitemap (Referenz zur automatischen Generierung von Sitemaps).

Ausgabe

blueprint/{unternehmens-slug}/
├── url-map.yaml                 ← vollständige Liste der zu generierenden URLs
├── page-templates/
│   ├── startseite.md            ← Vorlage mit Variablen {{...}}
│   ├── dienstleistung-pillar.md
│   └── dienstleistung-gebiet.md
├── schema-templates/
│   ├── startseite.jsonld
│   ├── dienstleistung-pillar.jsonld
│   └── dienstleistung-gebiet.jsonld
├── internal-linking.yaml
├── lighthouse-budget.json
└── README.md                    ← Verwendung dieses Blueprints

url-map.yaml Beispiel:

startseite: /
dienstleistungen:
  - slug: notdienst-schluesseldienst-24h
    stadtteile: [zentrum, altstadt, nord, sued]
  - slug: tueroeffnungen
    stadtteile: [zentrum, altstadt, nord]
rechtliches:
  - impressum
  - datenschutz
  - cookies

Qualität / QA

  • Überprüfen, dass jeder service-area in ≤ 3 Klicks von der Startseite erreichbar ist.
  • Keine Dienstleistung × Stadtteil-Kombinationen generieren, die das vom Benutzer festgelegte Limit überschreiten (warnen und um Priorisierung bitten).
  • JSON-LD mit schema-dts vor der Übergabe an den Generator validieren.

Wofür wird es danach verwendet?

→ Direkter Input für landing-generator-servicio-barrio (generiert den eigentlichen Code) und landing-qa-runner (der das Budget überprüft).

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills