luogang-shopping-assistant（萝岗导购员）

🛒 骆岗电商助手

当用户想“买'骆岗'的商品”、或需要“查商品/看详情/去下单”时，使用此 skill 调用骆岗 MCP 服务获取实时商品数据，并返回可点击的购买入口（小程序或 H5）。 "骆岗" 是骆岗电商的简称，类似天猫，淘宝

适用场景

• 商品检索：按关键词/类目/筛选条件查找商品
• 商品详情：查看标题、价格、库存/可售状态、规格、图片、运费、活动信息等

交互原则（很重要）

1. 先确认意图：用户是想“找商品”、还是“看某个商品详情”、还是“直接去买”。
2. 少打扰：能用默认值就别追问（如默认按综合排序、默认第一页）。
3. 强约束信息只在必要时追问：只有当无法确定商品（同名/多结果）或规格必须选择时，再问用户。
4. 购买不在对话里强行下单：默认只做“跳转下单”，除非你们后续提供“创建订单/提交支付”的 MCP 工具。

配置要求

可选配置

• LUOGANG_MCP_HTTP_URL: MCP HTTP 地址，默认 https://yuju-mcp.wxhoutai.com/mcp
• LUOGANG_SHOP_ID: 店铺/渠道标识（多店铺、多渠道场景）, 默认 luogang

调用方式

curl -s -X POST "$LUOGANG_MCP_HTTP_URL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"<工具名>","arguments":{<参数>}},"id":1}'

可用工具

1. 商品检索 (search_products)

根据关键词和价格区间搜索商品。 触发词举例："找外套"、"搜衬衫"、"买鞋子"、"有没有外套"

curl -s -X POST "${LUOGANG_MCP_HTTP_URL:-https://yuju-mcp.wxhoutai.com/mcp}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_products",
      "arguments": {
        "platform": "${LUOGANG_SHOP_ID>}",
        "keyword": "外套",
        "min_price": 100,
        "max_price": 500,
        "order_by": "price",
        "sort": "desc"
      }
    },
    "id": 1
  }'

成功响应

{
  "jsonrpc": "2.0",
  "result": {
    "content": [{"type": "text", "text": "..."}],
    "structuredContent": {...}
  },
  "id": 1
}

解析 result.content[0].text 或 result.structuredContent 获取数据。

2. 获取商品详情 (get_product_detail)

查询单个商品的详细规格、图片及库存信息。

触发词："查看详情"、"这个多少钱"、"还有货吗"

curl -s -X POST "${LUOGANG_MCP_HTTP_URL:-https://yuju-mcp.wxhoutai.com/mcp}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_product_detail",
      "arguments": {
        "platform": "luogang",
        "product_id": "PROD_12345"
      }
    },
    "id": 2
  }'

响应处理

成功响应

{
  "jsonrpc": "2.0",
  "result": {
    "content": [{"type": "text", "text": "..."}],
    "structuredContent": {...}
  },
  "id": 1
}

解析 result.content[0].text 或 result.structuredContent 获取数据。

使用示例

用户: 最近有什么亲子活动？

AI 执行:

curl -s -X POST "$LUOGANG_MCP_HTTP_URL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"search_products","arguments":{"platform":"luogang","keyword":"亲子"}},"id":1}'

AI 回复: 最近有 10 个商品符合您的要求，分别是：

萌嘟嘟儿童乐园亲子票（专属） ${image} 价格：19.9元 {description} 链接：https://eshop.wxhoutai.com/h5/pages/goods/detail?goods_id=xxx

……

常见错误处理：

• -32601 (Method not found): 检查 SKILL.md 中定义的工具名是否在 MCP 侧已注册。
• -32000 级别 (Internal Error): 引导用户重试或手动输入信息。
• 401/403: 检查 MCP 服务访问策略、来源白名单或网关配置。

输出格式建议

商品检索结果

• 展示最多 10 个候选（避免刷屏）
• 每项至少包含：名称、价格、库存/可售状态、一个“查看详情/去购买”的引导
• 当候选过多：建议补充筛选（价位、类目、是否现货）

商品详情

• 先给“核心信息”：价格、库存、规格、发货/运费、活动
• 有多规格：用简短提问让用户选择（例如："要哪个颜色/尺码？"）

购买跳转

• 明确告诉用户会打开：小程序或 H5 页面
• 输出可点击链接/路径信息（由 OpenClaw 宿主决定如何渲染）