Skip to content

SKILL.md

Latest commit

 

History

History
235 lines (182 loc) · 5.79 KB

SKILL.md

File metadata and controls

235 lines (182 loc) · 5.79 KB
name marktguru-grocery-deals
description 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 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

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