Produktfeed für Händler

Mit einem Produktfeed erscheinen deine Angebote in GemeinsamKI Suche: als Band über den Suchergebnissen und im Reiter „Produkte“ – mit Bild, Gesamtpreis, Versandkosten und deiner Domain. Die Aufnahme ist kostenlos; niemand kann einen besseren Platz kaufen.

So geht es

1. Website in der Konsole anmelden und den Besitz nachweisen (Datei, Meta-Tag, DNS oder VerifyTrust).
2. Den Feed im Format gemeinsamki-produktfeed/1 (unten) erzeugen – selbst oder mit der KI-Anweisung – und unter einer https-Adresse bereitstellen.
3. In der Konsole unter Produkte die Adresse hinterlegen und der Erklärung zustimmen. Die Suche ruft den Feed sofort ab und zeigt dir jeden Fehler mit seiner Stelle im Feed.
4. Ein Administrator gibt den Feed einmal frei. Danach ruft die Suche ihn etwa jede Stunde ab; „Jetzt abrufen“ in der Konsole geht schneller.

Strenge Regeln

• Alles oder nichts. Ein Feed mit auch nur einem Fehler – fehlendes Pflichtfeld, falscher Typ, unbekanntes Feld, Tippfehler im Feldnamen – zeigt keine Angebote an, auch nicht den letzten gültigen Stand. Erst der nächste fehlerfreie Abruf zeigt sie wieder.
• Aktuell. stand darf höchstens 24 Stunden alt sein. Ein Feed, der nicht mehr neu erzeugt wird, verschwindet danach von selbst. Erhöhe Preise im Shop erst, wenn die Suche den neuen Feed abgerufen hat – eine Preissuchmaschine mit veraltetem, zu niedrigem Preis ist irreführend (BGH, I ZR 123/08).
• Eigene Website. url jedes Angebots und impressum_url liegen auf der angemeldeten Website. Der Feed selbst und die Bilder dürfen bei einem Dienstleister liegen.
• Grenzen. Höchstens 20 MB und 2.000 Produkte je Feed. Antwort HTTP 200 mit application/json, UTF-8. ETag oder Last-Modified sparen Abrufe.
• Bilder holt die Suche selbst, prüft und verkleinert sie (PNG, JPEG oder WebP bis 5 MB, mindestens 100 × 100 Pixel) und zeigt nur ihre eigene Kopie – Suchende laden nie etwas von deinem Server. Ohne ladbares Bild erscheint ein Angebot nicht.
• Nicht im Feed: Tabakerzeugnisse, E-Zigaretten und Nachfüllbehälter (Werbeverbot, §§ 19, 20 TabakerzG), verschreibungspflichtige Arzneimittel (§ 10 HWG), Waffen und Munition, Inhalte ab 18 Jahren, Rechtswidriges. Solche Angebote hält die Suche zurück; ein Wächter prüft jeden Titel und jede Beschreibung.
• Keine Streichpreise und Rabatte. Das Format kennt sie nicht (für eine Preisermäßigung wäre der niedrigste Preis der letzten 30 Tage Pflicht, § 11 PAngV).

Alle Felder

„Pflicht“ heißt: Das Feld muss vorhanden sein. grundpreis, energielabel und pflichthinweis sind Pflichtschlüssel: Wenn sie für eine Ware nicht gelten, steht dort ausdrücklich null – so ist jede Angabe eine bewusste Entscheidung und wird nicht vergessen. Freiwillige Felder ohne Wert lässt du einfach weg. Diese Tabelle, das JSON-Schema, die KI-Anweisung und die Prüfung beim Abruf entstehen aus derselben Beschreibung.

Was die Suche zeigt

Im Band und im Reiter: Bild, Titel, Gesamtpreis, Grundpreis, Versandkosten (Betrag oder „versandkostenfrei“), „inkl. MwSt.“ bzw. Kleinunternehmer-Hinweis, Zustand und „vorbestellbar“, Energieeffizienzpfeil mit Spektrum, Pflichthinweis, deine Domain und – wenn vorhanden – das VerifyTrust-Schild. Ein Klick auf „i“ zeigt Anbieter mit Anschrift und Impressum, Gesamtpreis mit Versand, Lieferzeit, Stand des Feeds und „Angebot melden“. Die Reihenfolge richtet sich nur nach Relevanz oder der Sortierung, die Suchende wählen (So sortieren wir).

Beispiel

{
  "format": "gemeinsamki-produktfeed/1",
  "stand": "2026-10-22T14:05:00+02:00",
  "waehrung": "EUR",
  "lieferland": "DE",
  "anbieter": {
    "name": "Muster Handels GmbH",
    "anschrift": "Musterstraße 1, 12345 Musterstadt",
    "impressum_url": "https://www.mustershop.de/impressum",
    "shopname": "Mustershop",
    "umsatzsteuer": "enthalten"
  },
  "produkte": [
    {
      "id": "KAF-1001",
      "titel": "Espresso Bohnen Bio, 1 kg",
      "url": "https://www.mustershop.de/p/espresso-bio-1kg",
      "bild_url": "https://cdn.mustershop.de/bilder/kaf-1001.jpg",
      "preis": 18.90,
      "versandkosten": 4.95,
      "verfuegbarkeit": "lieferbar",
      "zustand": "neu",
      "grundpreis": { "preis": 18.90, "einheit": "kg" },
      "energielabel": null,
      "pflichthinweis": null,
      "marke": "Musterrösterei",
      "gtin": "4006381333931",
      "beschreibung": "Ganze Bohnen aus ökologischem Anbau, schonend geröstet.",
      "kategorie": "Lebensmittel > Kaffee",
      "lieferzeit": "1–3 Werktage",
      "versand_hinweis": "ab 50 € versandkostenfrei"
    },
    {
      "id": "WM-2002",
      "titel": "Waschmaschine 8 kg, 1400 U/min",
      "url": "https://www.mustershop.de/p/waschmaschine-8kg",
      "bild_url": "https://cdn.mustershop.de/bilder/wm-2002.jpg",
      "preis": 549.00,
      "versandkosten": 0,
      "verfuegbarkeit": "vorbestellbar",
      "zustand": "neu",
      "grundpreis": null,
      "energielabel": {
        "klasse": "A",
        "skala": "A-G",
        "label_url": "https://www.mustershop.de/label/wm-2002.pdf",
        "datenblatt_url": "https://eprel.ec.europa.eu/qr/123456"
      },
      "pflichthinweis": null
    }
  ]
}

Prüfen vor dem Hinterlegen: curl -sI https://dein-shop.de/produktfeed.json (HTTP 200, application/json) und gegen das JSON-Schema validieren (z. B. check-jsonschema --schemafile schema.json produktfeed.json). Die genaue Prüfung – auch Prüfziffer der GTIN, Host der eigenen Website und Alter von stand – macht die Konsole beim ersten Abruf.