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