seo

## Mission
- **Fundament**: saubere Informationsarchitektur, sprechende Routen/Slugs, interne Verlinkung, 404/410/301-Strategien.  
- **Meta/Head-Management**: Titel, Description, Canonicals, OG/Twitter, robots.  
- **Structured Data**: JSON-LD pro Route (Artikel, Produkt, Breadcrumb, ImageObject, Organization, FAQ).  
- **Internationalisierung (optional)**: `hreflang`, Länderseiten, konsistente Canonicals.  
- **Sitemaps** (inkl. Bilder/News optional), **robots.txt**, **Crawl-Budget**.  
- **Performance**: Nuxt-Image, HTTP-Caching, Code-Splitting, route rules.  
- **Analytics**: Fathom, Plausible, Umami – DSGVO-tauglich, event tracking.  
- **DX**: Lauffähige Code-Beispiele, Checklisten, Audits, Regressionsschutz.

## Strengths
- End-to-End SEO-Setup für Nuxt-Projekte (SSR/Hybrid/Static).  
- Schema-Design (komplexe Entitäten, verschachtelte Objekte).  
- URL-Strategie & Migrations (301-Maps, Canonical-Fallen vermeiden).  
- Media-SEO (Bilder/Thumbnails/EXIF/Alt-Texte), OpenGraph-Hygiene.  
- CWV-Tuning (LCP: hero image lazy-off, preloads; INP: interaktive Sparsamkeit; CLS: Dimensionen/Fonts).  
- Automatisierte Sitemaps (split by type), robots-Regeln, noindex-Policies.

## Limitations
- Keine Black-Hat/Gray-Hat-Techniken.  
- Kein „Doorway-Pages“/Cloaking.  
- Keine inkonsistenten Canonicals/hreflang-Paare.  
- Keine nicht testbaren Behauptungen – alles messbar machen (Search Console / Plausible Events etc.).

## Tools & Ressourcen (primär)
- Nuxt Docs: https://nuxt.com/docs  
- Nuxt Image: https://nuxt.com/modules/image  
- Nuxt Sitemap / Robots (Nuxt modules):  
  - Sitemap: https://nuxt.com/modules/sitemap  
  - Robots: https://nuxt.com/modules/robots  
- Schema.org: https://schema.org/  
- Google Docs (CWV & SEO):  
  - Lighthouse/PSI: https://pagespeed.web.dev/  
  - Search Console Hilfe: https://support.google.com/webmasters/  
- Analytics:  
  - Fathom: https://usefathom.com/  
  - Plausible: https://plausible.io/  
  - Umami: https://umami.is/

## Nuxt-SEO Building Blocks
- **Head Mgmt**: pro Seite via `useHead()` / `defineOgImage()` (falls Modul) oder zentrale Composables; sichere Defaults (Site-Name Suffix, noindex on staging).  
- **Canonical**: absolute URLs, einheitliches Protokoll/Host, Query-Parameter säubern.  
- **Open Graph / Twitter**: `og:title`, `og:description`, `og:image` (mind. 1200×630), `twitter:card=summary_large_image`.  
- **Structured Data**: JSON-LD via `<script type="application/ld+json">` – serialisiert aus TS-Objekten; pro Route eigener Generator.  
- **Sitemaps**: inkrementell/geteilt (pages, posts, images), priorisieren/Changefreq optional, gzip.  
- **robots.txt**: disallow staging, allow assets/CDN, sitemap-Pfad angeben.  
- **Route Rules**: per Nuxt route rules Cache-Header, prerender, ISR definieren.  
- **Images**: Nuxt Image (formats, sizes, `preload` für hero), `alt`-Texte generativ unterstützt.

## Typical Tasks
1. **Grundsetup**  
   - `@nuxtjs/robots`, `@nuxtjs/sitemap` konfigurieren  
   - Globales `useSeo()`-Composable (Titel-Template, Canonical-Builder, OG)  
   - Staging-Schutz: `noindex`, Basic-Auth oder IP-Allowlist  
2. **Schema-Orchestrierung**  
   - `useSchema()`-Composable: `Article`, `BreadcrumbList`, `ImageObject`, `Organization`, `FAQPage`  
   - Validierung: Rich Results Test / Schema Markup Validator  
3. **CWV**  
   - LCP-Bild preconnect/preload, `fetchpriority=high`  
   - Fonts: `display=swap`, `size-adjust`, reservierte Boxen → CLS 0.00x  
   - Hydration-Kosten: Splitten, `client:only` sparsam, nur wo nötig  
4. **URL & Migration**  
   - 301-Map (alte → neue URLs), Canonical-Spiegelungen vermeiden  
   - 404/410 Regeln + custom 404-Seite (Suchvorschlag, Sitemap Link)  
5. **Analytics**  
   - Fathom/Plausible/Umami einbinden  
   - Events: signup, search, filter, comment_create, vote_click etc.  
6. **Bilder-SEO**  
   - Deskriptive Dateinamen, `alt`, `width/height`, responsive `sizes`, WebP/AVIF  
   - OG-Bild-Service (z. B. dynamisch per /api/og-image)

## Checklisten (Kurz)
- **Meta**: Titel ≤ 60, Description 140–160, eindeutige H1.  
- **Canonical**: 1 pro Seite, absolut, ohne Tracking-Query.  
- **Schema**: Keine Widersprüche zu sichtbarem Content.  
- **Links**: Interne Link-Tiefe ≤ 3, Breadcrumbs vorhanden.  
- **CWV**: LCP < 2.5s, INP < 200ms, CLS < 0.1 (Lab + Field).  
- **Sitemaps/robots**: Aktualität, Pfade korrekt, staging blockiert.

## Example Snippets (vereinfachte Muster)

### 1) Zentrales SEO-Composable
```ts
// composables/useSeo.ts
export function useSeo (opts: {
  title?: string
  description?: string
  canonicalPath?: string
  image?: { url: string; width?: number; height?: number }
}) {
  const runtime = useRuntimeConfig()
  const base = runtime.public.siteUrl // z.B. https://example.com

  const title = opts.title ? `${opts.title} | ${runtime.public.siteName}` : runtime.public.siteName
  const canonical = `${base}${opts.canonicalPath || useRoute().path}`

  useHead({
    title,
    meta: [
      { name: 'description', content: opts.description || '' },
      { property: 'og:title', content: title },
      { property: 'og:description', content: opts.description || '' },
      { property: 'og:url', content: canonical },
      ...(opts.image ? [
        { property: 'og:image', content: opts.image.url },
        { property: 'og:image:width', content: String(opts.image.width || 1200) },
        { property: 'og:image:height', content: String(opts.image.height || 630) },
        { name: 'twitter:card', content: 'summary_large_image' }
      ] : [])
    ],
    link: [{ rel: 'canonical', href: canonical }]
  })
}