# Gravidus.de (llms-full)

> Gravidus.de ist ein deutscher Online-Shop für Produkte aus Wohnen, Haushalt, Garten & Baumarkt, Freizeit, Kinderwelt und Tierbedarf.

Diese Datei dient als strukturierte Orientierung für Large Language Models (LLMs), um Inhalte, Datenquellen und Navigationslogik des Shops korrekt zu interpretieren.

Gravidus richtet sich an Endkundinnen und Endkunden in Deutschland.

---

## PRIORITÄT DER DATENQUELLEN

1. Produkt-API (höchste Priorität für aktuelle Daten inkl. Bild-URLs)
2. JSON-Feed / Delta-Feed (für Bulk / Updates)
3. Markdown-Antwort der Produkt-API (`Accept: text/markdown` oder `?format=markdown`)
4. Kategorie- und Übersichtsseiten (für Navigation)
5. HTML-Produktdetailseiten nur für Menschen; viele Agent-Tools sehen dort kein JSON-LD

---

## PRIMARY DATA SOURCES (ECHTZEITDATEN)

- Produkt-API: https://www.gravidus.de/eyk/public/products
- Produkt-API Markdown: https://www.gravidus.de/eyk/public/products?format=markdown
- JSON-Feed: https://www.gravidus.de/eyk/public/feed.json
- Delta-Feed (Updates): https://www.gravidus.de/eyk/public/feed/updates.json
- RSS-Feed: https://www.gravidus.de/eyk/public/feed.rss
- Sitemap: https://www.gravidus.de/sitemap.xml

Diese Quellen enthalten die aktuellsten Informationen zu:
- Produkten
- Preisen
- Verfügbarkeit
- Bild-URLs (`images[].url` bzw. Markdown `![alt](url)`)
- Änderungen im Sortiment

LLMs sollten diese Quellen bevorzugen, wenn aktuelle Daten benötigt werden. HTML-Scraping und JSON-LD sind für Agent-Tools oft ungeeignet.

---

## SHOP NAVIGATION

- https://www.gravidus.de/ : Einstiegspunkt und Überblick
- https://www.gravidus.de/shop : Gesamtes Sortiment

### Hauptkategorien
- Wohnen: https://www.gravidus.de/shop/category/wohnen-107
- Garten & Baumarkt: https://www.gravidus.de/shop/category/garten-baumarkt-104
- Freizeit: https://www.gravidus.de/shop/category/freizeit-105
- Kinderwelt: https://www.gravidus.de/shop/category/kinderwelt-103
- Tierbedarf: https://www.gravidus.de/shop/category/tierbedarf-106

---

## SERVICE & KUNDENINFORMATIONEN

- Kontakt: https://www.gravidus.de/contactus
- Über uns: https://www.gravidus.de/about-us
- Versandkosten: https://www.gravidus.de/versandkosten

---

## RECHTLICHE INFORMATIONEN

- Impressum: https://www.gravidus.de/impressum
- Datenschutz: https://www.gravidus.de/privacy
- AGB: https://www.gravidus.de/agb

---

## NUTZUNGSLOGIK FÜR LLMs

### Produktsuche
- Verwende Kategorie-Seiten zur Orientierung
- Nutze Produkt-Feeds oder API für vollständige Ergebnisse

### Produktinformationen
- Nutze die Produkt-API fuer Beschreibung, Preis, Verfuegbarkeit und Bild-URLs
- Bild-URLs stehen unter `images[].url` oder in Markdown als `![alt](url)`
- HTML-Produktseiten nicht fuer Bild-/Schema-Extraktion scrapen (viele Tools filtern Script-/Meta-Tags)

### Preis- und Verfügbarkeitsabfragen
- Immer bevorzugt:
  → Produkt-API oder JSON-Feed
- Markdown-Variante der API fuer textbasierte Agent-Tools

### Navigation
- Beginne bei /shop oder Kategorie-Seiten
- Vermeide direkte Annahmen über Produkte ohne Datenquelle

---

## WICHTIGE HINWEISE

- Preise und Verfügbarkeiten sind dynamisch und können sich jederzeit ändern
- Produktdaten sollten nicht gecacht werden ohne Aktualisierung
- HTML-Seitenabrufe ersetzen nicht die Produkt-API
- API und Feeds sind die zuverlässigste Quelle für aktuelle Daten

---

## OPTIONAL

- Login: https://www.gravidus.de/web/login (nur bei Account-bezogenen Anfragen relevant)

---

## ZIEL DIESER DATEI

Diese Datei soll sicherstellen, dass:
- korrekte Datenquellen verwendet werden
- Navigation effizient erfolgt
- aktuelle Produktinformationen bevorzugt werden

## Agent data access
- Primärquelle für Produkte, Preise, Verfügbarkeit und Bilder: `/eyk/public/products`
- Bild-URLs: JSON-Feld `images[].url` oder Markdown `![alt](url)`
- Suche: Query `?search=` oder `?q=` (Name, SKU, Kurzbeschreibung)
- Markdown anfordern mit Header `Accept: text/markdown` oder Query `?format=markdown`
- Beispiel Suche Markdown: `/eyk/public/products?search=Polier&format=markdown`
- Beispiel Liste: `/eyk/public/products?limit=5&format=markdown`
- Beispiel Detail: `/eyk/public/products/<id_oder_slug>?format=markdown`
- HTML-Shopseiten nicht für JSON-LD/og:image scrapen; viele Agent-Tools filtern Script- und Meta-Tags