← 返回目录
R

Rohlik MCP Server

社区
让您的AI助手在Rohlik集团平台上购买杂货。
GitHub 源仓库 ↗
★ 118 Stars 分类 · 其他 热门 源版本 9e824c5b1dba
47FMRS · D
可靠性
5/20
安全与权限
6/20
维护活跃度
12/20
文档质量
13/20
安装易用性
11/20

Rohlik MCP服务器提供了一套全面的工具,用于通过AI助手在多个欧洲平台上进行杂货购物。它强调了AI驱动购物的便利性,但由于依赖反向工程API和涉及真实购买和凭据的风险,仅供个人使用。安装简单,为Claude Desktop提供了清晰的配置,并包含了调试和验证工具。

查看 FMRS 评分方法 →

Rohlik MCP服务器是一个Model Context Protocol实现,使AI助手能够与Rohlik集团旗下多个国家的在线杂货配送服务交互。该服务器提供搜索产品、管理购物车和访问账户信息的工具。支持Rohlik.cz(捷克)、Knuspr.de(德国)、Gurkerl.at(奥地利)、Kifli.hu(匈牙利)和Sezamo.ro(罗马尼亚)。仅供个人使用,基于反向工程API。

工具能力

search_products
按名称搜索杂货产品,并带有筛选选项。
add_to_cart
将多个产品添加到您的购物车。
get_cart_content
查看当前购物车内容和总计。
remove_from_cart
从购物车中移除商品。
get_shopping_list
通过ID获取购物清单。
get_meal_suggestions
根据您的历史订单获取个性化建议(早餐、午餐、晚餐、零食、烘焙、饮品或健康饮食)。
get_frequent_items
分析订单历史,找出最常购买的商品(总体及分类)。
get_shopping_scenarios
交互式指南,展示MCP的功能。
get_discounted_items
浏览当前折扣商品,可按食品类别筛选、排序和分页。
get_account_data
获取包括配送详情、订单、公告、购物车和高级状态在内的综合账户信息。
get_order_history
查看过去已配送的订单详情。
get_order_detail
获取特定订单的详细信息,包括所有产品。
get_upcoming_orders
查看已安排的即将到来的订单。
get_delivery_info
获取当前配送信息和费用。
get_delivery_slots
查看您地址可用的配送时间段。
get_premium_info
检查您的Rohlik Premium订阅状态和权益。
get_announcements
查看当前公告和通知。
get_reusable_bags_info
跟踪您的可重复使用袋子和环境影响。

安装接入

  1. 确保已安装Node.js和npm。
  2. 在Claude Desktop配置文件中添加MCP服务器配置(macOS: ~/Library/Application Support/Claude/claude_desktop_config.json;Windows: %APPDATA%/Claude/claude_desktop_config.json),填入您的Rohlik凭据和所需的ROHLIK_BASE_URL(例如https://www.rohlik.cz)。
  3. 重启Claude Desktop。
claude_desktop_config.json
{
  "mcpServers": {
    "rohlik": {
      "command": "npx",
      "args": [
        "-y",
        "@tomaspavlin/rohlik-mcp"
      ],
      "env": {
        "ROHLIK_USERNAME": "[email protected]",
        "ROHLIK_PASSWORD": "your-password",
        "ROHLIK_BASE_URL": "https://www.rohlik.cz"
      }
    }
  }
}

选型与风险

适合谁

  • 希望使用AI助手在Rohlik集团平台(捷克、德国、奥地利、匈牙利、罗马尼亚)购买日常杂货的用户。
  • 希望自动化购物清单管理或获得个性化食品建议的用户。
  • 个人使用,并接受非官方API的学术或研究目的。

不适合谁

  • 商业用途或大规模自动化。
  • 需要官方支持或稳定性的生产环境。
  • 没有Rohlik账户或无法提供凭据的用户。
  • 不支持的国家(意大利、西班牙目前计划中)。

所需权限

  • 需要您的Rohlik用户名和密码才能登录。
  • 可以访问您的账户信息,包括订单历史、配送详情和购物车。
  • 可以修改您的购物车(添加/移除商品)。
  • 可能会代表您下单(如果LLM被指示这样做)。

风险与副作用

  • 使用反向工程API违反了服务条款,可能导致账户被封禁。
  • 凭据以明文存储在配置文件中的风险。
  • AI助手可能错误地添加或移除商品,导致意外购买或取消。
  • 依赖非官方API,可能随时更改或中断。

常见排障

  1. 登录失败:检查凭据、启用调试模式(ROHLIK_DEBUG=true)、运行npm run validate-api。
  2. 找不到订单历史:确保账户至少有一个已完成订单。
  3. 响应缓慢:减少智能购物功能分析的订单数量。
  4. 产品未找到:使用部分名称搜索,或直接在网站上验证产品。
  5. spawn npx ENOENT:使用npx的绝对路径或直接使用node命令。

使用场景

常规购物:让LLM根据食谱或购物清单添加食材。
智能购物:根据历史订单获取个性化建议和常购商品。
优惠与折扣:探索当前折扣商品。
计划:检查配送时间段、即将到来的订单和订单历史。

支持客户端

Claude Desktop完整支持