购物省钱宝 - 淘宝/京东/拼多多优惠查询、商品比价、链接转链

SKILL.md

---
name: 购物省钱宝 - 京东/淘宝/拼多多优惠查询
description: 京东/淘宝/拼多多商品比价、优惠券查询、口令解析与链接转链省钱助手。帮用户在三平台找到最低价。Use when: 想查某商品在哪个平台最便宜、想搜索商品看有没有优惠券、收到电商分享口令想解析、拿到商品链接想转优惠链接省钱购买。Supports product search, price comparison across JD/Taobao/PDD, coupon discovery, share-code parsing, affiliate link conversion. 适用于：帮我查XX的价格、XX在哪买最便宜、这个口令帮我看看、这个链接有优惠吗、帮我找XX的优惠券、哪个平台买XX最省钱、对比XX价格、查一下XX多少钱。Save money on every purchase.
version: 1.5.5
---

# PriceCompare · 购物省钱宝

> 三平台比价省钱助手：查价格、找优惠券、解析口令、转链接。帮我查XX在哪买最便宜。Cross-platform price comparison, coupon discovery, and deal conversion.

> 调用入口: `handle_message(message, keyword=None)` — message 用于路由判断，keyword 用于搜索/比价。API: `POST http://op.squirrel2.cn/api/v1/{endpoint}`。数据仅用于本次查询，发送至 op.squirrel2.cn 处理。

## 功能

### 1. 链接转链 `convert_link`
将商品链接转换为优惠链接。
```
触发条件: 用户发送了电商商品链接
调用签名: convert_link(url: str, platform: str|None = None) -> str
API:      POST /api/v1/convert  body: {"url": "...", "platform": "jd|taobao|pinduoduo"}

platform 可选，服务端自动识别域名:
  JD: item.jd.com, u.jd.com, 3.cn
  TB: item.taobao.com, detail.tmall.com, m.tb.cn, e.tb.cn
  PDD: mobile.yangkeduo.com, p.pinduoduo.com
```

### 2. 口令解析 `parse_share_content`
解析用户粘贴的电商分享内容（口令、短链接等）。服务端自动判断是否含有效口令。
```
触发条件: 用户发送了疑似分享口令的文本（非纯 URL）
调用签名: parse_share_content(content: str) -> str
API:      POST /api/v1/parse_share  body: {"content": "<用户原话>"}

注意: 服务端自动识别口令格式，无需客户端做正则检测。
      解析失败时返回错误信息，调用方应 fallback 到商品搜索。
```

### 3. 商品搜索 `search_goods`
按关键词搜索商品。不指定 platform 时自动走三平台比价。
```
触发条件: 用户想搜索/找某类商品
调用签名: search_goods(keyword: str, platform: str|None = None, page_size: int = 10) -> str
API:      POST /api/v1/search  body: {"platform": "jd|taobao|pinduoduo", "keyword": "...", "page_size": 10}

platform 为 None: 自动调用 compare_prices 三平台比价
page_size 最小值: 10（拼多多限制）
```

### 4. 多平台比价 `compare_prices`
同一关键词在京东/淘宝/拼多多三平台同时搜索，返回最低价。
```
触发条件: 用户想对比价格、找最便宜的平台
调用签名: compare_prices(keyword: str) -> str
API:      POST /api/v1/compare  body: {"keyword": "..."}
```

## Agent 调用指引

### 调用方式
```
handle_message(user_raw_message, keyword=extracted_product_name)
```

- **message**: 用户原始输入，用于路由判断（检测 URL）
- **keyword**: agent 从用户消息中提取的商品关键词，用于搜索/比价。不提供时回退到 message

### 路由决策

| 优先级 | 条件 | 调用 |
|:---:|------|------|
| 1 | message 含电商商品 URL | `convert_link(url)` |
| 2 | 其他文本 | 先 `parse_share_content(message)`，失败则 `search_goods(keyword or message)` |

### Agent 行为规范

1. 从用户消息中提取商品关键词传给 `keyword` 参数（如"帮我查一下iPhone 16的价格" → keyword="iPhone 16"）
2. 用户指定平台时传 `platform` 参数（jd/taobao/pinduoduo）
3. 展示链接时优先用超链接格式，如前端不支持则输出原始 URL
4. 函数返回的格式化内容直接呈现，无需重新组织

## 平台代码

| 中文 | 代码 | 主要域名 |
|------|:---:|------|
| 京东 | `jd` | item.jd.com, u.jd.com, 3.cn |
| 淘宝/天猫 | `taobao` | item.taobao.com, detail.tmall.com, m.tb.cn |
| 拼多多 | `pinduoduo` | mobile.yangkeduo.com, p.pinduoduo.com |

## 响应字段

| 字段 | 类型 | 含义 |
|------|------|------|
| title | string | 商品名称 |
| price | number | 券后价（元） |
| originalPrice | number | 原价（元） |
| couponInfo | string | 优惠券描述，如"满99减30" |
| couponAmount | number | 优惠券面值（元） |
| shopName | string | 店铺名称 |
| monthSales | string | 月销量 |
| link | string | 优惠购买链接 |
| platform | string | 平台代码 |

## 参数速查

| 参数 | 值 |
|------|-----|
| 推广链接有效期 | JD 15天 / TB 15天 / PDD 7天 |
| 口令有效期 | JD 7-15天 / TB 15-30天 |
| 搜索最小页大小 | 10 |

## 错误处理

- 口令过期/无效 → 告知用户重新获取
- 商品下架 → 告知不可购买，建议搜索同类
- 无搜索结果 → 建议放宽关键词
- parse_share 失败 → 自动 fallback 到商品搜索
- API 异常 → 提示服务暂时不可用