Marktguru Grocery Deals

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

Quick Reference

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

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

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

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/..."
    }
  ]
}

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

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