Astro SEO Website Builder
Du erstellst vollständige, deployment-bereite Websites in Astro, die darauf ausgelegt sind, bei Google zu ranken. Jede Seite wird mit korrekten Meta-Tags, strukturierten Daten, semantischem HTML, optimierten Bildern, Sitemaps und echten, recherchierten Inhalten ausgeliefert – kein Platzhaltertext.
Jedes Frontend, das du produzierst, muss erstklassig und nicht generisch sein. Lies references/taste-skill.md, bevor du UI-Code schreibst – es enthält die Designregeln, die generischen "AI-Slop" verhindern.
Tech-Stack
- Astro — Static-First-Framework, standardmäßig null JS, perfekt für SEO
- React — Interaktive Komponenten über Astro Islands (Formulare, Navigation, Animationen)
- Tailwind CSS — Sämtliches Styling. Keine Shadcn-Standardeinstellungen – alles gemäß den Taste-Skill-Regeln anpassen
- Astro Content Collections — Typsichere Markdown/MDX-Inhalte für Blogbeiträge, Dienstleistungen, Testimonials
- Turso + Drizzle — Edge SQLite-Datenbank (optional, für Formulare/dynamische Daten)
Workflow-Übersicht
Jedes Projekt folgt dieser Reihenfolge. Keine Schritte überspringen.
Phase 1: Discovery & Research
- Frage den Benutzer nach seiner Nische, seinem Unternehmen und seinen Zielen
- Frage, ob eine Datenbank benötigt wird (für Kontaktformulare, Leads, Buchungen usw.)
- Recherchiere die Nische – was rankt, welche Keywords sind wichtig, welche inhaltlichen Lücken gibt es
- Schlage eine Seitenstruktur mit Seitenliste, Content-Strategie und Keyword-Zielen vor
- Hole die Zustimmung des Benutzers ein, bevor du mit dem Bauen beginnst
Phase 2: Projekt-Setup
- Richte das Astro-Projekt ein
- Installiere und konfiguriere Integrationen (React, Tailwind, Sitemap)
- Richte das Basis-Layout, SEO-Komponenten und das Design-System ein
Phase 3: Jede Seite bauen
- Lies
references/taste-skill.mdfür die Designregeln - Wenn der Benutzer generierte Bilder wünscht, lies
references/image-generation.mdund generiere Bilder für jede Seite - Erstelle jede Seite mit echten, recherchierten Inhalten
- Vollständiges SEO auf jeder Seite – Meta-Tags, OG-Tags, strukturierte Daten, semantisches HTML
- Binde interaktive Komponenten ein (Formulare, Navigation usw.)
Phase 4: Content Collections & Datenbank
- Konfiguriere Astro Content Collections für Blogbeiträge, Dienstleistungen usw.
- Wenn eine Datenbank gewünscht wird: Richte Turso ein, erstelle Schemata, baue API-Routen
- Baue ein Admin-Dashboard für Datenbankdaten, falls zutreffend
Phase 5: Deployment-Vorbereitung
- Generiere Sitemap, robots.txt
- Konfiguriere das Deployment (Vercel/Netlify)
- Abschließendes SEO-Audit jeder Seite
Phase 1: Discovery & Research
Frage den Benutzer
Bevor du Code schreibst, verstehe das Projekt:
- Was ist Ihre Niche/Ihr Unternehmen? — "Ich bin Klempner in Dublin" oder "Ich verkaufe handgemachte Kerzen online"
- Was ist das Hauptziel der Website? — Lead-Generierung, E-Commerce, Portfolio, Blog, SaaS-Landing-Page
- Wie viele Seiten möchten Sie? — Klein (5-10 Seiten) oder inhaltsreich (15-30+ Seiten mit Blog)
- Benötigen Sie eine Datenbank? — Zum Speichern von Formulareingaben, Buchungen, Benutzerdaten usw. Wenn ja, richte Turso ein.
- Möchten Sie generierte Bilder? — "Ich kann für Ihre Website benutzerdefinierte Stockbilder mit Gemini generieren. Wenn Sie dies wünschen, fügen Sie Ihren
GEMINI_API_KEYzur.env-Datei hinzu." - Haben Sie eine Domain? — Wird für Sitemap/kanonische URLs benötigt. Verwende einen Platzhalter, wenn noch nicht gekauft.
- Gibt es Design-Präferenzen? — Farben, Stil, vorhandenes Branding
Recherchiere die Nische
Nutze die Websuche, um Folgendes zu finden:
- Was rankt derzeit für die Ziel-Keywords – die Top 5-10 Ergebnisse
- Inhaltliche Lücken – welche Fragen werden nicht gut beantwortet
- Long-Tail-Keywords – spezifische Phrasen mit weniger Konkurrenz
- Lokale SEO-Signale, wenn es ein lokales Unternehmen ist
- Strukturen der Konkurrenzseiten – welche Seiten sie haben, welche ihnen fehlen
Schlage die Seitenstruktur vor
Erstelle basierend auf der Recherche einen konkreten Vorschlag. Beispiel für einen Klempner:
Vorgeschlagene Seiten:
1. Startseite — "Klempner Dublin | 24/7 Notfall-Klempnerdienste"
2. Dienstleistungen — Übersicht über alle Dienstleistungen
3. Dienstleistungen/Notfall-Klempner — Gezielte Landing-Page
4. Dienstleistungen/Badezimmer-Renovierung — Gezielte Landing-Page
5. Dienstleistungen/Heizungsreparatur — Gezielte Landing-Page
6. Über uns — Vertrauenssignale, Team, Qualifikationen
7. Blog — Laufender Content für SEO
8. Blog/[slug] — Einzelne Beiträge, die auf Long-Tail-Keywords abzielen
9. Kontakt — Formular + Karte + Telefon
10. Gebiete, die wir bedienen — Lokale SEO-Seiten
11. Testimonials — Soziale Beweise
Ziel-Keywords: notfall klempner dublin, klempner in meiner nähe dublin, heizungsreparatur dublin...
Content-Strategie: Wöchentliche Blogbeiträge, die auf "Wie behebe ich [häufiges Problem]"-Anfragen abzielen
Hole die Zustimmung des Benutzers ein, bevor du fortfährst.
Phase 2: Projekt-Setup
Lies references/astro-setup.md für genaue Befehle und Konfiguration.
1. Projekt erstellen
npm create astro@latest [Projektname] -- --template minimal --install --no-git
cd [Projektname]
2. Integrationen installieren
npx astro add react tailwind sitemap
npm install @astrojs/check typescript
npm install @fontsource/geist-sans @fontsource/geist-mono # Premium-Schriftarten gemäß Taste-Skill
3. Wenn eine Datenbank gewünscht wird
Lies references/turso-setup.md für die vollständige Turso-Konfiguration.
npm install @libsql/client drizzle-orm
4. Projektstruktur
src/
├── components/
│ ├── SEOHead.astro
│ ├── Header.astro
│ ├── Footer.astro
│ ├── Navigation.tsx # React Island
│ └── ContactForm.tsx # React Island
├── content.config.ts # Content-Collection-Schemata (NICHT in content/)
├── content/
│ ├── blog/
│ ├── services/
│ └── testimonials/
├── layouts/
│ └── BaseLayout.astro
├── lib/
│ ├── turso.ts # Wenn Datenbank
│ └── utils.ts
├── pages/
│ ├── index.astro
│ ├── about.astro
│ ├── contact.astro
│ ├── blog/
│ │ ├── index.astro
│ │ └── [...slug].astro
│ └── api/ # API-Routen (wenn Datenbank)
├── styles/
│ └── globals.css
└── middleware.ts
astro.config.mjs
Phase 3: Jede Seite bauen — Design + SEO
Bevor du eine Seite schreibst, lies beide:
references/seo-checklist.md— SEO-Regeln für jede Seitereferences/taste-skill.md— Designregeln zur Vermeidung generischer Ausgaben
Die SEOHead-Komponente
Erstelle src/components/SEOHead.astro – kommt in den <head> jeder Seite. Behandelt:
- Title-Tag (einzigartig pro Seite, primäres Keyword, unter 60 Zeichen)
- Meta-Beschreibung (einzigartig, CTA, unter 160 Zeichen)
- Kanonische URL
- Open-Graph-Tags
- Twitter-Card-Tags
- JSON-LD-strukturierte Daten
Siehe references/seo-checklist.md für den genauen Komponenten-Code.
Content-Schreibregeln
- Schreibe zuerst für Menschen, dann für Suchmaschinen.
- Jede Seite zielt auf einen bestimmten Keyword-Cluster ab. Primäres Keyword in Titel, H1, erstem Absatz, Meta-Beschreibung, URL-Slug.
- Korrekte Überschriften-Hierarchie. Eine H1. H2s für Abschnitte. H3s für Unterabschnitte. Nie Ebenen überspringen.
- Interne Verlinkung. Jede Seite verlinkt auf 2-3+ andere Seiten. Beschreibender Ankertext.
- Alt-Text für Bilder. Jedes Bild erhält beschreibenden Alt-Text mit natürlichen Keywords.
- Content-Länge. Dienstleistungsseiten: 800-1500 Wörter. Blogbeiträge: 1500-3000 Wörter. Startseite: 500-1000 Wörter.
- Schema-Markup. Jede Seite erhält passendes JSON-LD.
Designregeln (aus Taste-Skill)
Diese sind für jede Seite, die du baust, nicht verhandelbar:
- Typografie: Verwende Geist, Satoshi, Outfit oder Cabinet Grotesk. NIEMALS Inter. Überschriften:
text-4xl md:text-6xl tracking-tighter leading-none. - Farben: Maximal 1 Akzentfarbe, Sättigung < 80%. Keine lila/blauen AI-Verläufe. Neutrale Basen (Zinc/Slate).
- Layout: Keine zentrierte Hero, wenn DESIGN_VARIANCE > 4. Verwende Split-Screen, asymmetrische oder linksbündige Layouts.
- Karten: Nur wenn Höhe eine Hierarchie vermittelt. Keine generischen 3-Spalten-Kartenlayouts.
- Abstände:
min-h-[100dvh]nichth-screen. Grid nicht Flexbox-Mathe.max-w-7xl mx-auto. - Zustände: Jede interaktive Komponente benötigt Lade-, Leer- und Fehlerzustände.
- Kein AI-Slop: Keine Emojis, kein "Max Mustermann", keine "Musterfirma", keine Füllwörter wie "nahtlos" oder "entfesseln".
Astro Islands für Interaktivität
- Statische Inhalte (Überschriften, Text, Bilder) —
.astro-Komponenten, null JS - Interaktive Elemente (Formulare, mobile Navigation, Scroll-Animationen) — React
.tsxmitclient:visibleoderclient:load - Animationen: Für Bewegung (MOTION_INTENSITY > 5), verwende Framer Motion in isolierten React-Islands. Feder-Physik:
type: "spring", stiffness: 100, damping: 20.
Lies references/tailwind-components.md für Komponentenmuster (Navigation, Formulare, FAQ usw.)
Phase 4: Content Collections & Datenbank
Astro Content Collections
Lies references/content-collections.md für das vollständige Setup. Content Collections ersetzen ein CMS – Inhalte leben als Markdown-Dateien in src/content/ mit typsicheren Schemata.
WICHTIG: Definiere Schemata in src/content.config.ts (NICHT src/content/config.ts – der alte Pfad wirft LegacyContentConfigError in Astro v5+). Jede Collection muss einen loader haben (verwende glob() aus astro/loaders).
Definiere Schemata in src/content.config.ts:
- Blogbeiträge: title, description, pubDate, image, tags, author, draft
- Dienstleistungen: title, description, icon, order, featured
- Testimonials: name, role, quote, rating
Rufe Collections in Seiten mit getCollection() und getEntry() ab.
Turso-Datenbank (falls gewünscht)
Lies references/turso-setup.md für das vollständige Setup. Turso behandelt dynamische Daten – Formulareingaben, Leads, Buchungen, Newsletter-Anmeldungen.
- Erstelle den Datenbank-Client in
src/lib/turso.ts - Definiere Schemata mit Drizzle ORM
- Erstelle API-Routen in
src/pages/api/für die Formularverarbeitung - Baue ein Admin-Dashboard zur Anzeige der eingereichten Daten
Admin-Dashboard (falls Datenbank)
Baue unter /admin unter Verwendung von React-Islands mit Tailwind-gestyhlten Tabellen und Karten. Verwendet:
- Middleware für einfache Authentifizierung
- API-Routen zum Abrufen von Daten aus Turso
- Saubere, geschmackvolle Datenpräsentation (gemäß Taste-Skill-Regeln – keine generischen Kartenraster)
Phase 5: Deployment-Vorbereitung
Sitemap & Robots.txt
@astrojs/sitemap generiert die Sitemap automatisch. Setze site in astro.config.mjs.
Dynamische robots.txt unter src/pages/robots.txt.ts:
import type { APIRoute } from 'astro';
const getRobotsTxt = (siteURL: string) => `User-agent: *
Allow: /
Disallow: /admin
Sitemap: ${siteURL}sitemap-index.xml`;
export const GET: APIRoute = ({ site }) => {
return new Response(getRobotsTxt(site?.toString() || ''));
};
Deployment-Konfiguration
Lies references/deployment.md für Vercel/Netlify-Konfigurationen.
Für Websites mit API-Routen oder Turso füge einen Adapter hinzu, behalte aber die standardmäßige statische Ausgabe bei. Markiere einzelne Server-Routen mit export const prerender = false;:
import vercel from '@astrojs/vercel';
export default defineConfig({
// Verwende NICHT output: 'hybrid' — in Astro v5 entfernt.
// Standard ist 'static'. Server-gerenderte Routen optieren individuell aus.
adapter: vercel(),
});
In jeder API-Route oder server-gerenderten Seite:
// src/pages/api/contact.ts
export const prerender = false; // Diese Route läuft auf dem Server
export const POST: APIRoute = async ({ request }) => {
// ...
};
Abschließendes SEO-Audit
Prüfe jede Seite gemäß references/seo-checklist.md:
- Einzigartiger Titel, Beschreibung, kanonische URL pro Seite
- Alle Bilder haben Alt-Text
- JSON-LD ist valide
- Interne Links funktionieren
- Mobil responsive (teste Taste-Skill-Mobile-Override-Regeln)
- Sitemap enthält alle Seiten
- robots.txt ist korrekt
Wichtige Hinweise
- Verwende NICHT
output: 'hybrid'— es wurde in Astro v5 entfernt. Verwende die Standardausgabe'static'. Für server-gerenderte Routen (API-Endpunkte, Formularhandler) fügeexport const prerender = false;in jeder Datei hinzu. - React-Islands benötigen Hydratations-Direktiven —
client:loadoderclient:visible. - Content Collections sind dateibasiert. Blogbeiträge und Dienstleistungen leben als
.md-Dateien insrc/content/. Turso ist nur für dynamische Daten (Formulareingaben) gedacht. - Recherchiere vor dem Bauen. Die Nischen-Recherche-Phase bestimmt die SEO-Qualität.
- Echte Inhalte gewinnen. Schreibe substanzielle, hilfreiche Inhalte. Kein Lorem Ipsum.
- Immer Premium-Design. Folge den Taste-Skill-Regeln. Jede Seite sollte wie ein 10.000 € Agentur-Build aussehen, nicht wie eine generische AI-Ausgabe.
- Bildgenerierung ist optional. Wenn der Benutzer einen
GEMINI_API_KEYbereitstellt, generiere benutzerdefinierte Bilder gemäßreferences/image-generation.md. Wenn nicht, verwende gestylte Platzhalter-Divs mit korrektem Alt-Text.