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 |

### Orders
| Tool | Description |
|------|-------------|
| `fetch_orders` | Get order history. Params: `limit`, `order_type` (delivered/upcoming/both), `date_from`, `date_to` |
| `repeat_order` | Reorder: `{"order_id":12345678}` |
| `cancel_order` | Cancel upcoming order (two-step: first `customer_confirmed:false`, then `true`) |
| `get_alternative_timeslots` | Get available delivery times |
| `change_order_timeslot` | Change delivery slot |

### Recipes
| Tool | Description |
|------|-------------|
| `search_recipes_by_vector_similarity` | Semantic recipe search |
| `get_recipe_detail` | Full recipe with ingredients mapped to products |
| `generate_recipe_with_ingredients_search` | AI-generated recipes with product matches |
| `get_recipes_navigation` | Browse recipe categories |

### User & Favorites
| Tool | Description |
|------|-------------|
| `get_user_info` | Account profile |
| `get_user_credits` | Available credits/vouchers |
| `get_user_addresses` | Saved delivery addresses |
| `get_all_user_favorites` | All favorited products |
| `get_user_shopping_lists_preview` | List all shopping lists |
| `get_user_shopping_list_detail` | View list contents |
| `create_shopping_list` | Create new list |
| `add_products_to_shopping_list` | Add product to list |

### Customer Care
| Tool | Description |
|------|-------------|
| `submit_claim` | File warranty claim for missing/damaged items |
| `get_customer_support_contact_info` | Phone, email, WhatsApp |
| `get_user_reusable_bags_info` | Check bag deposit status |
| `adjust_user_reusable_bags` | Correct bag count |

### Other
| Tool | Description |
|------|-------------|
| `calculate_average_user_order` | Generate typical order from history |
| `get_faq_content` | FAQ for: general, xtra_general, xtra_price, baby_club, christmas |
| `fetch_all_job_listings` | Career opportunities |

## Search Tips

- Use **German** keywords for Austrian Gurkerl: "Milch", "Brot", "Eier", "Käse"
- Filters available: `news` (new products), `sales` (on sale)
- Sort: `orderPriceAsc`, `orderPriceDesc`, `recommended` (default)
- Include nutrition: `"include_nutritions":true`
- Include allergens: `"include_allergens":true`

## Example Workflows

### Weekly Shopping
```bash
# Check what's on sale
gurkerl search_products '{"filters":[{"filterSlug":"sales","valueSlug":"sales"}]}'

# Add milk to cart
gurkerl search_products '{"keyword":"Milch"}'  # Get product ID
gurkerl add_items_to_cart '{"items":[{"productId":MILK_ID,"quantity":2}]}'

# Review cart
gurkerl get_cart
```

### Reorder Last Order
```bash
gurkerl fetch_orders '{"limit":1}'  # Get order ID
gurkerl repeat_order '{"order_id":ORDER_ID}'
```

### Find Recipe & Add Ingredients
```bash
gurkerl search_recipes_by_vector_similarity '{"query":"schnelles Abendessen"}'
gurkerl get_recipe_detail '{"recipe_id":RECIPE_ID,"include_product_mapping":true}'
# Add matched products to cart
```