Skill: florianbeer/gurkerl (version 1.1.1)

--- name: gurkerl description: Gurkerl.at grocery shopping via MCP - search products, manage cart, orders, recipes, favorites. homepage: https://www.gurkerl.at/seite/mcp-server metadata: clawdbot: emoji: "🥒" requires: bins: ["curl", "jq"] env: - GURKERL_EMAIL - GURKERL_PASS tags: - grocery - shopping - austria - mcp - rohlik - delivery --- # 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="[REDACTED_SECRET]" export GURKERL_PASS="your-password" ``` For persistent access, add to `~/.config/systemd/user/openclaw-gateway.service.d/gurkerl.conf`: ```ini [Service] Environment="GURKERL_EMAIL=[REDACTED_SECRET]" Environment="GURKERL_PASS=your-password" ``` ## CLI Usage ```bash # Search products (German keywords) — use batch_search_products with queries array gurkerl batch_search_products '{"queries":[{"keyword":"Milch"}]}' gurkerl batch_search_products '{"queries":[{"keyword":"Bio Eier","sort_type":"orderPriceAsc"}]}' # Search multiple products at once (more efficient) gurkerl batch_search_products '{"queries":[{"keyword":"Milch"},{"keyword":"Brot"},{"keyword":"Eier"}]}' # 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 | |------|-------------| | `batch_search_products` | Search by keyword(s). Takes `{"queries":[{"keyword":"..."}]}`. Each query can include `sort_type`, filters. Use German keywords. | | `get_products_details_batch` | Get details for multiple product IDs | | `get_products_composition_batch` | Nutritional info, allergens, ingredients for multiple products | ### 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 | ### Checkout | Tool | Description | |------|-------------| | `get_checkout` | View checkout state | | `get_timeslots_checkout` | Available delivery timeslots | | `change_timeslot_checkout` | Select a delivery timeslot | | `change_checkout_packaging` | Change packaging options | | `update_payment_method_checkout` | Change payment method | | `submit_checkout` | Submit the order | ### 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 for existing order | | `change_order_timeslot` | Change delivery slot for existing order | | `remove_order_items` | Remove items from an upcoming order | ### Recipes | Tool | Description | |------|-------------| | [REDACTED_SECRET] | Semantic recipe search | | `get_recipe_detail` | Full recipe with ingredients mapped to products | | [REDACTED_SECRET] | AI-generated recipes with product matches | ### User & Favorites | Tool | Description | |------|-------------| | `get_user_info` | Account profile | | `get_user_credits` | Available credits/vouchers | | `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 products to a list | | [REDACTED_SECRET] | Remove products from a list | | `delete_shopping_list` | Delete a shopping list | ### Customer Care | Tool | Description | |------|-------------| | `submit_claim` | File warranty claim for missing/damaged items | | `submit_credit_compensation` | Request credit compensation | | [REDACTED_SECRET] | Phone, email, WhatsApp | | `get_user_reusable_bags_info` | Check bag deposit status | | `adjust_user_reusable_bags` | Correct bag count | | `credit_customer_returnables` | Credit returnable deposits | | [REDACTED_SECRET] | Internal workflow guidance | ### Analytics & Other | Tool | Description | |------|-------------| | `calculate_average_user_order` | Generate typical order from history | | `analyze_spending` | Spending analysis and insights | | `add_feedback` | Submit product/service feedback | | `add_karma_rating` | Rate delivery/service | | `get_faq_content` | FAQ for: general, xtra_general, xtra_price, baby_club, christmas | | `get_url_content` | Fetch content from a URL | | `email_support_on_user_behalf` | Send support email | | `fetch_all_job_listings` | Career opportunities | ## Search Tips - Use **German** keywords for Austrian Gurkerl: "Milch", "Brot", "Eier", "Käse" - Batch multiple searches in one call for efficiency: `{"queries":[{"keyword":"A"},{"keyword":"B"}]}` - Each query object supports: `keyword`, `sort_type`, filters - Sort: `orderPriceAsc`, `orderPriceDesc`, `recommended` (default) - Filters available: `news` (new products), `sales` (on sale) - Include nutrition/allergens via `get_products_composition_batch` after getting product IDs ## Example Workflows ### Weekly Shopping ```bash # Search multiple items at once gurkerl batch_search_products '{"queries":[{"keyword":"Milch"},{"keyword":"Brot"},{"keyword":"Eier"}]}' # Add to cart gurkerl add_items_to_cart '{"items":[{"productId":MILK_ID,"quantity":2},{"productId":BREAD_ID,"quantity":1}]}' # 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 ```


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (MEDIUM)