唯品会(vip.com)商品详情查询技能。当用户想查看某件商品的详细信息时触发,包括但不限于:看商品详情、查规格尺码、 看商品图片、查活动优惠、看用户评价、问商品是否打折、确认库存、查品牌介绍等。 支持通过商品ID或商品链接查询,返回完整商品信息:价格、原价、折扣、优惠活动、商品图片、 买家评价、品牌信息等结构化结果。 需要先通过 vipshop-user-login 完成唯品会扫码登录。
⚠️ 重要规范:AI 必须先加载本 skill 规范(use_skill),再执行任何脚本或返回结果,不得绕过 skill 规范自行处理数据。
唯品会(vip.com)商品详情查询技能。当用户想查看某件商品的详细信息时触发,包括但不限于:看商品详情、查规格尺码、 看商品图片、查活动优惠、看用户评价、问商品是否打折、确认库存、查品牌介绍等。 支持通过商品ID或商品链接查询,返回完整商品信息:价格、原价、折扣、优惠活动、商品图片、 买家评价、品牌信息等结构化结果。 需要先通过 vipshop-user-login 完成唯品会扫码登录。
功能特性:商品ID查询、主信息获取、智能分析总结、自动登录触发
脚本位置:scripts/detail.py
必须使用卡片式分区展示,提升可读性:
## 🛍️ 商品详情
  
**GA盈瓷**|【月桂枝头】新中式国风天丝提花旗袍春夏高级感金色长裙连衣裙女
---
### 💰 价格
`特卖价 ¥403.5` `折扣 3.4折`
### 🎁 优惠
- 🆕 仅限品牌新客,专属首单礼金已减10元
- 💎 商品享折上9.8折
### ✅ 服务保障
`7天无理由退货` `7天可换` `极速退款` `上门换货` `上门退货` `破损无忧` `15天质量无忧`
### 🏅 正品保障
官方自营 · 品牌授权 · 中国人保承保 · 全链路品控
### 💬 用户评价
> 大小合适,订婚穿质感很不错,特别合身!出片款式时尚!
---
🔗 商品链接:https://passport.vip.com/exchangeTokenFromApp?dt=xxx&sg=xxx&src=...
💡 商品链接格式说明:已登录时返回带 exchange token 的自动登录链接,未登录时返回普通商品详情链接。AI 展示时直接显示 URL 即可。
| 内容 | 展示规则 |
|---|---|
| 商品图片 | 最先展示,独立一行,最多展示3张,横向排列 |
| 商品标题 | 格式:**品牌名**|商品标题,单独一行突出显示 |
| 价格信息 | 使用代码块标签样式,格式:价格类型 ¥金额,如:特卖价 ¥403.5 折扣 3.4折 |
| 优惠信息 | 列表格式,每条前加图标:🆕新客优惠、💎折扣、🎫优惠券 |
| 服务标签 | 使用代码块标签样式,用反引号包裹每个标签 |
| 正品信息 | 使用 · 分隔 |
| 精华评论 | 使用引用格式 >,最多展示2条,每条评论可适当精简 |
| 商品链接 | 底部固定位置,直接显示URL |
脚本返回的商品链接可能有以下两种格式,都是有效的:
带 exchange token 的链接(用户已登录时):https://passport.vip.com/exchangeTokenFromApp?...
普通商品链接(未登录或 token 获取失败时):https://detail.vip.com/detail-{brand_id}-{product_id}.html?pcf=AIClaw
AI 展示时无需区分这两种链接,直接显示 URL 即可。
[] 视为缺失,跳过展示{} 视为缺失,跳过展示在执行查询前,AI 必须先检测登录状态:
~/.vipshop-user-login/tokens.json 是否存在且有效重要:不要直接执行查询脚本,而是先检查登录状态。如果直接执行脚本返回 {"error": "login_required"},说明未登录,此时必须进入自动登录流程。
Token 过期处理:如果接口返回 {"error": "token_expired", "message": "token expired"},说明登录态已过期,AI 必须自动触发登录流程,无需用户手动请求。
当检测到未登录时,AI 必须按以下步骤自动处理,不要等待用户手动请求:
步骤 1.1:提示用户
检测到您尚未登录唯品会账户,准备为您启动登录流程。
💡 登录说明:
- 将使用唯品会登录 SKILL 完成登录
- 使用唯品会APP扫描二维码登录
- 快捷便捷,安全可靠
步骤 1.2:检查并安装 vipshop-user-login SKILL 先检查 vipshop-user-login SKILL 是否已安装:
clawhub install vipshop-user-login
步骤 1.3:自动触发登录流程(通过 Skill 方式) 通过 use_skill 工具调用 vipshop-user-login skill:
触发 vipshop-user-login skill(阻塞模式)
如果 skill 调用不可用,则执行命令(备选方式):
python3 ../vipshop-user-login/scripts/vip_login.py --blocking
步骤 1.4:等待登录完成 等待 SKILL 完成登录流程,包括:
步骤 1.5:确认登录成功后,继续执行步骤2 登录成功后,继续执行商品详情查询。
接收用户提供的商品ID,确保不为空。
python3 scripts/detail.py <product_id>
必须使用卡片式分区展示商品详情,严格按照上述输出格式规范。
展示要求:
¥403.5 3.4折当检测到用户未登录时,AI 必须:
python3 ../vipshop-user-login/scripts/vip_login.py --blocking 触发登录(备选)clawhub install vipshop-user-login 安装vipshop-user-login skill 登录mars_cid:从登录态文件读取作为请求参数PASSPORT_ACCESS_TOKEN:通过 Cookie 传入URL: https://mapi-pc.vip.com/vips-mobile/rest/shopping/skill/detail/main/v6
方式: POST
主要参数: productId(必需)、mars_cid、scene(detail)
返回: 商品基本信息、价格信息、品牌信息、服务保障、优惠信息等
注意:当前接口不可用,暂不提供尺码表、尺码推荐等辅助信息。
vipshop-user-login skill 登录~/.vipshop-user-login/tokens.jsonQ: 如何获取商品ID? A: 通过 vipshop-product-search skill 搜索商品获取。
Q: 需要登录才能使用吗?
A: 是的,必须先通过 vipshop-user-login skill 登录。
Q: 为什么没有尺码表信息? A: 商品辅助信息接口当前不可用,因此无法提供尺码表等信息。