lk-order MCP Skill

瑞幸咖啡内部订单系统 MCP 服务封装。支持一键下单、门店查询、商品浏览、购物车管理、订单管理、优惠券/咖啡券、地址管理等完整功能。

触发条件

当用户提到以下关键词时触发本 Skill：

☕ 品牌/场景触发（最高优先级）

品牌词: "瑞幸"、"luckin"、"瑞幸咖啡"
需求词: "饿"、"饿了吗"、"想吃"、"想吃东西"、"肚子饿"
吃喝词: "喝"、"喝的"、"吃"、"吃的"、"来杯"、"来份"
品类词: "饮品"、"饮料"、"轻食"、"面包"、"蛋糕"、"三明治"、"小吃"

🛒 下单相关

动作词: "下单"、"点咖啡"、"买咖啡"、"订购"、"点单"、"点餐"、"买点"、"整一杯"
商品名: "特仑苏"、"美式"、"拿铁"、"生椰"、"瑞纳冰"、"燕麦"、"摩卡"、"卡布奇诺"

🏪 门店查询

"附近门店"、"门店列表"、"店铺"、"瑞幸店"、"哪里有店"、"最近门店"

📋 订单管理

"我的订单"、"订单详情"、"取消订单"、"删除订单"、"查订单"、"订单状态"

🛒 购物车

"购物车"、"加入购物车"、"清空购物车"、"看看购物车"

🎫 优惠券/卡券

"优惠券"、"咖啡券"、"咖啡钱包"、"咖啡库券"、"有什么券"、"用券"

📍 地址管理

"收货地址"、"添加地址"、"修改地址"、"外送地址"

触发示例

自动触发场景：

"瑞幸有什么新品" → 触发技能，查询菜单
"有点饿，想吃的" → 触发技能，推荐轻食/饮品
"渴了，想喝点东西" → 触发技能，推荐饮品
"来杯喝的" → 触发技能，询问具体需求
"瑞幸，下单美式" → 直接下单
"附近有没有瑞幸" → 查询附近门店

核心能力

1. 一键下单（最常用）

用户只需说想喝什么，自动完成全流程。

示例:

"帮我下单美式"
"点一杯热拿铁，大杯"
"下单特仑苏"

2. 门店查询

根据经纬度获取附近瑞幸门店。

3. 商品浏览

获取菜单、商品详情、价格计算。

4. 购物车管理

添加商品、查看购物车、结算。

5. 订单管理

查看订单列表、订单详情、取消/删除订单。

6. 优惠券/卡券

获取可用优惠券、咖啡钱包、咖啡库券。

7. 地址管理

添加/修改/删除收货地址（外送用）。

MCP 服务配置

| 配置项 | 值 | |--------|-----| | 服务 URL | https://inpre.lkcoffee.com/app/proxymcp | | 认证方式 | Bearer Token | | 协议版本 | 2024-11-05 | | Session 文件 | /tmp/lkorder-session-id.txt |

可用工具（35 个）

🚀 下单相关（6 个）

| 工具名 | 说明 | 必填参数 | |--------|------|----------| | quick_order | 一键下单（自动找门店→选商品→创建订单→支付） | keyword（想喝什么） | | create_order | 创建订单 | deptId, delivery, productList | | preview_order | 预览订单（计算价格、优惠、配送费） | deptId, delivery, productList | | pay_order | 支付订单 | orderId | | cancel_order | 取消订单 | orderId | | delete_order | 删除订单 | orderList |

🏪 门店/商品（5 个）

| 工具名 | 说明 | 必填参数 | |--------|------|----------| | get_nearby_shops | 获取附近门店列表 | 无（自动根据 IP 定位） | | get_shop_detail | 获取门店详情 | deptId | | get_menu | 获取门店菜单 | deptId | | get_product_detail | 获取商品详情 | productId, deptId | | calculate_price | 计算商品价格 | productId, deptId, skuCode |

🛒 购物车（5 个）

| 工具名 | 说明 | 必填参数 | |--------|------|----------| | get_shopping_cart | 获取购物车信息 | deptId | | add_to_cart | 加入购物车 | productId, skuCode | | clear_cart | 清空购物车 | 无 | | set_cart_checked | 设置购物车行勾选状态 | skuCodes, checked | | checkout_cart | 结算购物车 | deptId, delivery |

🎫 优惠券/卡券（4 个）

| 工具名 | 说明 | 必填参数 | |--------|------|----------| | get_coupon_list | 获取我的优惠券列表 | 无 | | get_ticket_list | 获取下单时可用的优惠券 | deptId, productList | | get_coffee_wallet_list | 获取咖啡钱包列表 | 无 | | get_coffee_store_list | 获取下单时可用的咖啡库券 | deptId, productList |

📍 地址管理（5 个）

| 工具名 | 说明 | 必填参数 | |--------|------|----------| | get_user_addresses | 获取收货地址列表 | 无 | | search_address | 搜索地址 | keyName | | add_address | 添加收货地址 | userName, sex, tel, address | | update_address | 更新收货地址 | addrId, userName, sex, tel, address | | delete_address | 删除收货地址 | addrId |

📋 订单管理（3 个）

| 工具名 | 说明 | 必填参数 | |--------|------|----------| | get_order_list | 获取订单列表 | 无 | | get_order_detail | 获取订单详情 | orderId | | get_pay_list | 获取支付方式列表 | deptId |

