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
This commit is contained in:
@@ -0,0 +1,94 @@
|
||||
# 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:
|
||||
|
||||
```json
|
||||
{
|
||||
"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]
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user