名称： gurkerl
描述： 通过 MCP 使用 Gurkerl.at 进行杂货购物 - 搜索商品、管理购物车、查看订单、浏览食谱、管理收藏夹。
主页： https://www.gurkerl.at/seite/mcp-server
元数据：
clawdbot:
emoji: "🥒"
requires:
bins: ["curl", "jq"]
env:
- GURKERL_EMAIL
- GURKERL_PASS
tags:
- grocery
- shopping
- austria
- mcp
- rohlik
- delivery
Gurkerl.at MCP 技能
奥地利杂货配送服务（Rohlik Group 旗下）。支持搜索商品、管理购物车、查看订单、浏览食谱等功能。
注意： 此技能使用 Gurkerl 官方的 MCP 服务器。相同方法也适用于 Rohlik Group 旗下的其他品牌（Rohlik.cz, Knuspr.de, Kifli.hu）——只需在脚本中更改 MCP URL 即可。
设置
设置环境变量：
export GURKERL_EMAIL="your@email.com"
export GURKERL_PASS="your-password"
如需持久化访问，请将以下内容添加到 ~/.config/systemd/user/clawdbot-gateway.service.d/gurkerl.conf：
[Service]
Environment="GURKERL_EMAIL=your@email.com"
Environment="GURKERL_PASS=your-password"
CLI 使用示例
# 搜索商品（使用德语关键词）
gurkerl search_products '{"keyword":"Milch"}'
gurkerl search_products '{"keyword":"Bio Eier","sort_type":"orderPriceAsc"}'
# 获取购物车
gurkerl get_cart
# 添加到购物车
gurkerl add_items_to_cart '{"items":[{"productId":1234567,"quantity":2}]}'
# 查看订单
gurkerl fetch_orders '{"limit":3}'
gurkerl fetch_orders '{"order_type":"upcoming"}'
# 搜索食谱
gurkerl search_recipes_by_vector_similarity '{"query":"vegetarisch schnell"}'
可用工具
商品与搜索
| 工具 |
描述 |
search_products |
按关键词、筛选条件和排序方式搜索商品。请使用德语关键词。 |
get_products_details_batch |
批量获取多个商品 ID 的详细信息 |
get_product_composition |
获取营养成分、过敏原和配料信息 |
get_category_products |
浏览特定分类下的商品 |
get_main_categories |
列出商店的商品分类 |
get_brands_navigation |
列出可用品牌 |
购物车
| 工具 |
描述 |
get_cart |
查看当前购物车 |
add_items_to_cart |
添加商品：{"items":[{"productId":123,"quantity":1}]} |
update_cart_item |
修改数量：{"product_id":123,"quantity":3} |
remove_cart_item |
移除商品：{"product_id":123} |
clear_cart |
清空整个购物车 |
订单
| 工具 |
描述 |
fetch_orders |
获取订单历史。参数：limit, order_type (delivered/upcoming/both), date_from, date_to |
repeat_order |
重新下单：{"order_id":12345678} |
cancel_order |
取消即将到来的订单（两步操作：先设置 customer_confirmed:false，再设置为 true） |
get_alternative_timeslots |
获取可用的配送时间段 |
change_order_timeslot |
更改配送时间段 |
食谱
| 工具 |
描述 |
search_recipes_by_vector_similarity |
语义化食谱搜索 |
get_recipe_detail |
获取完整食谱，包含与商品匹配的配料信息 |
generate_recipe_with_ingredients_search |
AI 生成食谱，并匹配可购买的商品 |
get_recipes_navigation |
浏览食谱分类 |
用户与收藏夹
| 工具 |
描述 |
get_user_info |
账户信息 |
get_user_credits |
可用积分/优惠券 |
get_user_addresses |
保存的配送地址 |
get_all_user_favorites |
所有收藏的商品 |
get_user_shopping_lists_preview |
列出所有购物清单 |
get_user_shopping_list_detail |
查看购物清单内容 |
create_shopping_list |
创建新购物清单 |
add_products_to_shopping_list |
添加商品到购物清单 |
客户服务
| 工具 |
描述 |
submit_claim |
提交缺失或损坏商品的保修索赔 |
get_customer_support_contact_info |
获取电话、邮箱、WhatsApp 等联系方式 |
get_user_reusable_bags_info |
检查环保袋押金状态 |
adjust_user_reusable_bags |
更正环保袋数量 |
其他
| 工具 |
描述 |
calculate_average_user_order |
根据历史订单生成典型订单 |
get_faq_content |
获取常见问题解答：general, xtra_general, xtra_price, baby_club, christmas |
fetch_all_job_listings |
查看招聘信息 |
搜索技巧
- 为奥地利 Gurkerl 使用德语关键词："Milch", "Brot", "Eier", "Käse"
- 可用筛选条件：
news（新品）, sales（促销商品）
- 排序方式：
orderPriceAsc, orderPriceDesc, recommended（默认）
- 包含营养信息：
"include_nutritions":true
- 包含过敏原信息：
"include_allergens":true
示例工作流
每周购物
# 查看促销商品
gurkerl search_products '{"filters":[{"filterSlug":"sales","valueSlug":"sales"}]}'
# 将牛奶加入购物车
gurkerl search_products '{"keyword":"Milch"}' # 获取商品 ID
gurkerl add_items_to_cart '{"items":[{"productId":MILK_ID,"quantity":2}]}'
# 查看购物车
gurkerl get_cart
重新订购上次订单
gurkerl fetch_orders '{"limit":1}' # 获取订单 ID
gurkerl repeat_order '{"order_id":ORDER_ID}'
查找食谱并添加配料
gurkerl search_recipes_by_vector_similarity '{"query":"schnelles Abendessen"}'
gurkerl get_recipe_detail '{"recipe_id":RECIPE_ID,"include_product_mapping":true}'
# 将匹配的商品加入购物车