gurkerl

# Gurkerl.at MCP Skill

Austrian grocery delivery service (part of Rohlik Group). Search products, manage your cart, view orders, browse recipes, and more.

> **Note:** This skill uses Gurkerl's official MCP server. The same approach works for other Rohlik Group brands (Rohlik.cz, Knuspr.de, Kifli.hu) — just change the MCP URL in the script.

## Setup

Set environment variables:
```bash
export GURKERL_EMAIL="your@email.com"
export GURKERL_PASS="your-password"
```

For persistent access, add to `~/.config/systemd/user/clawdbot-gateway.service.d/gurkerl.conf`:
```ini
[Service]
Environment="GURKERL_EMAIL=your@email.com"
Environment="GURKERL_PASS=your-password"
```

## CLI Usage

```bash
# Search products (German keywords)
gurkerl search_products '{"keyword":"Milch"}'
gurkerl search_products '{"keyword":"Bio Eier","sort_type":"orderPriceAsc"}'

# Get cart
gurkerl get_cart

# Add to cart
gurkerl add_items_to_cart '{"items":[{"productId":1234567,"quantity":2}]}'

# View orders
gurkerl fetch_orders '{"limit":3}'
gurkerl fetch_orders '{"order_type":"upcoming"}'

# Search recipes
gurkerl search_recipes_by_vector_similarity '{"query":"vegetarisch schnell"}'
```

## Available Tools

### Products & Search
| Tool | Description |
|------|-------------|
| `search_products` | Search by keyword, filters, sort. Use German keywords. |
| `get_products_details_batch` | Get details for multiple product IDs |
| `get_product_composition` | Nutritional info, allergens, ingredients |
| `get_category_products` | Browse products in a category |
| `get_main_categories` | List store categories |
| `get_brands_navigation` | List available brands |

### Cart
| Tool | Description |
|------|-------------|
| `get_cart` | View current cart |
| `add_items_to_cart` | Add products: `{"items":[{"productId":123,"quantity":1}]}` |
| `update_cart_item` | Change quantity: `{"product_id":123,"quantity":3}` |
| `remove_cart_item` | Remove item: `{"product_id":123}` |
| `clear_cart` | Empty entire cart |

### Or...