唯品会商品详情

唯品会（vip.com）商品详情查询技能。当用户想查看某件商品的详细信息时触发，包括但不限于：看商品详情、查规格尺码、 看商品图片、查活动优惠、看用户评价、问商品是否打折、确认库存、查品牌介绍等。 支持通过商品ID或商品链接查询，返回完整商品信息：价格、原价、折扣、优惠活动、商品图片、 买家评价、品牌信息等结构化...

Security Scan

The skill mostly does what its description says (query VIP product details) but it asks the agent to auto-install/call a separate login skill and reads a local tokens file (containing PASSPORT_ACCESS_TOKEN), and it embeds a hard-coded secret — behaviors that raise privacy and consent concerns and deserve review before installing.

Purpose & Capability

The code and instructions align with the stated purpose: querying VIP product detail APIs requires a login token and a device id (mars_cid), and the scripts read ~/.vipshop-user-login/tokens.json and call VIP APIs. Asking for/using a local login token and generating exchange links is consistent with providing automatic logged-in product links. However, the skill also instructs automatic installation and invocation of a separate vipshop-user-login skill without explicit user consent, which is beyond a simple 'read-only product-info' helper.

Instruction Scope

SKILL.md mandates automatic detection of login state, automatic installation (clawhub install vipshop-user-login) and automatic invocation of the vipshop-user-login skill (or running ../vipshop-user-login/scripts/vip_login.py --blocking) without requiring an explicit user confirmation. It also tells the agent to read ~/.vipshop-user-login/tokens.json to obtain cookies/PASSPORT_ACCESS_TOKEN. Automatic installation and triggering of another skill plus silent access to local token files broadens scope and raises consent/privacy concerns.

Install Mechanism

There is no bundled install spec for this skill itself (files are provided). But the runtime instructions instruct the agent to execute 'clawhub install vipshop-user-login' if that login skill is missing — which will download and install external code at runtime. That external install step is a higher-risk action compared to purely local operation and should be subject to user approval and code review of the installed login skill.

Credentials

The scripts read the local file ~/.vipshop-user-login/tokens.json and extract cookies including PASSPORT_ACCESS_TOKEN (sensitive authentication credential) and use mars_cid device id. Using those credentials is proportionate to creating logged-in product links, but the skill does not declare this sensitive access in metadata and demands automatic reading/extraction. Additionally, exchange_link_builder contains a hard-coded secret key used to sign exchange links; embedding such a secret in code is unusual and should be justified or rotated. Overall, credential access is sensitive and warrants explicit disclosure and user consent.

Persistence & Privilege

The skill does not request 'always: true' and does not modify other skills' configs, but it does persist device info under ~/.vipshop-user-login/device.json via mars_cid generator and will cause the agent to install and run another skill (vipshop-user-login) when needed. That level of persistence (creating/reading files in the user's home dir and invoking installs) is significant and should be made explicit to the user before the skill runs.

What to consider before installing

Before installing, consider these points: - This skill will read and use your local login state file ~/.vipshop-user-login/tokens.json, including cookies and the PASSPORT_ACCESS_TOKEN — these are authentication credentials for your VIP account. If you don't want the skill to access these credentials, do NOT install or run it. - The skill's runtime instructions require automatically installing and invoking another skill (vipshop-user-login) if it's not present. Automatic installation and automatic triggering of a login flow (displaying a QR and waiting for scan) will happen without an explicit per-install/user confirmation unless you override it — review the vipshop-user-login skill code before allowing install. - The code contains a hard-coded secret used to sign exchange-token links. Hard-coded secrets are risky; ask why the secret is required and whether it is legitimate and safe to include in the skill. - If you plan to use this skill: (1) inspect the vipshop-user-login skill implementation before allowing clawhub to install it, (2) check and back up ~/.vipshop-user-login/tokens.json and device files, (3) consider disabling automatic install/invocation in the SKILL.md or running the detail.py script manually after you confirm login, and (4) do not enable DEBUG in exchange_link_builder so tokens are not printed to stderr. - If you are unsure, treat this as sensitive: require the agent to prompt you before installing or using your login tokens, and only proceed after reviewing the login skill's source and confirming the design.

唯品会商品详情查询

⚠️ 重要规范：AI 必须先加载本 skill 规范（use_skill），再执行任何脚本或返回结果，不得绕过 skill 规范自行处理数据。

概述

唯品会（vip.com）商品详情查询技能。当用户想查看某件商品的详细信息时触发，包括但不限于：看商品详情、查规格尺码、 看商品图片、查活动优惠、看用户评价、问商品是否打折、确认库存、查品牌介绍等。 支持通过商品ID或商品链接查询，返回完整商品信息：价格、原价、折扣、优惠活动、商品图片、 买家评价、品牌信息等结构化结果。 需要先通过 vipshop-user-login 完成唯品会扫码登录。

功能特性：商品ID查询、主信息获取、智能分析总结、自动登录触发

脚本位置：scripts/detail.py

⚠️ AI 输出格式规范（必须严格遵守）

必须使用卡片式分区展示，提升可读性：

标准输出格式示例

## 🛍️ 商品详情

![图1](url1) ![图2](url2) ![图3](url3)

**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

商品链接说明

