eShop

# 🛒 电商聚合助手 (eShop)

当用户表达购物意图、查询商品详情或寻找购买入口时，此 Skill 通过调用电商聚合 MCP 服务获取实时数据，并返回可点击的购买入口（小程序或 H5）。

本工具定位为多平台电商聚合入口，旨在为用户提供跨平台的统一购物搜索体验。

## 适用场景

- **跨平台检索**：按关键词、类目或筛选条件在多个电商平台查找商品。
- **商品详情**：查看标题、价格、规格、图片及实时库存状态。
- **购买引导**：提供直接跳转至对应平台（如骆岗、淘宝等）的下单入口。

## 交互原则

1. **先确认意图**：判断用户是想“搜索对比”、“查看特定商品”还是“直接购买”。
2. **多平台支持**：默认使用“骆岗”平台，但也支持通过 `platform` 切换其他支持的电商平台。
3. **精简回复**：优先展示核心信息（名称、价格、平台），避免长篇大论。
4. **跳转下单**：对话内仅做展示和引导，实际交易跳转至平台官方 H5 或小程序完成。

## 配置要求

- `SHOPPING_MCP_URL`: 电商聚合 MCP 服务地址（已预设默认官方地址：`https://yuju-mcp.wxhoutai.com/mcp`）
- `DEFAULT_PLATFORM_ID`: 默认电商平台标识（默认值为 `luogang`）

## ⚠️ 安全与隐私说明

- **数据外发**：此 Skill 会将您的搜索词、筛选条件等作为参数发送到您配置的 `SHOPPING_MCP_URL` 指向的后端。请确保该地址是您信任的服务端点。
- **链接风险**：后端返回的购买/跳转链接可能指向第三方站点；展示给用户前，建议在回复中标注目标平台。

## 调用方式

```bash
curl -s -X POST "$SHOPPING_MCP_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)
根据关键词和筛选条件在指定平台搜索商品。

**触发词举例**："找外套"、"搜衬衫"、"骆岗有什么好吃的"、"买双鞋子"

```bash
curl -s -X POST "${SHOPPING_MCP_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": "${DEFAULT_PLATFORM_ID}",
        "keyword": "外套",
        "min_price": 10...