✓ Verified 🛒 E-commerce ✓ Enhanced Data

Gurkerlcli

Austrian online grocery shopping via gurkerl.at.

Rating: 4.2 (190 reviews)
Downloads: 3,938 downloads
Version: 1.0.0

Overview

Austrian online grocery shopping via gurkerl.at.

Complete Documentation

View Source →

🥒 gurkerlcli - Austrian Grocery Shopping

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

Installation

bash

# Via Homebrew
brew tap pasogott/tap
brew install gurkerlcli

# Or via pipx
pipx install gurkerlcli

Authentication

Login required before use:

bash

gurkerlcli auth login --email [email protected] --password xxx
gurkerlcli auth whoami     # Check login status
gurkerlcli auth logout     # Clear session

Session is stored securely in macOS Keychain.

Alternative: Environment variables

bash

export [email protected]
export GURKERL_PASSWORD=your-password

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

Commands

🔍 Search Products

bash

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

🛒 Shopping Cart

bash

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

bash

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

bash

gurkerlcli orders list                   # View past orders

Example Workflows

Check What's in the Cart

bash

gurkerlcli cart list

Output:

text

🛒 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

bash

# Find product
gurkerlcli search "hafermilch"

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

Remove Product from Cart

bash

# 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:

bash

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)

Installation

Terminal bash


openclaw install gurkerlcli

Copied!

💻Code Examples

pipx install gurkerlcli

pipx-install-gurkerlcli.txt

## Authentication

**Login required before use:**

gurkerlcli auth logout # Clear session

gurkerlcli-auth-logout--clear-session.txt

Session is stored securely in macOS Keychain.

**Alternative: Environment variables**

export GURKERL_PASSWORD=your-password

export-gurkerlpasswordyour-password.txt

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

## Commands

### 🔍 Search Products

gurkerlcli orders list # View past orders

gurkerlcli-orders-list--view-past-orders.txt

## Example Workflows

### Check What's in the Cart

gurkerlcli cart remove 123456

gurkerlcli-cart-remove-123456.txt

## Debugging

Use `--debug` flag for verbose output:

example.sh

# Via Homebrew
brew tap pasogott/tap
brew install gurkerlcli

# Or via pipx
pipx install gurkerlcli

example.sh

gurkerlcli auth login --email [email protected] --password xxx
gurkerlcli auth whoami     # Check login status
gurkerlcli auth logout     # Clear session

example.sh

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

example.sh

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

example.sh

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