Awesome-omni-skill marktguru-grocery-deals

Look up grocery deals and offers via Marktguru CLI/API. Use when user asks about supermarket discounts, product prices, current promotions, or comparing deals across Austrian retailers (Hofer, Billa, Spar, Lidl, etc.).

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/development/marktguru-grocery-deals" ~/.claude/skills/diegosouzapw-awesome-omni-skill-marktguru-grocery-deals && rm -rf "$T"

manifest: skills/development/marktguru-grocery-deals/SKILL.md

source content

Marktguru Grocery Deals

Query Austrian grocery deals from Marktguru. Supports raw queries, structured search building, retailer filtering, and ZIP-code location targeting.

Quick Reference

Command	Purpose
`search raw <query>`	Search with raw query string
`search build`	Build query from structured flags
`search syntax`	Show supported query syntax
`set-zip <code>`	Set default ZIP code
`config`	Show current configuration
`login`	Extract API key from marktguru.at

Setup

Login (HTTP scan)

npx marktguru-cli login

Scans site HTML and boot scripts for embedded API keys. No browser automation required.

Set Default ZIP Code

npx marktguru-cli set-zip 1010
npx marktguru-cli set-zip 8010  # Graz

Check Config

npx marktguru-cli config
npx marktguru-cli config --json

Search Commands

Raw Query Search

npx marktguru-cli search raw "Milch"
npx marktguru-cli search raw "Milch" --limit 5
npx marktguru-cli search raw "Bier" --retailer HOFER
npx marktguru-cli search raw "Brot" --zip 8010
npx marktguru-cli search raw "Cola" --json

Common Options

Flag	Description	Default
`--limit <n>` / `-n`	Number of results	10
`--retailer <name>` / `-r`	Filter by retailer (e.g., SPAR, BILLA, HOFER)	all
`--zip <code>` / `-z`	ZIP code for location-based results	config default
`--json` / `-j`	Output JSON	false

Structured Builder

Build queries from flags instead of raw strings:

npx marktguru-cli search build --term butter --explain
npx marktguru-cli search build --or butter --or margarine --explain
npx marktguru-cli search build --phrase "frische milch" --limit 5
npx marktguru-cli search build --wildcard "jogh*" --retailer SPAR

Flag	Description
`--term <value>`	Add a search term
`--phrase <value>`	Add exact phrase (quoted)
`--wildcard <value>`	Add wildcard term (e.g., `kell*` )
`--or <value>`	Add term to OR group (repeat for multiple)
`--group <value>`	Add raw parenthesized group
`--explain`	Print the built query to stderr

Query Syntax

Supported:

```
OR
```
— boolean OR:
```
Milch OR Sahne
```
```
*
```
— wildcard:
```
Jogh*
```
(matches Joghurt, Joghurtdrink, etc.)
```
"..."
```
— exact phrase:
```
"frische Milch"
```
```
()
```
— grouping:
```
(Milch OR Sahne) Bio
```

NOT supported:

AND

NOT

Examples

# Simple term
npx marktguru-cli search raw "Butter"

# OR logic
npx marktguru-cli search raw "Käse OR Schinken"

# Wildcard
npx marktguru-cli search raw "Bio*"

# Combined with retailer filter
npx marktguru-cli search raw "Bier" --retailer HOFER --limit 10

# Exact phrase
npx marktguru-cli search raw '"Coca Cola"'

Known Retailers

Retailer	Notes
SPAR
INTERSPAR	Larger SPAR format
SPAR-Gourmet	Premium SPAR
BILLA
BILLA PLUS	Larger BILLA format
HOFER	Austrian Aldi
Lidl
PENNY
dm drogerie markt	Drugstore (some food items)
BIPA	Drugstore

JSON Output

npx marktguru-cli search raw "Cola" --limit 3 --json

{
  "query": "Cola",
  "total": 23,
  "offers": [
    {
      "title": "Coca-Cola - Cola - oder Fanta 1,5l",
      "price": 1.49,
      "retailer": "Sizin Foods GmbH",
      "expires": "2026-02-11",
      "discountPercent": null
    },
    {
      "title": "Coca-Cola - Cola - Zero / Fanta / Sprite Dose 330ml",
      "price": 0.6,
      "retailer": "Sizin Foods GmbH",
      "expires": "2026-02-11",
      "discountPercent": null
    },
    {
      "title": "Coca-Cola - Cola - div. Sorten 0,33 Liter",
      "price": 0.67,
      "retailer": "BILLA",
      "expires": "2026-02-11",
      "discountPercent": 50,
      "externalUrl": "https://shop.billa.at/produkte/..."
    }
  ]
}

Field	Description
`title`	Product name and brand
`price`	Current offer price (EUR)
`retailer`	Store name
`expires`	Offer expiration date (YYYY-MM-DD)
`discountPercent`	Discount percentage (null if not on sale)
`externalUrl`	Direct link to retailer (optional)

Human-Readable Output

Found 147 offers for "Milch":

Premium Bergbauern H-Milch [Salzburg Milch]
  💰 €0.99 (was €1.59) -38% · €0.99/l
  📦 3,5% Fett oder 0,5% Fett aus Österreich, 1 Liter
  🏪 SPAR · 20 days left

📍 Retailers: Lidl (33), SPAR (30), PENNY (17), INTERSPAR (16), BILLA PLUS (11)

Config

Credentials and settings stored at

~/.marktguru/config.json

npx marktguru-cli config --json

{
  "apiKey": "pCcm1AVCYa...",
  "apiKeySet": true,
  "zipCode": "1010",
  "configPath": "/Users/.../.marktguru/config.json"
}

Troubleshooting

Issue	Solution
Login fails	Site structure may have changed. Re-run `login` or check for CLI updates.
No results	Try broader terms, wildcards ( `*` ), or alternative spellings.
Wrong location	Set ZIP code with `set-zip` or use `--zip` flag.
API key expired	Re-run `npx marktguru-cli login` to refresh.

Usage Tips

Compare prices: Use
```
--json
```
output to programmatically compare across retailers
Find best deals: Look for high
```
discountPercent
```
values
Check availability: Use
```
--zip
```
with local ZIP code for accurate results
Wildcards for variants: Use
```
Jogh*
```
to catch Joghurt, Joghurtdrink, etc.
OR for alternatives:
```
Butter OR Margarine
```
to compare substitutes