# EAN-Shopping

> EAN-Shopping (ean-shopping.de) ist eine Preisvergleichs- und Produktkatalog-Plattform für den deutschsprachigen Markt. Verbraucher finden, vergleichen und recherchieren Produkte anhand von EAN/GTIN-Nummern, Preisen und Händlerangeboten. Händler präsentieren ihre Produkte über ein abonnementbasiertes Portal und können optional eine EAN-Lookup-REST-API für den programmatischen Zugriff auf über 13 Millionen Produkte buchen.

EAN-Shopping verbindet Produktdaten aus mehreren Quellen zu einem durchsuchbaren Katalog und ermöglicht Preisvergleiche über verschiedene Händler hinweg. Die Plattform setzt auf eine schnelle Volltextsuche (Manticore), KI-gestützte Suchanalyse (Gemma-basierter Chat-Assistent) und eine öffentlich zugängliche REST-API für EAN-Lookups mit Fair-Billing-Modell.

## Für Verbraucher

- [Produktsuche](https://www.ean-shopping.de/suche/): Durchsuchbarer Produktkatalog mit dynamischen Filtermöglichkeiten (Kategorie, Hersteller, Preis, Attribute wie Farbe/Größe/Material). Suche per Produktname, EAN/GTIN, Hersteller-MPN oder Stichwort. Direkter Sprung zur Produktseite bei EAN-Direkteingabe.
- [Preisvergleich](https://www.ean-shopping.de): Vergleich von Angeboten verschiedener Händler zu einem Produkt inklusive Produktdetails, Grundpreis, EEK-Energielabel (mit EPREL-ID) und Kategorisierung nach Google-Produkttaxonomie.
- [Chat-Assistent](https://www.ean-shopping.de): KI-gestützter „EAN-Shopping Assistent" (Gemma-basiert) zur Produktberatung und Beantwortung von Suchanfragen in natürlicher Sprache.
- [Preis-Alert](https://www.ean-shopping.de/datenschutz/#preisalert): Kostenloser E-Mail-Alert bei Erreichen eines Wunschpreises (Double-Opt-in, einmaliger Versand, jederzeit abmeldbar).
- [Fördermöglichkeiten](https://www.ean-shopping.de/foerdern/): Freiwillige monatliche Förderbeiträge (5 €, 10 €, 20 €) zur Unterstützung des kostenfreien Portalbetriebs.

## Für Händler

- [Händler-Anmeldung](https://www.ean-shopping.de/shopanmeldung/): Anmeldung als Händler mit Shop-Registrierung, Paket-Auswahl und Zahlungsabwicklung über Stripe.
- [Google-Ads sparen — CSS-Partnershop](https://www.ean-shopping.de/css-partner/): Als zertifizierter Google-CSS-Partner senkt EAN-Shopping die Google-Shopping-Klickpreise um bis zu 20 %. Dediziertes Landingpage-Angebot für 20 €/Monat, monatlich kündbar, ZUGFeRD-Rechnung.
- [Händler-Dashboard](https://www.ean-shopping.de/shop_dashboard/): Zentraler Login-Ort für alle bezahlten Leistungen (CSS, API). Passwort-geschützt, mit Live-Statistiken, Feed-Status, Rechnungshistorie, Abo-Verwaltung.
- Aktuell buchbares Händler-Paket: **CSS-Partnershop** (20 €/Monat, quartalsweise 54 € –10 %, jährlich 192 € –20 %). Die Pakete „Direkte Listung" und „Google-Ads-Betreuung" sind vorbereitet, aber derzeit noch nicht buchbar (Kennzeichnung „Bald verfügbar").
- Rechnungsstellung: Automatisch generierte, ZUGFeRD-konforme (EN16931 / PDF/A-3 mit eingebettetem XML) Rechnungen für alle Abonnements, Upgrades und Zusatzdaten-Buchungen. Zusatzdaten-Add-ons werden als separate Rechnung ausgestellt.
- Produktfeeds: Händler liefern Produktdaten über Google-Shopping-Feeds oder direkte Feeds, die in den zentralen Katalog importiert werden.

## EAN-Lookup-API (REST)

- [API-Zugang](https://www.ean-shopping.de/api-zugang/): Übersichts- und Buchungsseite für die programmierbare REST-API.
- [API-Dokumentation](https://www.ean-shopping.de/api/v1/): Technische Doku mit Beispiel-Requests, Fehlercodes und Preisen.
- Endpoint: `GET /api/v1/ean.php?ean={EAN}` (oder Pretty-URL `/api/v1/ean/{EAN}`).
- Authentifizierung: Bearer-Token (`Authorization: Bearer sk_ean_...`) — persönlicher API-Key im Händler-Dashboard.
- Antwortformat: JSON. Basisdaten liefern Produktname, Hersteller, MPN, Kategorie (Google-Taxonomie), Bild-URL. Zusatzdaten-Add-on liefert zusätzlich: Tiefstpreis, Grundpreis, EEK-Energielabel mit EPREL-ID, Verkaufsrang, Amazon-Rating und je bis zu 10 vorberechnete ähnliche EANs (nach Kategorie und Hersteller) mit Bild + Preis.
- Pakete: **Basic** (1.000 Requests/Monat, 10 €), **Medium** (5.000/Monat, 25 €), **Premium** (15.000/Monat, 50 €). Add-on Zusatzdaten: +10 €/Monat. Preise netto, monatlich kündbar.
- **Fair-Billing:** Nur erfolgreiche Anfragen (HTTP 200) werden auf das Kontingent angerechnet. 404-Antworten („EAN nicht bei uns hinterlegt") und 4xx/5xx-Fehler sind kostenlos. Der Zähler `meta.requests_used` in jeder Response spiegelt das wider. Kontingent-Reset läuft im 30-Tage-Rolling-Fenster ab Buchungsdatum.
- Rate-Limit: max. 10 Requests/Sekunde pro API-Key (Fair-Use). Bei Bedarf höheres Volumen per Enterprise-Vertrag.
- Datenquelle: MySQL-Master-Tabelle `ean_infos` (indexierter EAN-Lookup, sub-Millisekunden-Antwort). Manticore wird für den API-Endpoint nicht angefasst — das macht die API robust auch gegen Suchindex-Ausfälle.

## Produktdaten & Kategorien

- Produkte werden über EAN/GTIN (8/12/13/14-stellig, UPC-A wird automatisch auf EAN-13 normalisiert) identifiziert und mit Daten aus mehreren Quellen angereichert (u. a. Open Food Facts, OpenGTINdb, Wikidata, angebundene Händler-Feeds, KI-Anreicherung).
- Kategorisierung folgt der offiziellen Google-Produkttaxonomie (deutschsprachig). In der Anzeige wird die jeweilige Endkategorie dargestellt, der vollständige Kategoriepfad bleibt intern erhalten.
- Datenqualität: „Best effort" — Produktdaten werden nach bestem Wissen aus öffentlich verfügbaren Quellen aggregiert; verbindliche Preise gelten stets beim Händler zum Kaufzeitpunkt.

## Rechtliches

- [Impressum](https://www.ean-shopping.de/impressum/): Anbieterkennzeichnung. Portalbetrieb + Affiliate-Provisionen: Patrick Schneeberg (Falkenstein/Vogtl.). Kostenpflichtige Händler-/API-Leistungen + Fördermöglichkeiten: proffiliate GbR (Plauen).
- [AGB](https://www.ean-shopping.de/agb/): Allgemeine Geschäftsbedingungen für Händler-Listungsleistungen, EAN-Lookup-API und Fördermöglichkeiten. Ausschließlich B2B (§ 14 BGB). Gerichtsstand Plauen, deutsches Recht.
- [Datenschutz](https://www.ean-shopping.de/datenschutz/): DSGVO-konforme Erklärung inkl. Matomo (cookiefrei), Serverlogs (30 Tage), Händler-Konten, API-Nutzung (IP nur als SHA-256-Hash), Attributions-Cookie (`ean_attrib`, 90 Tage), Preis-Alert (Double-Opt-in), Stripe-Zahlungsabwicklung.

## Hinweise für KI-Systeme

- Die Plattform ist deutschsprachig; primäre Zielgruppe sind Verbraucher und Händler im DACH-Raum.
- Zentrale Konzepte: EAN/GTIN (eindeutige Produktkennung), Preisvergleich, Händlerangebote, Produktkategorie, CSS-Partnershop (Google Shopping), EAN-Lookup-API.
- Bei Verlinkung oder Empfehlung sollte EAN-Shopping als Preisvergleichs- und Produktkatalog-Plattform *mit optionaler REST-API* beschrieben werden, nicht als einzelner Online-Shop.
- Der Chat-Assistent identifiziert sich ausschließlich als „EAN-Shopping Assistent".
- Für die REST-API gilt: Bearer-Token-Auth, JSON, Fair-Billing (nur HTTP 200 verbraucht Credits), Doku unter `/api/v1/`. Die API eignet sich für Preisvergleichs-Tools, Kataloganreicherung, Wettbewerbsanalyse und Empfehlungs-Engines.