shield_lock
JinDaGe
Contact
โ† Back to skills
extension
Category: Development & EngineeringAPI key required

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.

personAuthor: pasogotthubclawhub
open_in_newRepositorydownloadDownload package

๐Ÿฅ’ 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)

Links