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.).

diegosouzapw Updated Sep 8, 2026 54 repo stars

Integrations & APIs

Install

Press C to copy

$ npx skillmds@latest add diegosouzapw/marktguru-grocery-deals

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

＋ Add to plugin

README badge

[![SkillMD](https://skillmd.com/badge/diegosouzapw/marktguru-grocery-deals.svg)](https://skillmd.com/skills/diegosouzapw/marktguru-grocery-deals)

Trust & safety

1 of 3 audits passed

Last audited Sep 24, 2026 · commit 36af9a6

Permissions this skill uses

Makes network calls
The instructions fetch remote URLs or call external services.
Reads secrets
The instructions read tokens, keys, or other credentials.

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

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

---name: marktguru-grocery-dealsdescription: 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.).---# Marktguru Grocery DealsQuery 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)```bashnpx marktguru-cli login```Scans site HTML and boot scripts for embedded API keys. No browser automation required.### Set Default ZIP Code```bashnpx marktguru-cli set-zip 1010npx marktguru-cli set-zip 8010 # Graz```### Check Config```bashnpx marktguru-cli confignpx marktguru-cli config --json```---## Search Commands### Raw Query Search```bashnpx marktguru-cli search raw "Milch"npx marktguru-cli search raw "Milch" --limit 5npx marktguru-cli search raw "Bier" --retailer HOFERnpx marktguru-cli search raw "Brot" --zip 8010npx 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 BuilderBuild queries from flags instead of raw strings:```bashnpx marktguru-cli search build --term butter --explainnpx marktguru-cli search build --or butter --or margarine --explainnpx marktguru-cli search build --phrase "frische milch" --limit 5npx 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```bash# Simple termnpx marktguru-cli search raw "Butter"# OR logicnpx marktguru-cli search raw "Käse OR Schinken"# Wildcardnpx marktguru-cli search raw "Bio*"# Combined with retailer filternpx marktguru-cli search raw "Bier" --retailer HOFER --limit 10# Exact phrasenpx 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```bashnpx marktguru-cli search raw "Cola" --limit 3 --json``````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)```---## ConfigCredentials and settings stored at `~/.marktguru/config.json`.```bashnpx marktguru-cli config --json``````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 Tips1. **Compare prices:** Use `--json` output to programmatically compare across retailers2. **Find best deals:** Look for high `discountPercent` values3. **Check availability:** Use `--zip` with local ZIP code for accurate results4. **Wildcards for variants:** Use `Jogh*` to catch Joghurt, Joghurtdrink, etc.5. **OR for alternatives:** `Butter OR Margarine` to compare substitutes

diegosouzapw/awesome-omni-skill/tree/main/skills/development/marktguru-grocery-deals commit 36af9a62ab

Frequently asked questions

npx skillmds@latest add diegosouzapw/marktguru-grocery-deals