概览
输入一个 TikTok Shop 商品 ID 或 SPU,获取该商品公开评论区的结构化记录。每条记录同时保留评论正文、评分、发布时间、用户昵称、SKU 规格以及商品编号,便于把零散的用户反馈整理成可分析的评论底表。
评论内容适合用来观察真实使用感受和常见问题,也能帮助团队比较不同商品的口碑表现。数据来自美区 TikTok Shop 的公开商品评论,评论文本、评分和时间按来源记录保留,头像、图片和主页链接等信息在有公开值时一并返回。
数据说明
一条记录代表一条商品评论。同一条评论按评论编号识别,商品编号、SKU 编号和商品评分用于还原评论所属商品与规格。评论时间和采集时间是来源文本,接口没有声明时区;用户昵称和用户编号按公开展示内容返回,匿名评论可能缺少用户信息。仅覆盖公开可见内容,接口没有提供的来源名称、评论链接或互动数量会为空。
结果长什么样
下面是一条公开评论记录的示例:
| 评论编号 | 商品编号 | 评论正文 | 评分 | 发布时间 | 用户昵称 |
|---|---|---|---|---|---|
| 7634602945472333582 | 1732075599219691674 | So I bought the zoom regular shoes last year, but they are too soft too spongy when you’re just walking around these are just right! Wide toe box Support you need support soft where you need it soft! I owned just about every air max and this is the best I’ve felt on my feet! Can’t say enough | 5 | 2026-05-01T01:18:51 | Os Hs |
应用场景
- 用评论正文和评分归纳商品的满意点与常见问题
- 按发布时间观察口碑变化,并结合采集时间标记数据快照
- 按商品编号、SKU 规格和评分比较不同规格的反馈差异
- 用用户昵称、头像和图片信息辅助识别公开评论中的内容线索
适用边界
每次任务支持 1 个 TikTok Shop 商品 ID 或 SPU,期望采集 1–4500 条评论;结果按每页 30 条获取,最多保护 150 页,覆盖美区公开商品评论。
- 适合用于
- 需要批量获取 TikTok Shop 商品的公开评论、评分和发布时间时
- 需要分析商品口碑、评论内容、用户昵称和 SKU 反馈时
- 不要用于
- 需要订单、买家联系方式或其他非公开店铺数据时
- 需要实时单条评论而不是后台采集任务时
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1没有评论时先核对商品 ID 或 SPU,并用是否无数据标记区分无评论与任务失败
- 2任务部分成功时继续使用已返回评论;失败或过期后修正商品标识并重新提交
- 3鉴权失败、任务上下文不匹配或服务超时时,检查执行环境凭证并重新提交,不要重复使用旧任务
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| product_item | 商品 ID/SPU | string | 是 | — | — | 1732075599219691674 | 要采集评论的 TikTok Shop 商品 ID 或 SPU,一次任务填写一个标识,长度为 1–512 个字符。 |
| crawl_count | 期望采集评论条数 | string | 是 | — | — | 30 | 本次任务期望采集的评论条数,填写 1–4500 的整数文本;实际返回可能少于该数量,结果按每页 30 条获取。 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| avatar_url_list | 用户头像 | string | ["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7b7cc85e68a43794946269620078f2ac~tplv-tiktokx-cropcenter:100:100.jpg"] | 评论用户头像链接列表的原始 JSON 文本;无值时为空。 |
| biz_id | 业务编号 | string | 1732075599219691674 | 评论记录的业务编号;无值时为空。 |
| comment_id | 评论编号 | string | 7634602945472333582 | TikTok Shop 评论的稳定唯一编号,用于识别和去重;无值时为空。 |
| comment_source_name | 评论来源名称 | string | — | 评论来源名称;无值时为空。 |
| comment_source_type | 评论来源类型 | string | — | 评论来源类型;无值时为空。 |
| comment_text | 评论正文 | string | So I bought the zoom regular shoes last year, but they are too soft too spongy when you’re just walking around these are just right! Wide toe box Support you need support soft where you need it soft! I owned just about every air max and this is the best I’ve felt on my feet! Can’t say enough | 用户公开发布的评论文字;无值时为空。 |
| comment_time_text | 评论时间文本 | string | — | 来源记录中的评论时间原文;无值时为空。 |
| comment_type | 评论类型 | string | 1 | 评论类型编码原文;无值时为空。 |
| comment_url | 评论链接 | string | — | 评论详情链接;无值时为空。 |
| crawl_time | 采集时间 | string | 2026-09-14T16:19:49 | 该评论记录被采集的时间文本,接口未声明时区;无值时为空。 |
| created_at | 创建时间戳 | string | 1789373989528 | 评论来源记录创建时间的毫秒时间戳字符串;无值时为空。 |
| image_url_list | 评论图片 | string | [] | 评论图片链接列表的原始 JSON 文本;无值时为空。 |
| is_anonymous | 是否匿名 | boolean | false | 评论用户是否匿名;接口无值时为空。 |
| is_digged | 是否获赞 | boolean | false | 该评论是否被当前采集视角标记为已点赞;接口无值时为空。 |
| is_owner | 是否店主评论 | boolean | false | 该评论是否来自店铺所有者;接口无值时为空。 |
| is_updated | 是否更新过 | boolean | false | 该评论是否被更新过;接口无值时为空。 |
| item_id | 商品项编号 | string | 1732075599219691674 | 该评论对应的 TikTok Shop 商品项编号;无值时为空。 |
| like_count | 获赞数量 | string | — | 评论获赞数量的原始字符串;无值时为空。 |
| parent_comment_id | 父评论编号 | string | — | 该评论直接回复的父评论编号;无值时为空。 |
| product_id | 商品编号 | string | 1732075599219691674 | 评论所属的 TikTok Shop 商品编号;无值时为空。 |
| product_rating | 商品评分 | string | 5 | 评论记录中的商品评分原始字符串;无值时为空。 |
| publish_time | 发布时间 | string | 2026-05-01T01:18:51 | 评论公开发布时间文本;无值时为空。 |
| rating_score | 评分 | string | 5 | 评论评分的原始字符串;无值时为空。 |
| ratings_url | 评分链接 | string | — | 评分详情链接;无值时为空。 |
| sku_id | SKU 编号 | string | 1732075635013226650 | 评论对应商品 SKU 的编号;无值时为空。 |
| sku_specification | SKU 规格 | string | US M 13 | 评论对应商品 SKU 的规格文本;无值时为空。 |
| spu_id | SPU 编号 | string | 1732075599219691674 | 评论对应商品 SPU 的编号;无值时为空。 |
| task_item | 查询商品 | string | 1732075599219691674 | 本条评论对应的输入商品 ID 或 SPU,用于区分任务项。 |
| no_data | 是否无数据 | boolean | false | 该商品是否没有可用评论数据。 |
| updated_at | 更新时间戳 | string | 1789373989851 | 评论来源记录更新时间的毫秒时间戳字符串;无值时为空。 |
| user_id | 用户编号 | string | 7435352589535626286 | 评论用户公开编号;无值时为空。 |
| user_name | 用户昵称 | string | O**s H**s | 评论用户公开昵称;无值时为空。 |
| user_profile_url | 用户主页链接 | string | — | 评论用户公开主页链接;无值时为空。 |
记录 Schema
输出按记录逐条返回。记录主键为 comment_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"avatar_url_list": {
"type": "string",
"title": "用户头像",
"description": "评论用户头像链接列表的原始 JSON 文本;无值时为空。",
"prefill": "[\"https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7b7cc85e68a43794946269620078f2ac~tplv-tiktokx-cropcenter:100:100.jpg\"]"
},
"biz_id": {
"type": "string",
"title": "业务编号",
"description": "评论记录的业务编号;无值时为空。",
"prefill": "1732075599219691674"
},
"comment_id": {
"type": "string",
"title": "评论编号",
"description": "TikTok Shop 评论的稳定唯一编号,用于识别和去重;无值时为空。",
"prefill": "7634602945472333582"
},
"comment_source_name": {
"type": "string",
"title": "评论来源名称",
"description": "评论来源名称;无值时为空。"
},
"comment_source_type": {
"type": "string",
"title": "评论来源类型",
"description": "评论来源类型;无值时为空。"
},
"comment_text": {
"type": "string",
"title": "评论正文",
"description": "用户公开发布的评论文字;无值时为空。",
"prefill": "So I bought the zoom regular shoes last year, but they are too soft too spongy when you’re just walking around these are just right! Wide toe box Support you need support soft where you need it soft! I owned just about every air max and this is the best I’ve felt on my feet! Can’t say enough"
},
"comment_time_text": {
"type": "string",
"title": "评论时间文本",
"description": "来源记录中的评论时间原文;无值时为空。"
},
"comment_type": {
"type": "string",
"title": "评论类型",
"description": "评论类型编码原文;无值时为空。",
"prefill": "1"
},
"comment_url": {
"type": "string",
"title": "评论链接",
"description": "评论详情链接;无值时为空。"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "该评论记录被采集的时间文本,接口未声明时区;无值时为空。",
"prefill": "2026-09-14T16:19:49"
},
"created_at": {
"type": "string",
"title": "创建时间戳",
"description": "评论来源记录创建时间的毫秒时间戳字符串;无值时为空。",
"prefill": "1789373989528"
},
"image_url_list": {
"type": "string",
"title": "评论图片",
"description": "评论图片链接列表的原始 JSON 文本;无值时为空。",
"prefill": "[]"
},
"is_anonymous": {
"type": "boolean",
"title": "是否匿名",
"description": "评论用户是否匿名;接口无值时为空。",
"prefill": false
},
"is_digged": {
"type": "boolean",
"title": "是否获赞",
"description": "该评论是否被当前采集视角标记为已点赞;接口无值时为空。",
"prefill": false
},
"is_owner": {
"type": "boolean",
"title": "是否店主评论",
"description": "该评论是否来自店铺所有者;接口无值时为空。",
"prefill": false
},
"is_updated": {
"type": "boolean",
"title": "是否更新过",
"description": "该评论是否被更新过;接口无值时为空。",
"prefill": false
},
"item_id": {
"type": "string",
"title": "商品项编号",
"description": "该评论对应的 TikTok Shop 商品项编号;无值时为空。",
"prefill": "1732075599219691674"
},
"like_count": {
"type": "string",
"title": "获赞数量",
"description": "评论获赞数量的原始字符串;无值时为空。"
},
"parent_comment_id": {
"type": "string",
"title": "父评论编号",
"description": "该评论直接回复的父评论编号;无值时为空。"
},
"product_id": {
"type": "string",
"title": "商品编号",
"description": "评论所属的 TikTok Shop 商品编号;无值时为空。",
"prefill": "1732075599219691674"
},
"product_rating": {
"type": "string",
"title": "商品评分",
"description": "评论记录中的商品评分原始字符串;无值时为空。",
"prefill": "5"
},
"publish_time": {
"type": "string",
"title": "发布时间",
"description": "评论公开发布时间文本;无值时为空。",
"prefill": "2026-05-01T01:18:51"
},
"rating_score": {
"type": "string",
"title": "评分",
"description": "评论评分的原始字符串;无值时为空。",
"prefill": "5"
},
"ratings_url": {
"type": "string",
"title": "评分链接",
"description": "评分详情链接;无值时为空。"
},
"sku_id": {
"type": "string",
"title": "SKU 编号",
"description": "评论对应商品 SKU 的编号;无值时为空。",
"prefill": "1732075635013226650"
},
"sku_specification": {
"type": "string",
"title": "SKU 规格",
"description": "评论对应商品 SKU 的规格文本;无值时为空。",
"prefill": "US M 13"
},
"spu_id": {
"type": "string",
"title": "SPU 编号",
"description": "评论对应商品 SPU 的编号;无值时为空。",
"prefill": "1732075599219691674"
},
"task_item": {
"type": "string",
"title": "查询商品",
"description": "本条评论对应的输入商品 ID 或 SPU,用于区分任务项。",
"prefill": "1732075599219691674"
},
"no_data": {
"type": "boolean",
"title": "是否无数据",
"description": "该商品是否没有可用评论数据。",
"prefill": false
},
"updated_at": {
"type": "string",
"title": "更新时间戳",
"description": "评论来源记录更新时间的毫秒时间戳字符串;无值时为空。",
"prefill": "1789373989851"
},
"user_id": {
"type": "string",
"title": "用户编号",
"description": "评论用户公开编号;无值时为空。",
"prefill": "7435352589535626286"
},
"user_name": {
"type": "string",
"title": "用户昵称",
"description": "评论用户公开昵称;无值时为空。",
"prefill": "O**s H**s"
},
"user_profile_url": {
"type": "string",
"title": "用户主页链接",
"description": "评论用户公开主页链接;无值时为空。"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"mona_kk__tiktok-shop-comment": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/tiktok-shop-comment",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。每 30 条为一个计费单位,不足 30 条按 30 条计。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。