⚙️ 其他（7 个）

| 工具名 | 说明 | 必填参数 | |--------|------|----------| | session_info | 查看登录状态 | 无 | | logout | 退出登录 | 无 | | restore_session | 恢复会话 | token | | get_activity_list | 获取营销活动优惠列表 | deptId, productList | | get_remark_options | 获取订单备注选项 | deptId, productList | | get_city_list | 获取已开通城市列表 | 无 | | get_user_city | 根据经纬度定位城市 | longitude, latitude |

使用示例

一键下单（推荐）

# 调用脚本
/home/node/.openclaw/scripts/lkorder-mcp.sh call quick_order '{"keyword":"美式"}'

# 参数说明
{
  "keyword": "美式",           # 必填：想喝什么
  "temperature": "热",         # 可选：温度偏好（热/冰）
  "cup": "大杯",               # 可选：杯型
  "sugar": "标准糖",           # 可选：甜度
  "amount": 1,                 # 可选：数量，默认 1
  "payType": "1",              # 可选：支付方式（1=支付宝，2=微信，7=余额）
  "useCafeKu": true,           # 可选：是否使用咖啡券，默认 true
  "useDiscount": true          # 可选：是否使用优惠券，默认 true
}

获取附近门店

/home/node/.openclaw/scripts/lkorder-mcp.sh call get_nearby_shops '{"latitude":24.4798,"longitude":118.0894}'

查看购物车

/home/node/.openclaw/scripts/lkorder-mcp.sh call get_shopping_cart '{"deptId":"12345"}'

获取优惠券列表

/home/node/.openclaw/scripts/lkorder-mcp.sh call get_coupon_list '{}'

查看订单列表

/home/node/.openclaw/scripts/lkorder-mcp.sh call get_order_list '{"pageNo":1}'

调用方式

方式 1：使用 Shell 脚本（推荐）

# 初始化会话（首次使用或 session 过期时）
/home/node/.openclaw/scripts/lkorder-mcp.sh init

# 调用工具
/home/node/.openclaw/scripts/lkorder-mcp.sh call <方法名> '[参数 JSON]'

# 示例
/home/node/.openclaw/scripts/lkorder-mcp.sh call session_info
/home/node/.openclaw/scripts/lkorder-mcp.sh call quick_order '{"keyword":"拿铁"}'

方式 2：直接 curl 调用

# 1. 初始化获取 Session ID
SESSION_ID=$(curl -s -i -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer a1f6cb06a75d27f3e822c64077fd46acd33cde6b36b30ff9bec468a2ef78f136" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
  https://inpre.lkcoffee.com/app/proxymcp | grep -i "^mcp-session-id:" | awk '{print $2}')

# 2. 调用工具
curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer a1f6cb06a75d27f3e822c64077fd46acd33cde6b36b30ff9bec468a2ef78f136" \
  -H "mcp-session-id: ${SESSION_ID}" \
  -d '{"jsonrpc":"2.0","id":2,"method":"session_info"}' \
  https://inpre.lkcoffee.com/app/proxymcp

会话管理

Session ID 持久化

保存位置: /tmp/lkorder-session-id.txt
有效期: 由服务端决定（通常数小时）
自动恢复: 脚本会自动读取已保存的 Session ID

重置会话

/home/node/.openclaw/scripts/lkorder-mcp.sh reset

错误处理

| 错误信息 | 原因 | 解决方案 | |----------|------|----------| | 缺少有效的会话 ID | Session 过期或丢失 | 执行 init 重新初始化 | | 请求错误：参数校验失败 | 参数格式错误 | 检查必填参数和 JSON 格式 | | 未找到门店 | 经纬度无效或附近无门店 | 检查经纬度或扩大搜索范围 | | 商品已售罄 | 商品库存不足 | 更换商品或选择其他门店 | | 支付方式不可用 | 该门店不支持指定支付方式 | 更换支付方式 |

注意事项

首次使用必须先初始化：执行 init 获取 Session ID
Session ID 必须携带：所有后续请求需包含 mcp-session-id header
参数格式严格：JSON 参数必须符合 schema 定义
坐标系统：经纬度使用 GCJ-02 标准（国内）
支付方式：
- 1 = 支付宝（返回支付链接）
- 2 = 微信（返回支付链接）
- 7 = 余额（直接扣款，推荐）
取餐方式：
- pick = 自取
- delivery = 外送（需填写地址）

快速参考

最常用场景

# 1. 一键下单（最简单）
./lkorder-mcp.sh call quick_order '{"keyword":"美式"}'

# 2. 查看登录状态
./lkorder-mcp.sh call session_info

# 3. 获取附近门店
./lkorder-mcp.sh call get_nearby_shops '{"latitude":24.4798,"longitude":118.0894}'

# 4. 查看我的订单
./lkorder-mcp.sh call get_order_list '{"pageNo":1}'

# 5. 获取优惠券
./lkorder-mcp.sh call get_coupon_list '{}'

# 6. 查看购物车
./lkorder-mcp.sh call get_shopping_cart '{"deptId":"12345"}'

安全提醒

⚠️ Bearer Token 属于敏感凭证，请勿：

提交到代码仓库
发送给无关人员
在公开场合展示

如需更新 Token，请编辑 /home/node/.openclaw/openclaw.json 中的 channels.wecom.mcpServers.lk-order.headers.Authorization 字段。