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

路由决策

Agent 行为规范

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

平台代码

响应字段

参数速查

错误处理

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