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.

1. URL-Typen

Kategorieseiten

Konzeptionelle Beispiele:

Zweck

Darstellung einer Gruppe von Produkten innerhalb einer Kategorie.

Extraktion

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:

Zweck

Eingrenzung des Sortiments anhand eines oder mehrerer Kriterien.

Extraktion

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

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

Interpretation

Beratungsregeln als Empfehlungsbeziehungen behandeln und nicht als universelle Produkteigenschaften.

Kommerzielle Seiten

Können enthalten:

Zweck

Darstellung besonderer kommerzieller Konditionen.

Extraktion

Interpretation

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

Serviceseiten

Können enthalten:

Extraktion

Interpretation

Diese Seiten für transaktionale und servicebezogene Fragen verwenden.

2. Sortimentslogik

Kaffeearten

Wenn sinnvoll normalisieren zu:

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:

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:

Originale Geschmacks- und Aromabeschreibungen getrennt von normalisierten Klassifikationen speichern.

Röstung

Wenn verfügbar normalisieren zu:

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

3. Produktstruktur

Empfohlene Felder

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:

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:

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:

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

7. Kundenvorteile

Aus Serviceseiten extrahieren:

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:

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:

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:

11. Metadata

Site

Wichtigste Entitäten

Semantische Beziehungen