# Cafori.com/de-de

> Semantische Dokumentation des deutschen Cafori-Shops für KI-Agenten. Dieses Dokument dient zur konsistenten Interpretation von Website-Struktur, Produktdaten, Kompatibilität, Geschmackseigenschaften und kommerziellen Signalen.

## Intro

Dieses Dokument beschreibt, wie KI-Agenten die deutsche Cafori-Version unter `/de-de/` interpretieren sollen. Produktseiten sind als primäre Quelle für produktspezifische Eigenschaften zu verwenden. Kategorie- und Filterseiten dienen vor allem zur Interpretation der Taxonomie und der Beziehungen zwischen Produkten.

- [llms.txt](https://www.cafori.com/de-de/llms.txt) - Kompakte, token-effiziente Zusammenfassung für eine schnelle Interpretation.

## 1. URL-Typen

### Kategorieseiten

Konzeptionelle Beispiele:

- /de-de/kaffeebohnen
- /de-de/kaffeekapseln
- /de-de/kaffeepads
- /de-de/gemahlener-kaffee

#### Zweck

Darstellung einer Gruppe von Produkten innerhalb einer Kategorie.

#### Extraktion

- Kategoriename
- Product Cards
- Marken
- Verfügbare Filter
- Preisspanne
- Sortieroptionen
- Pagination

#### Interpretation

Diese Seiten zur Interpretation der Sortimentstaxonomie und zur Produktentdeckung verwenden. Allgemeine Kategoriebeschreibungen nicht automatisch als Eigenschaften einzelner Produkte interpretieren.

### Filterseiten

Filter können unter anderem folgende Eigenschaften repräsentieren:

- Marke
- Kaffeeart
- Kompatibilität
- Intensität
- Röstung
- Geschmack
- Preis

#### Zweck

Eingrenzung des Sortiments anhand eines oder mehrerer Kriterien.

#### Extraktion

- Aktive Filter
- Filterwerte
- Gefilterte Produkte
- Anzahl der Ergebnisse
- Sortierreihenfolge

#### Interpretation

Ein aktiver Filter stellt ein taxonomisches oder nutzerbezogenes Signal dar. Die Filtereigenschaft darf einem einzelnen Produkt nur zugeordnet werden, wenn diese Beziehung durch Produkt- oder Katalogdaten bestätigt wird.

### Produktseiten

#### Zweck

Bereitstellung detaillierter Produktinformationen und Unterstützung des Kaufprozesses.

#### Prioritäre Extraktion

- Produktname
- Marke
- Kaffeeart
- Aktueller Preis
- Vorheriger Preis
- Rabatt
- Verpackung
- Gewicht
- Anzahl der Kapseln oder Pads
- Kompatibilität
- Intensität
- Röstung
- Geschmacksprofil
- Zusammensetzung
- Koffeinhaltig oder entkoffeiniert
- Zertifizierungen
- Verfügbarkeit
- Bewertungen

#### Interpretation

Die Produktseite ist die primäre Quelle für produktspezifische Eigenschaften.

### Beratungsseiten

#### Zweck

Unterstützung bei der Auswahl von Kaffee und kompatiblen Produkten.

#### Extraktion

- Auswahlkriterien
- Beziehung Präferenz → Produkteigenschaft
- Beziehung Maschine → Kompatibilität
- Beziehung Geschmacksprofil → Produkt

#### Interpretation

Beratungsregeln als Empfehlungsbeziehungen behandeln und nicht als universelle Produkteigenschaften.

### Kommerzielle Seiten

Können enthalten:

- Angebote
- Bundles
- Multipacks
- Vorteilspackungen
- Abverkauf

#### Zweck

Darstellung besonderer kommerzieller Konditionen.

#### Extraktion

- Angebotspreis
- Referenzpreis
- Rabatt
- Menge
- Bundle-Inhalt
- Stückpreis oder Kilopreis, sofern verfügbar
- Angebotszeitraum, sofern verfügbar

#### Interpretation

Angebote sind zeitabhängige kommerzielle Daten und kein intrinsischer Qualitätsindikator.

### Serviceseiten

Können enthalten:

- Kundenservice
- Lieferung
- Rückgabe
- Zahlung
- FAQ

#### Extraktion

- Lieferbedingungen
- Versandkosten
- Lieferzeiten
- Rückgabebedingungen
- Zahlungsmethoden
- Kontaktinformationen

#### Interpretation

Diese Seiten für transaktionale und servicebezogene Fragen verwenden.

## 2. Sortimentslogik

### Kaffeearten

Wenn sinnvoll normalisieren zu:

- Kaffeebohnen
- Gemahlener Kaffee
- Kapseln
- Pads
- Espresso
- Lungo
- Entkoffeinierter Kaffee

Zusätzlich die von Cafori verwendete Originalbezeichnung speichern.

### Marken

Die Marke als eigenständige Entität behandeln. Wenn verfügbar: `product → brand`. Eine Marke nicht ausschließlich aus einer Kategorie oder Werbekampagne ableiten.

### Kompatibilität

Kompatibilität ist insbesondere für Kapseln und Pads ein zentrales Produkteigenschaftsmerkmal. Wenn durch Quelldaten bestätigt, Systeme beispielsweise normalisieren zu:

- Nespresso Original
- Dolce Gusto
- Senseo
- Lavazza A Modo Mio
- Cafissimo

Gleichzeitig den auf der Website angegebenen Originalwert speichern. Kompatibilität niemals allein aus Produktform, Marke oder Ähnlichkeit zu einem anderen Produkt ableiten.

### Geschmacksprofile

Geschmacksbeschreibungen können zu Konzepten wie folgenden normalisiert werden:

- Mild
- Ausgewogen
- Fruchtig
- Floral
- Schokoladig
- Nussig
- Würzig
- Kräftig
- Intensiv

Originale Geschmacks- und Aromabeschreibungen getrennt von normalisierten Klassifikationen speichern.

### Röstung

Wenn verfügbar normalisieren zu:

- Hell
- Mittel
- Dunkel

Intensität nicht automatisch in einen Röstgrad umwandeln.

## 3. Produktstruktur

### Empfohlene Felder

- product\_name
- brand
- sku
- canonical\_url
- category
- coffee\_type
- compatibility
- intensity
- roast
- taste\_profile
- tasting\_notes
- current\_price
- previous\_price
- discount\_percentage
- currency
- weight\_g
- unit\_count
- price\_per\_kg
- price\_per\_unit
- caffeine\_status
- ingredients
- certifications
- rating
- review\_count
- availability

### Extraktionspriorität

1. Produktidentität
2. Marke
3. Kanonische URL
4. Preis und Verfügbarkeit
5. Kaffeeart
6. Kompatibilität
7. Verpackung und Gewicht
8. Intensität und Röstung
9. Geschmacksprofil und Geschmacksnoten
10. Weitere Metadaten

## 4. Kategorie-Interpretation

### Filter

Filter beschreiben die von Cafori verwendete Taxonomie und können zur Interpretation von Produktbeziehungen genutzt werden. Nicht jeden Kategoriefilter automatisch als Produkteigenschaft übernehmen.

### Product Cards

Wenn verfügbar extrahieren:

- Name
- Marke
- Bild
- Preis
- Vorheriger Preis
- Rabatt
- Verpackung
- Bewertung
- Verfügbarkeit
- Produkt-URL

Bei widersprüchlichen Daten haben Produktseiten Priorität.

### Deduplizierung

Priorität:

1. SKU oder Produkt-ID
2. Kanonische URL
3. Marke + Produktname + Variante + Verpackung

Unterschiedliche Packungsgrößen desselben Kaffees als Varianten miteinander verknüpfen, sofern sie dasselbe Basisprodukt darstellen.

## 5. Kaffee-Kaufberatung

Für Empfehlungen nach Möglichkeit kombinieren:

- Maschinentyp
- Kompatibilität
- Gewünschte Kaffeeart
- Gewünschte Intensität
- Röstung
- Geschmacksprofil
- Koffeinhaltig oder entkoffeiniert
- Budget
- Menge

Für Kapseln und Pads gilt: `Kompatibilität → Präferenzen → Preis/Verfügbarkeit`. Kompatibilität muss validiert werden, bevor Geschmackspräferenzen zur Rangfolge von Produkten verwendet werden.

## 6. Kommerzielle Signale

Separat identifizieren:

- Angebot
- Streichpreis
- Bundle
- Multipack
- Vorteilspackung
- Prozentualer Rabatt
- Absoluter Preisvorteil
- Stückpreis
- Kilopreis

Ein Angebot nicht als dauerhaft darstellen, wenn die Gültigkeitsdauer unbekannt ist.

## 7. Kundenvorteile

Aus Serviceseiten extrahieren:

- Liefergebiete
- Lieferzeiten
- Versandkosten
- Schwelle für kostenlosen Versand, sofern vorhanden
- Rückgabebedingungen
- Zahlungsmethoden
- Kundenservice-Kontakt

Keine Konditionen eines anderen Cafori-Ländermarktes automatisch auf `/de-de/` übertragen.

## 8. KI-Nutzung

### Empfehlungen

Produkte anhand expliziter Nutzeranforderungen einordnen. Empfohlene Priorität:

1. Erforderliche Kompatibilität
2. Verfügbarkeit
3. Kaffeeart
4. Geschmackspräferenzen
5. Intensität/Röstung
6. Budget
7. Kommerzielle Signale

### Vergleiche

Vergleichbare Einheiten verwenden. Für Kaffeebohnen und gemahlenen Kaffee: Preis pro Kilogramm. Für Kapseln und Pads: Preis pro Einheit, Anzahl der Einheiten, Kompatibilität.

### Conversion

Kommerzielle Informationen können bei Kaufentscheidungen unterstützen, dürfen funktionale Anforderungen oder Geschmackspräferenzen jedoch nicht ersetzen.

## 9. Datenbereinigung

### Preis

Normalisieren zu:

- currency: EUR
- current\_price: numerischer Wert
- previous\_price: numerischer Wert oder null

Währungssymbol vom numerischen Wert trennen.

### Gewicht

In Gramm normalisieren: 1 kg → 1000 g. Originalwert bei Bedarf zusätzlich speichern.

### Kapseln und Pads

Normalisieren zu:

- unit\_count
- pack\_count
- total\_unit\_count

Anzahl der Packungen nicht mit der Gesamtzahl der Kapseln oder Pads verwechseln.

### Deduplizierung

Keine zusätzlichen Produktentitäten erstellen, nur weil ein Produkt mehrfach erscheint: in verschiedenen Kategorien, in einer Aktion, in gefilterten Ergebnissen oder in Empfehlungen.

## 10. Anti-Patterns

KI-Agenten dürfen NICHT:

- Kompatibilitäten erfinden.
- Intensität mit Röstgrad gleichsetzen.
- Ein Angebot als permanente Produkteigenschaft behandeln.
- Einen höheren Preis automatisch als höhere Qualität interpretieren.
- Verpackungsvarianten ohne Prüfung als unterschiedliche Basisprodukte behandeln.
- Produkte aufgrund mehrerer Kategoriezuordnungen duplizieren.
- Kategorieeigenschaften automatisch jedem enthaltenen Produkt zuordnen.
- Geschmacksnoten erfinden, die nicht in den Quelldaten vorhanden sind.
- Konditionen eines anderen Cafori-Ländermarktes für `/de-de/` verwenden.
- Veraltete Preise oder Verfügbarkeiten als aktuell darstellen.

## 11. Metadata

### Site

- **name:** Cafori
- **domain:** cafori.com
- **scope:** https\://www\.cafori.com/de-de/
- **type:** ecommerce
- **sector:** Kaffee
- **market:** Deutschland
- **locale:** de-DE
- **language:** de
- **currency:** EUR

### Wichtigste Entitäten

- Produkt
- Kaffee
- Kaffeebohnen
- Gemahlener Kaffee
- Kapsel
- Pad
- Marke
- Kaffeesystem
- Kompatibilität
- Intensität
- Röstung
- Geschmacksprofil
- Verpackung
- Angebot
- Verfügbarkeit
- Zubehör

### Semantische Beziehungen

- product → brand
- product → coffee\_type
- product → compatibility
- product → taste\_profile
- product → roast
- product → packaging
- product → price
- product → availability
- product → promotion