Youzan Member

---
name: youzan-member
version: 1.1.37
description: "客户与会员原始数据查询和导出，覆盖客户档案、会员等级、权益卡、积分记录、储值信息、标签、客户关系、行为时间轴和客户分群；不提供客户、标签、积分、权益卡或分群的远端数据变更能力，不做趋势、画像或推荐。"
---

# 客户与会员

使用本 skill 前，确认当前授权范围和店铺上下文。积分商城应用状态和兑换记录使用 `youzan-marketing`，订单明细使用 `youzan-order`。

## 查询数量限制

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

## 支持能力

- 查询客户和会员基础档案，支持按手机号、会员状态、来源、地区和其他条件检索。
- 查询客户行为时间轴、交易摘要、标签、关联员工和渠道信息。
- 查询店铺会员等级模板、客户当前等级和等级相关字段。
- 查询权益卡模板、客户持卡实例、权益卡发放记录和权益使用相关字段。
- 查询客户积分账户、积分变更记录和事件类型。
- 查询店铺标签及标签分类、客户已拥有的标签和按标签筛选的客户。
- 查询客户分群、分群规则、分群客户摘要和分群规模估算。
- 对客户档案、业绩摘要和支持的关系数据执行批量原始数据导出。

## 字段提示

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

### 必填信息

- 查询单个客户、行为时间轴、客户当前等级、客户持卡信息或客户标签时必须提供客户手机号。
- 查询指定客户积分记录时必须提供客户手机号；店铺级积分记录不要求提供客户手机号。
- 查询指定标签下的客户时必须提供标签标识。
- 查询分群详情或分群客户时必须提供分群标识。

### 非必填信息

- 客户和会员列表的会员状态、手机号、地区、渠道、标签、时间和导出条件可选；分页参数必须按“查询数量限制”传入。
- 等级、权益卡、标签和分群列表的名称、状态和类型条件可选；分页参数必须按“查询数量限制”传入。
- 行为时间轴的事件类型和时间范围可选；分页参数必须按“查询数量限制”传入。

## 使用案例

- 用户说“查会员列表”时，确认意图是会员而不是全部客户，再增加会员条件；不能因“客户”与“会员”混用而默认缩小范围。
- 用户提供手机号后，先确认该手机号在当前店铺范围内唯一匹配，再查询客户详情、等级、权益卡或标签。
- 用户说“查这个客户的标签、积分和行为”时，分别读取对应模块并保留客户主键，不能把标签标识或等级标识当作客户标识。
- 用户说“给客户打标签、调整等级或发权益卡”时，说明本 skill 只支持读取。

## 边界

- 积分商城开关、积分兑换记录和积分商品关联信息使用 `youzan-marketing`。
- 订单详情、退款详情和订单金额口径使用 `youzan-order`。
- 客户、标签、等级、权益卡、积分、分群的创建、编辑、启停、绑定、解绑、发放、增减和其他远端数据变更不在本入口范围内。
- 不根据客户原始字段生成画像、分层结论、趋势判断或个性化推荐。