AgentSkillsCN

gurkerlcli

通过gurkerl.at进行奥地利在线杂货购物。当用户询问“杂货”、“购物”、“订购食品”、“Gurkerl”、购物车，或想在奥地利在线搜索/订购食品时使用。

SKILL.md
--- frontmatter
name: gurkerlcli
version: 0.1.6
description: 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.
tools: [bash]

🥒 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 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

bash
export GURKERL_EMAIL=your-email@example.com
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:

code
🛒 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)

Links