{"skill":{"slug":"gurkerl","displayName":"Gurkerl","summary":"Gurkerl.at grocery shopping via MCP - search products, manage cart, orders, recipes, favorites.","description":"---\nname: gurkerl\ndescription: Gurkerl.at grocery shopping via MCP - search products, manage cart, orders, recipes, favorites.\nhomepage: https://www.gurkerl.at/seite/mcp-server\nmetadata:\n  clawdbot:\n    emoji: \"🥒\"\n    requires:\n      bins: [\"curl\", \"jq\"]\n    env:\n      - GURKERL_EMAIL\n      - GURKERL_PASS\n    tags:\n      - grocery\n      - shopping\n      - austria\n      - mcp\n      - rohlik\n      - delivery\n---\n\n# Gurkerl.at MCP Skill\n\nAustrian grocery delivery service (part of Rohlik Group). Search products, manage your cart, view orders, browse recipes, and more.\n\n> **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.\n\n## Setup\n\nSet environment variables:\n```bash\nexport GURKERL_EMAIL=\"your@email.com\"\nexport GURKERL_PASS=\"your-password\"\n```\n\nFor persistent access, add to `~/.config/systemd/user/openclaw-gateway.service.d/gurkerl.conf`:\n```ini\n[Service]\nEnvironment=\"GURKERL_EMAIL=your@email.com\"\nEnvironment=\"GURKERL_PASS=your-password\"\n```\n\n## CLI Usage\n\n```bash\n# Search products (German keywords) — use batch_search_products with queries array\ngurkerl batch_search_products '{\"queries\":[{\"keyword\":\"Milch\"}]}'\ngurkerl batch_search_products '{\"queries\":[{\"keyword\":\"Bio Eier\",\"sort_type\":\"orderPriceAsc\"}]}'\n\n# Search multiple products at once (more efficient)\ngurkerl batch_search_products '{\"queries\":[{\"keyword\":\"Milch\"},{\"keyword\":\"Brot\"},{\"keyword\":\"Eier\"}]}'\n\n# Get cart\ngurkerl get_cart\n\n# Add to cart\ngurkerl add_items_to_cart '{\"items\":[{\"productId\":1234567,\"quantity\":2}]}'\n\n# View orders\ngurkerl fetch_orders '{\"limit\":3}'\ngurkerl fetch_orders '{\"order_type\":\"upcoming\"}'\n\n# Search recipes\ngurkerl search_recipes_by_vector_similarity '{\"query\":\"vegetarisch schnell\"}'\n```\n\n## Available Tools\n\n### Products & Search\n| Tool | Description |\n|------|-------------|\n| `batch_search_products` | Search by keyword(s). Takes `{\"queries\":[{\"keyword\":\"...\"}]}`. Each query can include `sort_type`, filters. Use German keywords. |\n| `get_products_details_batch` | Get details for multiple product IDs |\n| `get_products_composition_batch` | Nutritional info, allergens, ingredients for multiple products |\n\n### Cart\n| Tool | Description |\n|------|-------------|\n| `get_cart` | View current cart |\n| `add_items_to_cart` | Add products: `{\"items\":[{\"productId\":123,\"quantity\":1}]}` |\n| `update_cart_item` | Change quantity: `{\"product_id\":123,\"quantity\":3}` |\n| `remove_cart_item` | Remove item: `{\"product_id\":123}` |\n| `clear_cart` | Empty entire cart |\n\n### Checkout\n| Tool | Description |\n|------|-------------|\n| `get_checkout` | View checkout state |\n| `get_timeslots_checkout` | Available delivery timeslots |\n| `change_timeslot_checkout` | Select a delivery timeslot |\n| `change_checkout_packaging` | Change packaging options |\n| `update_payment_method_checkout` | Change payment method |\n| `submit_checkout` | Submit the order |\n\n### Orders\n| Tool | Description |\n|------|-------------|\n| `fetch_orders` | Get order history. Params: `limit`, `order_type` (delivered/upcoming/both), `date_from`, `date_to` |\n| `repeat_order` | Reorder: `{\"order_id\":12345678}` |\n| `cancel_order` | Cancel upcoming order (two-step: first `customer_confirmed:false`, then `true`) |\n| `get_alternative_timeslots` | Get available delivery times for existing order |\n| `change_order_timeslot` | Change delivery slot for existing order |\n| `remove_order_items` | Remove items from an upcoming order |\n\n### Recipes\n| Tool | Description |\n|------|-------------|\n| `search_recipes_by_vector_similarity` | Semantic recipe search |\n| `get_recipe_detail` | Full recipe with ingredients mapped to products |\n| `generate_recipe_with_ingredients_search` | AI-generated recipes with product matches |\n\n### User & Favorites\n| Tool | Description |\n|------|-------------|\n| `get_user_info` | Account profile |\n| `get_user_credits` | Available credits/vouchers |\n| `get_all_user_favorites` | All favorited products |\n| `get_user_shopping_lists_preview` | List all shopping lists |\n| `get_user_shopping_list_detail` | View list contents |\n| `create_shopping_list` | Create new list |\n| `add_products_to_shopping_list` | Add products to a list |\n| `remove_products_from_shopping_list` | Remove products from a list |\n| `delete_shopping_list` | Delete a shopping list |\n\n### Customer Care\n| Tool | Description |\n|------|-------------|\n| `submit_claim` | File warranty claim for missing/damaged items |\n| `submit_credit_compensation` | Request credit compensation |\n| `get_customer_support_contact_info` | Phone, email, WhatsApp |\n| `get_user_reusable_bags_info` | Check bag deposit status |\n| `adjust_user_reusable_bags` | Correct bag count |\n| `credit_customer_returnables` | Credit returnable deposits |\n| `get_customer_care_workflow_prompt` | Internal workflow guidance |\n\n### Analytics & Other\n| Tool | Description |\n|------|-------------|\n| `calculate_average_user_order` | Generate typical order from history |\n| `analyze_spending` | Spending analysis and insights |\n| `add_feedback` | Submit product/service feedback |\n| `add_karma_rating` | Rate delivery/service |\n| `get_faq_content` | FAQ for: general, xtra_general, xtra_price, baby_club, christmas |\n| `get_url_content` | Fetch content from a URL |\n| `email_support_on_user_behalf` | Send support email |\n| `fetch_all_job_listings` | Career opportunities |\n\n## Search Tips\n\n- Use **German** keywords for Austrian Gurkerl: \"Milch\", \"Brot\", \"Eier\", \"Käse\"\n- Batch multiple searches in one call for efficiency: `{\"queries\":[{\"keyword\":\"A\"},{\"keyword\":\"B\"}]}`\n- Each query object supports: `keyword`, `sort_type`, filters\n- Sort: `orderPriceAsc`, `orderPriceDesc`, `recommended` (default)\n- Filters available: `news` (new products), `sales` (on sale)\n- Include nutrition/allergens via `get_products_composition_batch` after getting product IDs\n\n## Example Workflows\n\n### Weekly Shopping\n```bash\n# Search multiple items at once\ngurkerl batch_search_products '{\"queries\":[{\"keyword\":\"Milch\"},{\"keyword\":\"Brot\"},{\"keyword\":\"Eier\"}]}'\n\n# Add to cart\ngurkerl add_items_to_cart '{\"items\":[{\"productId\":MILK_ID,\"quantity\":2},{\"productId\":BREAD_ID,\"quantity\":1}]}'\n\n# Review cart\ngurkerl get_cart\n```\n\n### Reorder Last Order\n```bash\ngurkerl fetch_orders '{\"limit\":1}'  # Get order ID\ngurkerl repeat_order '{\"order_id\":ORDER_ID}'\n```\n\n### Find Recipe & Add Ingredients\n```bash\ngurkerl search_recipes_by_vector_similarity '{\"query\":\"schnelles Abendessen\"}'\ngurkerl get_recipe_detail '{\"recipe_id\":RECIPE_ID,\"include_product_mapping\":true}'\n# Add matched products to cart\n```\n\n","tags":{"latest":"1.1.1"},"stats":{"comments":0,"downloads":2414,"installsAllTime":0,"installsCurrent":0,"stars":3,"versions":3},"createdAt":1769374035032,"updatedAt":1779076462276},"latestVersion":{"version":"1.1.1","createdAt":1774858238395,"changelog":"Fix: include bin/gurkerl CLI wrapper script (missing from 1.1.0 publish)","license":"MIT-0"},"metadata":{"setup":[{"key":"GURKERL_EMAIL","required":true},{"key":"GURKERL_PASS","required":true}],"os":null,"systems":null},"owner":{"handle":"florianbeer","userId":"s178qb3qnn3qkjvv09p3dn4v4583we9e","displayName":"Florian Beer","image":"https://avatars.githubusercontent.com/u/800047?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779916334273}}