淘宝评价采集 Skill
触发词
采集淘宝评价
淘宝评价采集
抓取淘宝评论
导入淘宝评价
功能
从淘宝/天猫商品链接批量采集评价数据，下载评论图片/视频为附件，写入飞书多维表格。
输入参数
| 参数 | 必填 | 说明 |
|---|---|---|
| 商品链接 | 是 | 1~3 个淘宝/天猫商品链接，逗号分隔 |
| API Key | 是 | Just One API 的 Token |
| 飞书 Base Token | 是 | 目标多维表格的 base_token |
| 飞书 Table ID | 是 | 目标数据表的 table_id |
| 采集页数 | 否 | 每个链接采集的页数，默认 1 |
| 排序方式 | 否 | feedbackdate（按反馈日期）/ general（通用，淘宝默认排序/有图优质优先），默认 general |
| 包含默认好评 | 否 | 默认过滤系统默认好评，传此参数则保留 |
输出字段（20 个）
| 字段 | 类型 | 说明 |
|---|---|---|
| 商品ID | 文本 | 从链接解析 |
| 评价ID | 文本 | 唯一评价标识 |
| 评价内容 | 文本 | 买家评价正文 |
| 评价时间 | 文本 | 评价日期 |
| 评价等级 | 文本 | 1-5 星 |
| 有用数 | 数字 | 其他用户标记"有用"的次数 |
| 购买数量 | 数字 | 购买件数 |
| 商品规格 | 文本 | SKU 信息 |
| 商品标题 | 文本 | 商品名称（评价接口不返回，恒为空） |
| 买家昵称 | 文本 | 匿名处理后的昵称 |
| 评价图片 | 附件 | 评论配图（下载后上传为附件） |
| 评价视频 | 附件 | 评论视频（下载后上传为附件） |
| 价格金额 | 数字 | 购买价格（评价接口不返回，恒为空） |
| 币种 | 文本 | 货币代码（评价接口不返回，恒为空） |
| 商品链接 | 文本 | 商品详情页链接 |
| 商品图片URL | 文本 | 商品主图（评价接口不返回，恒为空） |
| 采集时间 | 文本 | 采集时间戳 |
| 追评JSON | 文本 | 追评内容 JSON |
| 商家回复 | 文本 | 商家回复 JSON |
| 标签 | 文本 | 评价标签 |
流程
- 输入校验：商品链接（上限 3 个）、API Key、目标表信息
- 采集：逐链接 × 分页调用 Just One API
GET /api/taobao/get-item-comment/v3 - 解析与过滤：过滤系统默认好评（可关闭），提取图片/视频 URL
- 附件下载上传：下载到本地临时目录 →
lark-cli base +record-upload-attachment上传到已创建记录 - 预览：展示采集结果条数、附件上传情况
- 确认门控：等待用户确认后写入
- 写入：
lark-cli分批batch_create写入记录
约束
- 商品链接上限 3 个
- 附件上传走
lark-cli base +record-upload-attachment（先写记录，再逐条追加附件） - 写入前需人工确认
- 写入时自动创建缺失的附件字段（评价图片/评价视频）
- 全部新增不去重
关键实现要点（踩坑记录）
- base_token 必须用真实 app_token：模板表若来自知识库（Wiki），URL 里的 token 是 Wiki 节点 token（如
PmdH...），它只能读字段、不能写记录（报param baseToken is invalid）。必须用lark-cli drive +inspect <wiki_url>解析出的真实 app_token（如Mx0NbZUkGaGdsTsPiBpcIThsnlg）做写入。 - 附件上传的
--file只接受当前目录内的相对路径：lark-cli base +record-upload-attachment --file传绝对路径（如/var/folders/...）会报unsafe file path。脚本已处理——把 lark-cli 的工作目录切到附件所在目录，只传文件名（相对路径）。 - 附件字段不能直接写 JSON：
batch_create时附件字段不能作为普通 CellValue 写入，必须先写记录拿到record_id，再用+record-upload-attachment逐条追加。 - 补传模式：
collect.py --record-ids <逗号分隔ID>跳过 batch_create，把重新采集的附件直接上传到已有记录（用于首次附件上传失败后的补传，顺序需与采集顺序一致）。 - 三个字段恒为空（接口限制，非 bug）：
product-reviews-v3评价接口不返回商品标题（auction.title）、商品主图（auction.auctionPic）、价格/币种（bidPriceMoney恒为 null）。这三个字段已确认接受为空，若未来需补全需另接商品详情接口。 - 确认门控是 Agent 行为约定，非脚本内建：脚本本身一条命令跑完「采集→写记录→传附件」；「写前人工确认」由调用方（Agent）先用
--dry-run预览、经用户确认后再执行正式写入。若未来接入定时任务/自动化触发，需另行在脚本加--confirm交互。
已知边界
- 视频附件链路已实现但未实测（本次验证只覆盖图片）
- 多链接（上限 3）、多页（>1）、失败重试分支已实现但未实测
使用示例
采集淘宝评价
链接: https://item.taobao.com/item.htm?id=123456789, https://detail.tmall.com/item.htm?id=987654321
API Key: sk-xxxx
Base Token: Mx0NbZUkGaGdsTsPiBpcIThsnlg
Table ID: tblXAWWKDp0f2zfH
页数: 2
技术实现
- 采集脚本:
scripts/collect.py - 字段映射: 已固化在
scripts/collect.py的parse_review_fields()（20 个字段） - 附件上传:
lark-cli base +record-upload-attachment（写入记录后追加）
