Youzan Item

---
name: youzan-item
version: 1.1.37
description: "面向消费者售卖的商品、商品规格、品牌、分类、分组、属性、物流模板和评价的原始数据查询；不提供商品、价格、库存、渠道或字典的远端数据变更能力，不负责供应链原材料和物料清单。"
---

# 商品

使用本 skill 前，确认当前授权范围和店铺上下文。供应链商品、原材料和物料清单使用 `youzan-supplychain`，素材信息可配合 `youzan-material`。

## 查询数量限制

- 列表查询必须显式传入页码和每页数量，不得依赖接口默认分页；每页最多查询 20 条。
- 批量查询每批最多传入 20 个对象或标识；超过 20 个时必须拆分为多个批次依次查询，且每批均不得超过 20 个。

## 支持能力

- 按条件搜索商品列表，查询单个商品详情以及商品规格、图文详情和商品分组等扩展信息。
- 查询商品分类、分类详情、商品分组和分组层级。
- 查询零售版本商品品牌、商品属性库和物流模板。
- 查询商品评价、追评和评价与订单的关联信息。
- 识别商品类型、渠道、商品规格和库存字段的含义，并返回平台原始结构。
- 区分商品分类与商品分组：分类使用分类标识，分组使用分组标识，两者不能互相替代。

## 字段提示

- 查询参数和返回结果中的字段必须使用中文字段名，不展示接口英文原始字段名。

### 必填信息

- 查询单个商品时必须提供商品标识和目标店铺标识；查询当前授权店铺时仍需明确商品所在店铺范围。
- 查询商品分类详情时必须提供店铺标识和分类标识。
- 查询商品分组时必须提供店铺标识和渠道；查询指定分组时还需提供分组标识。
- 查询单个品牌、属性或物流模板时必须提供对应对象标识；列表查询通常不要求对象标识。
- 按订单查询评价时必须提供订单号；按商品查询评价时必须提供商品标识。

### 非必填信息

- 商品列表的关键词、状态、渠道、商品类型、商品分组和扩展字段筛选可选；分页参数必须按“查询数量限制”传入。
- 分类、品牌、属性和物流模板列表的名称、父级标识和状态条件可选；分页参数必须按“查询数量限制”传入。
- 商品详情可按需请求图文、分组、商品规格或其他扩展信息。

## 使用案例

- 用户说“搜索标题里有坚果、正在售卖的商品”时，使用商品列表并组合关键词与销售状态；没有明确渠道时先按店铺组织和渠道规则判断。
- 用户提供商品标识时，直接查询商品详情；需要图片广告、图文组件或关联分组时，在详情查询中选择相关扩展模块。
- 用户说“查某个分类下的商品”时，先确认这是商品分类还是商品分组，分别使用分类标识或分组标识。
- 用户说“改商品价格、上下架、调库存或修改图片广告”时，说明本 skill 只支持读取，不执行远端变更。

## 边界

- 供应链单据、供应商、原材料和物料清单使用 `youzan-supplychain`。
- 商品图片和素材库使用 `youzan-material`。
- 本入口不提供商品创建、编辑、价格调整、库存调整、上下架、渠道发布、分类或分组维护、品牌维护及其他远端数据变更。
- 不对商品数据做销量趋势、经营结论、画像或推荐。