> 京东/淘宝/拼多多优惠券查询、商品比价、口令解析、链接转链。Cross-platform price comparison, coupon discovery, and deal conversion for JD.com, Taobao, and Pinduoduo.
> 调用入口: handle_message(message, keyword=None) — message 用于路由判断，keyword 用于搜索/比价。API: POST http://op.squirrel2.cn/api/v1/{endpoint}。数据仅用于本次查询，发送至 op.squirrel2.cn 处理。
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
parse_share_content解析用户粘贴的电商分享内容（口令、短链接等）。服务端自动判断是否含有效口令。
触发条件: 用户发送了疑似分享口令的文本（非纯 URL）
调用签名: parse_share_content(content: str) -> str
API: POST /api/v1/parse_share body: {"content": "<用户原话>"}
注意: 服务端自动识别口令格式，无需客户端做正则检测。
解析失败时返回错误信息，调用方应 fallback 到商品搜索。
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（拼多多限制）
compare_prices同一关键词在京东/淘宝/拼多多三平台同时搜索，返回最低价。
触发条件: 用户想对比价格、找最便宜的平台
调用签名: compare_prices(keyword: str) -> str
API: POST /api/v1/compare body: {"keyword": "..."}
handle_message(user_raw_message, keyword=extracted_product_name)
| 优先级 | 条件 | 调用 |
|---|---|---|
| :---: | ------ | ------ |
| 1 | message 含电商商品 URL | convert_link(url) |
| 2 | 其他文本 | 先 parse_share_content(message)，失败则 search_goods(keyword or message) |
keyword 参数（如"帮我查一下iPhone 16的价格" → keyword="iPhone 16"）platform 参数（jd/taobao/pinduoduo）| 中文 | 代码 | 主要域名 |
|---|---|---|
| ------ | :---: | ------ |
| 京东 | 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 |
共 8 个版本