Files

T

Moritz Graf 9d890a290f feat(skills): add marktguru supermarket offer and price comparison skill

Introduce the marktguru agent skill and MCP integration for searching supermarket deals, comparing product prices, and querying supported retail chains:
- Add Marktguru API client and MCP server script
- Add skill definition (SKILL.md) and supported supermarkets reference
- Add test suite covering Marktguru API integration and offer queries

2026-10-05 21:20:16 +02:00

3.8 KiB

Raw Blame History

Unterstützte Supermärkte & Händler (Marktguru)

Über die Marktguru-Schnittstelle können Werbeprospekte, Wochenangebote und Rabattaktionen von über 450 Handelsketten und Einzelhändlern in Deutschland abgefragt werden.

1. Discounter

Discounter machen einen Großteil der wöchentlich wechselnden Prospektaktionen aus. Marktguru unterscheidet sauber zwischen den Ketten:

Kette	Marktguru ID	Typischer Aktionsrhythmus	App-Vorteile erfasst?
ALDI SÜD	`127153`	Mo. & Do. / Fr. & Sa.	Ja (ALDI App Angebote)
ALDI NORD	`127139`	Mo. & Do. / Fr. & Sa.	Ja
Lidl	`126679`	Mo.–Sa. / Do.–Sa. / Fr.–Sa.	Ja (`loyalty_app_required` für Lidl Plus)
PENNY	`126765`	Mo.–Sa. / Do.–Sa.	Ja (Penny App / Payback)
Netto Marken-Discount	`126735`	Mo.–Sa. / Do.–Sa.	Ja (Netto App / DeutschlandCard)
Netto (mit Hund)	`126734`	Mo.–Sa. (primär Ost-/Norddeutschland)	Ja
NORMA	`126745`	Mo. & Mi. / Fr. & Sa.	Ja

2. Vollsortimenter & Supermärkte

Hier gibt es oft filialgenaue oder regionale Prospekte. Die API filtert automatisch anhand der übergebenen Postleitzahl (PLZ):

Kette	Marktguru ID	Besonderheiten
EDEKA	`127093`	Nationale & regionale Angebote; Marktguru aggregiert auch selbstständige Kaufleute (z.B. EDEKA Simmel, Zurheide, Niemerszein).
E center	`126699`	Großformatige EDEKA-Märkte mit erweitertem Non-Food- und Frischeangebot.
REWE	`126802`	Bundesweite Angebote sowie regionale Aktionen.
REWE Center	`126804`	Großflächenmärkte von REWE.
nahkauf	`137320`	Nachbarschaftsmärkte der REWE Group.
HIT	`126598`	Große Frische-Supermärkte (Dohle Handelsgruppe).
tegut	`126866`	Fokus auf Bio, Nachhaltigkeit und Regionales (Hessen, Bayern, Thüringen).

3. Großfläche & SB-Warenhäuser (Hypermarkets)

Kette	Marktguru ID	Besonderheiten
Kaufland	`126654`	Riesiges wöchentliches Prospektangebot (Lebensmittel + Non-Food, Kaufland Card).
Globus	`127177`	SB-Warenhäuser mit eigener Metzgerei und Bäckerei.

4. Drogeriemärkte

Drogerieprospekte enthalten neben Pflege- und Haushaltsartikeln auch viele Bio-Lebensmittel, Snacks, Kaffee und Babynahrung:

Kette	Marktguru ID	Typische Angebote
dm-drogerie markt	`127057`	dmBio, Drogeriewaren, Tiernahrung.
ROSSMANN	`126811`	EnerBio, Kaffeeangebote, wöchentliche 10%-Coupons.
Müller Drogeriemarkt	`126720`	Drogerie, Parfümerie, Spielwaren, Naturshop.
budni	`126944`	Primär im Norden (Metropolregion Hamburg).

5. Getränkemärkte & Bio-Fachmärkte

Kette	Marktguru ID	Sortiment
Netto Getränke-Discount	`134009`	Bier, Mineralwasser, Softdrinks.
Denns BioMarkt / Alnatura	Diverse	Bio-Vollsortiment, Wochenaktionen.

6. Unterstützte Aliase im Client & MCP Server

Wenn im Tool-Aufruf der Parameter supermarkets übergeben wird, werden folgende umgangssprachliche Bezeichnungen automatisch auf die korrekten Retailer-IDs gemappt:

{
  "aldi": [127153, 127139],       // Findet automatisch ALDI SÜD und ALDI NORD
  "aldi süd" / "aldi sued": [127153],
  "aldi nord": [127139],
  "lidl": [126679],
  "edeka": [127093, 126699],      // EDEKA und E center
  "rewe": [126802, 126804],       // REWE und REWE Center
  "kaufland": [126654],
  "penny": [126765],
  "netto": [126735, 126734],      // Netto Marken-Discount und Netto (mit Hund)
  "norma": [126745],
  "globus": [127177],
  "dm": [127057],
  "rossmann": [126811],
  "müller" / "mueller": [126720],
  "hit": [126598],
  "tegut": [126866],
  "nahkauf": [137320]
}

3.8 KiB Raw Blame History Unescape Escape