脚本返回的商品链接可能有以下两种格式，都是有效的：

1. 带 exchange token 的链接（用户已登录时）：https://passport.vip.com/exchangeTokenFromApp?...

   • 这是一个自动登录跳转链接，点击后会自动登录并跳转到商品详情页

2. 普通商品链接（未登录或 token 获取失败时）：https://detail.vip.com/detail-{brand_id}-{product_id}.html?pcf=AIClaw

   • 标准商品详情页链接

AI 展示时无需区分这两种链接，直接显示 URL 即可。

字段缺失处理

• 如果某字段为空或不存在，跳过该分区，不要展示
• 空数组 [] 视为缺失，跳过展示
• 空对象 {} 视为缺失，跳过展示
• 如果没有优惠信息，跳过"优惠"分区

禁止行为

• ❌ 禁止使用大表格展示所有信息
• ❌ 禁止添加接口未返回的字段
• ❌ 禁止重复展示相同内容（如多个相同的折扣信息需去重）
• ❌ 禁止修改字段名称

工作流程

步骤 1：检测登录状态（AI 必须执行）

在执行查询前，AI 必须先检测登录状态：

• 检查 ~/.vipshop-user-login/tokens.json 是否存在且有效
• 如果已登录：直接执行步骤2
• 如果未登录：必须自动触发登录流程（见下文"未登录自动处理"）

重要：不要直接执行查询脚本，而是先检查登录状态。如果直接执行脚本返回 {"error": "login_required"}，说明未登录，此时必须进入自动登录流程。

Token 过期处理：如果接口返回 {"error": "token_expired", "message": "token expired"}，说明登录态已过期，AI 必须自动触发登录流程，无需用户手动请求。

未登录自动处理（AI 必须自动执行）

当检测到未登录时，AI 必须按以下步骤自动处理，不要等待用户手动请求：

步骤 1.1：提示用户

检测到您尚未登录唯品会账户，准备为您启动登录流程。

💡 登录说明：
  - 将使用唯品会登录 SKILL 完成登录
  - 使用唯品会APP扫描二维码登录
  - 快捷便捷，安全可靠

步骤 1.2：检查并安装 vipshop-user-login SKILL 先检查 vipshop-user-login SKILL 是否已安装：

• 如果未安装，使用 clawhub 安装：

  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 登录成功后，继续执行商品详情查询。

步骤 2：接收商品ID

接收用户提供的商品ID，确保不为空。

步骤 3：执行查询脚本

python3 scripts/detail.py <product_id>

步骤 4：展示结果

必须使用卡片式分区展示商品详情，严格按照上述输出格式规范。

展示要求：

1. 商品图片：最先展示，独立一行，横向排列
2. 商品标题：单独一行，品牌名加粗
3. 价格信息：使用代码块标签样式，如 ¥403.5 3.4折
4. 优惠信息：列表格式，带图标，去重展示
5. 服务标签：代码块标签样式
6. 商品链接：底部固定，直接显示URL

AI 行为规范

未登录处理（AI 必须自动执行）

当检测到用户未登录时，AI 必须：

1. 不要只提示用户"需要登录"，而应该立即自动触发登录流程
2. 不要等待用户再次请求，而是主动执行以下步骤：
   • 检查并安装 vipshop-user-login SKILL
   • 自动调用 vipshop-user-login skill（优先）或执行 python3 ../vipshop-user-login/scripts/vip_login.py --blocking 触发登录（备选）
   • 等待用户扫码完成登录
   • 登录成功后自动继续执行商品详情查询
3. 如果找不到 vipshop-user-login skill：
   • 使用 clawhub install vipshop-user-login 安装
   • 安装完成后自动触发登录流程

禁止行为

• ❌ 不要只返回错误信息让用户自己处理
• ❌ 不要等待用户再次请求登录
• ❌ 不要在未登录时直接执行查询脚本

正确行为

• ✅ 检测到未登录时立即自动触发登录流程
• ✅ 使用阻塞模式（--blocking）等待登录完成
• ✅ 登录成功后自动继续执行查询
• ✅ 全程无需用户手动请求，AI 主动完成

接口信息

登录态要求

• 使用前必须通过 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) 返回： 商品基本信息、价格信息、品牌信息、服务保障、优惠信息等

商品辅助信息接口

注意：当前接口不可用，暂不提供尺码表、尺码推荐等辅助信息。

注意事项

1. 自动登录触发（重要）：检测到未登录时，AI 必须自动触发登录流程
2. 登录要求：必须先通过 vipshop-user-login skill 登录
3. 输出格式：AI 必须使用卡片式分区格式输出
4. 网络要求：需要正常网络连接
5. 登录态管理：自动读取 ~/.vipshop-user-login/tokens.json
6. 依赖库：仅 Python 标准库（urllib、json、pathlib）
7. 辅助信息失败：辅助信息接口失败时，可继续展示主信息

常见问题

Q: 如何获取商品ID？ A: 通过 vipshop-product-search skill 搜索商品获取。

Q: 需要登录才能使用吗？ A: 是的，必须先通过 vipshop-user-login skill 登录。

Q: 为什么没有尺码表信息？ A: 商品辅助信息接口当前不可用，因此无法提供尺码表等信息。