gurkerlcli

What This Skill Does

The gurkerlcli skill acts as a bridge between your terminal or AI agent and the popular Austrian online grocery platform, gurkerl.at. Designed specifically for the Austrian market, it allows you to automate your grocery shopping routine, check product availability, manage your digital shopping cart, and view your purchase history without ever opening a web browser. By leveraging this skill, you can transform complex grocery errands into simple command-line interactions or natural language requests.

Installation

Installation is streamlined for macOS and Linux users. For macOS, you can use Homebrew to tap the repository and install the binary directly:

brew tap pasogott/tap
brew install gurkerlcli

Alternatively, if you prefer using pipx to manage your Python-based CLI tools, you can simply run:

pipx install gurkerlcli

Once installed, you must authenticate. You can perform a secure login using gurkerlcli auth login --email <email> --password <password>, which saves your session in the system keychain, or define environment variables GURKERL_EMAIL and GURKERL_PASSWORD for headless or CI/CD environments.

Use Cases

• Automated Replenishment: Integrate the skill into a morning script to check if your recurring "Wocheneinkauf" items are available.
• Voice-Activated Shopping: Use OpenClaw to search for items while you are busy in the kitchen and add them directly to your cart.
• Smart Inventory Management: Quickly check if you are meeting the minimum order requirements or view previous orders to repeat a purchase.
• Scripting & Analytics: Pipe search results to other tools using the --json flag to track price changes or product availability over time.

Example Prompts

1. "Find some organic milk and add two cartons to my shopping cart."
2. "Show me what is currently in my cart and let me know if I have reached the minimum order value for delivery."
3. "Search for apples on Gurkerl and show me the first five results."

Tips & Limitations

• Region Lock: This skill is strictly for gurkerl.at and is only functional within Austria. Ensure your account settings match your delivery region.
• Authentication: Always prioritize secure storage like the macOS Keychain over environment variables where possible to prevent credential exposure in shell history.
• Debugging: If you encounter unexpected behavior, run your command with the --debug flag to inspect the API request and response cycle, which is invaluable for troubleshooting connectivity issues or site changes.