gurkerlcli

Austrian online grocery shopping via gurkerl.at. Use when user asks about "groceries", "Einkauf", "Lebensmittel bestellen", "Gurkerl", shopping cart, or wants to search/order food online in Austria.

⭐3stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill provides a specialized command-line interface for gurkerl.at, Austria's leading online grocery service. It enables users to search for products, manage shopping carts, and organize shopping lists directly through Claude, significantly streamlining the grocery procurement process for residents in Vienna, Graz, and Linz by bridging the gap between conversational AI and e-commerce.

Use Cases

  • Search for specific grocery items like 'bio milch' or 'äpfel' to check real-time availability, pricing, and active discounts.
  • Manage a digital shopping cart by adding items with specific quantities or removing products to reach the minimum order threshold of €39.00.
  • Access and organize personalized shopping lists for recurring household needs or weekly meal prep planning.
  • Review past order history to quickly identify and reorder favorite products without navigating the full website.
  • Integrate grocery data into larger automation workflows using the tool's JSON output capabilities for custom inventory tracking.
namegurkerlcli
version0.1.6
descriptionAustrian online grocery shopping via gurkerl.at. Use when user asks about "groceries", "Einkauf", "Lebensmittel bestellen", "Gurkerl", shopping cart, or wants to search/order food online in Austria.
tools[bash]

🥒 gurkerlcli - Austrian Grocery Shopping

Command-line interface for gurkerl.at online grocery shopping (Austria only).

Installation

# Via Homebrew
brew tap pasogott/tap
brew install gurkerlcli

# Or via pipx
pipx install gurkerlcli

Authentication

Login required before use:

gurkerlcli auth login --email user@example.com --password xxx
gurkerlcli auth whoami     # Check login status
gurkerlcli auth logout     # Clear session

Session is stored securely in macOS Keychain.

Alternative: Environment variables

export GURKERL_EMAIL=your-email@example.com
export GURKERL_PASSWORD=your-password

Or add to ~/.env.local for persistence.

Commands

🔍 Search Products

gurkerlcli search "bio milch"
gurkerlcli search "äpfel" --limit 10
gurkerlcli search "brot" --json          # JSON output for scripting

🛒 Shopping Cart

gurkerlcli cart list                     # View cart contents
gurkerlcli cart add <product_id>         # Add product
gurkerlcli cart add <product_id> -q 3    # Add with quantity
gurkerlcli cart remove <product_id>      # Remove product
gurkerlcli cart clear                    # Empty cart (asks for confirmation)
gurkerlcli cart clear --force            # Empty cart without confirmation

📝 Shopping Lists

gurkerlcli lists list                    # Show all lists
gurkerlcli lists show <list_id>          # Show list details
gurkerlcli lists create "Wocheneinkauf"  # Create new list
gurkerlcli lists delete <list_id>        # Delete list

📦 Order History

gurkerlcli orders list                   # View past orders

Example Workflows

Check What's in the Cart

gurkerlcli cart list

Output:

🛒 Shopping Cart
┌─────────────────────────────────┬──────────────┬───────────────┬──────────┐
│ Product                         │          Qty │         Price │ Subtotal │
├─────────────────────────────────┼──────────────┼───────────────┼──────────┤
│ 🥛 nöm BIO-Vollmilch 3,5%       │     2x 1.0 l │ €1.89 → €1.70 │    €3.40 │
│ 🧀 Bergbaron                    │     1x 150 g │         €3.99 │    €3.99 │
├─────────────────────────────────┼──────────────┼───────────────┼──────────┤
│                                 │              │        Total: │    €7.39 │
└─────────────────────────────────┴──────────────┴───────────────┴──────────┘

⚠️  Minimum order: €39.00 (€31.61 remaining)

Search and Add to Cart

# Find product
gurkerlcli search "hafermilch"

# Add to cart (use product ID from search results)
gurkerlcli cart add 123456 -q 2

Remove Product from Cart

# List cart to see product IDs
gurkerlcli cart list --json | jq '.items[].product_id'

# Remove specific product
gurkerlcli cart remove 123456

Debugging

Use --debug flag for verbose output:

gurkerlcli cart add 12345 --debug
gurkerlcli cart remove 12345 --debug

Tips

  • Minimum order: €39.00 for delivery
  • Delivery slots: Check gurkerl.at website for available times
  • Sale items: Prices with arrows (€1.89 → €1.70) indicate discounts
  • JSON output: Use --json flag for scripting/automation

Limitations

  • ⏳ Checkout not yet implemented (use website)
  • 🇦🇹 Austria only (Vienna, Graz, Linz areas)
  • 🔐 Requires active gurkerl.at account

Changelog

  • v0.1.6 - Fix cart remove (use DELETE instead of POST)
  • v0.1.5 - Fix cart add for existing items (use POST instead of PUT)