概览
BestBuy 美国站评论数据适合了解单个商品在公开评论区中的真实反馈。给定商品详情页后,应用会汇总评论正文、标题、评分、用户、商品和媒体信息,形成可筛选、分组和对比的评论明细。
它把买家主评论与可见回复放到同一份结果中,并保留评论类型和父评论编号,便于还原反馈与回复关系,可作为口碑判断、问题归因和内容洞察的基础数据。
数据说明
数据来自 BestBuy 美国站商品的公开评论记录,排序依据由所选方式决定;同一评论以评论编号识别并合并重复记录。评论时间、发布时间和采集时间沿用来源展示格式,创建与更新时间戳以毫秒保存。评分保留为来源文本,公开回复可能没有评分;图片和视频以链接列表的字符串形式保留,缺少内容的字段保持为空。评论类型与父评论编号可用于区分主评论和回复。数据只覆盖公开可见内容,已删除或不可见的评论不在结果中。
结果长什么样
每条记录代表一条商品评论或公开回复:
| 评论编号 | 评论标题 | 评分 | 用户昵称 | 评论时间 |
|---|---|---|---|---|
| 2fe4a2c8-7fac-36ab-9f0c-8c0d0722cfad | Gift for Mom | 5 | LUISLUX | 2026/09/01 16:39:08 |
| d45dd7d3-eec9-3fab-875a-56f13ea493a0 | Good but not perfect | 4 | Levi | 2026/09/01 14:58:16 |
另有评论正文、评论类型、父评论编号、商品链接、评论图片、评论视频和采集时间等字段。
应用场景
- 做口碑体检时,按「评分」分组,结合「评论标题」和「评论正文」归纳主要优点与问题。
- 追踪服务反馈时,用「评论类型」「父评论编号」和「用户昵称」识别买家评论与公开回复,观察问题是否得到回应。
- 复盘商品反馈时,按「评论时间」观察意见变化,结合「商品链接」和「评分」比较不同商品的口碑表现。
适用边界
单次支持 1 个美国站商品,可指定 1–1000 条期望评论;结果按 20 条完整批次返回,实际数量可能高于填写值;仅覆盖公开可用评论。
- 适合用于
- 需要获取一个 BestBuy 美国站商品的公开评论明细时
- 需要分析评论正文、评分、用户、商品和评论时间时
- 不要用于
- 需要一次处理多个商品时——本应用每次只提交一个商品
- 需要非公开或登录后可见评论时——本应用只覆盖公开可用评论
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务部分成功时保留已完成的评论,并结合状态中的失败计数判断覆盖情况
- 2任务提交未知、失败或过期时,确认商品链接和凭证后重新提交
- 3返回空结果时先核对商品链接和公开评论可见性,再重试
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| product_url | 商品详情页链接 | string | 是 | — | — | https://www.bestbuy.com/site/6514530.p?skuId=6514530 | 填写 BestBuy 美国站商品详情页的完整链接,例如 https://www.bestbuy.com/site/6514530.p?skuId=6514530。 |
| expected_count | 期望评论数量 | string | 是 | — | — | 20 | 填写 1 至 2000 的整数文本。主评论与公开回复均计入期望数量;这是期望数量,不是严格返回上限;结果按每 20 条完整批次返回,实际数量可能因公开评论不足而少于填写值,也可能因批次补齐而多于填写值。 |
| order_type | 评论排序方式 | string(enum) | 是 | — | 4(最新) / 8(最相关) / 9(最有帮助) / 10(最老) / 11(最高评分) / 12(最低评分) | 8 | 选择评论排序方式:8 为最相关,9 为最有帮助,10 为最老,11 为最高评分,12 为最低评分。 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| biz_id | 业务标识 | string | — | 评论所属业务对象标识,通常为商品链接;无值时为空。 |
| comment_id | 评论编号 | string | — | 评论的稳定编号,用于识别和去重;无数据记录可能为空。 |
| comment_location | 评论来源地 | string | — | 评论来源位置标签;无值时为空。 |
| comment_text | 评论正文 | string | — | 评论或公开回复的正文内容;无值时为空。 |
| comment_time | 评论时间 | string | — | 评论显示时间,格式沿用来源数据;无值时为空。 |
| comment_title | 评论标题 | string | — | 评论标题;无值时为空。 |
| comment_type | 评论类型 | string | — | 来源数据中的评论类型编码,可用于区分主评论与回复;无值时为空。 |
| comment_url | 评论链接 | string | — | 评论列表或详情页链接;无值时为空。 |
| crawl_time | 采集时间 | string | — | 该记录被采集的时间;无值时为空。 |
| created_at | 创建时间戳 | integer | — | 来源记录创建时间的毫秒时间戳;无值时为空。 |
| image_url_list | 评论图片 | string | — | 评论图片链接列表的字符串表示;无值时为空。 |
| item_image_url_list | 商品图片 | string | — | 商品图片链接列表的字符串表示;无值时为空。 |
| item_sale_prop | 商品销售属性 | string | — | 商品销售属性信息;无值时为空。 |
| job_type | 任务类型 | string | — | 来源数据中的任务类型;无值时为空。 |
| level_name | 层级名称 | string | — | 来源数据层级名称;无值时为空。 |
| parent_comment_id | 父评论编号 | string | — | 回复所关联的父评论编号;无值时为空。 |
| platform_code | 平台编码 | string | — | 来源平台编码;无值时为空。 |
| product_title | 商品标题 | string | — | 评论所属商品标题;无值时为空。 |
| product_url | 商品链接 | string | — | 评论所属商品详情页链接;无值时为空。 |
| publish_time | 发布时间 | string | — | 评论发布时间;无值时为空。 |
| rating_score | 评分 | string | — | 来源数据中的评分文本;回复或无评分记录可能为空。 |
| sale_prop | 销售属性 | string | — | 评论对应的销售属性;无值时为空。 |
| shop_id | 店铺编号 | string | — | 评论所属店铺编号;无值时为空。 |
| shop_name | 店铺名称 | string | — | 评论所属店铺名称;无值时为空。 |
| site_code | 站点编码 | string | — | 来源站点编码;无值时为空。 |
| sku_id | SKU 编号 | string | — | 商品 SKU 编号;无值时为空。 |
| source_crawler_time | 来源采集时间 | string | — | 来源侧记录的采集时间;无值时为空。 |
| spu_id | SPU 编号 | string | — | 商品 SPU 编号;无值时为空。 |
| task_meta | 任务元信息 | string | — | 本条记录对应的任务商品与无数据标记。 |
| updated_at | 更新时间戳 | integer | — | 来源记录更新时间的毫秒时间戳;无值时为空。 |
| use_situation | 使用场景 | string | — | 评论中记录的使用场景;无值时为空。 |
| user_age | 用户年龄 | string | — | 评论用户年龄信息;无值时为空。 |
| user_avatar_url | 用户头像 | string | — | 评论用户头像链接;无值时为空。 |
| user_id | 用户编号 | string | — | 评论用户编号;无值时为空。 |
| user_name | 用户昵称 | string | — | 评论用户昵称;无值时为空。 |
| user_sex | 用户性别 | string | — | 评论用户性别信息;无值时为空。 |
| video_url_list | 评论视频 | string | — | 评论视频链接列表的字符串表示;无值时为空。 |
记录 Schema
输出按记录逐条返回。记录主键为 comment_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"biz_id": {
"type": "string",
"title": "业务标识",
"description": "评论所属业务对象标识,通常为商品链接;无值时为空。"
},
"comment_id": {
"type": "string",
"title": "评论编号",
"description": "评论的稳定编号,用于识别和去重;无数据记录可能为空。"
},
"comment_location": {
"type": "string",
"title": "评论来源地",
"description": "评论来源位置标签;无值时为空。"
},
"comment_text": {
"type": "string",
"title": "评论正文",
"description": "评论或公开回复的正文内容;无值时为空。"
},
"comment_time": {
"type": "string",
"title": "评论时间",
"description": "评论显示时间,格式沿用来源数据;无值时为空。"
},
"comment_title": {
"type": "string",
"title": "评论标题",
"description": "评论标题;无值时为空。"
},
"comment_type": {
"type": "string",
"title": "评论类型",
"description": "来源数据中的评论类型编码,可用于区分主评论与回复;无值时为空。"
},
"comment_url": {
"type": "string",
"title": "评论链接",
"description": "评论列表或详情页链接;无值时为空。"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "该记录被采集的时间;无值时为空。"
},
"created_at": {
"type": "integer",
"title": "创建时间戳",
"description": "来源记录创建时间的毫秒时间戳;无值时为空。"
},
"image_url_list": {
"type": "string",
"title": "评论图片",
"description": "评论图片链接列表的字符串表示;无值时为空。"
},
"item_image_url_list": {
"type": "string",
"title": "商品图片",
"description": "商品图片链接列表的字符串表示;无值时为空。"
},
"item_sale_prop": {
"type": "string",
"title": "商品销售属性",
"description": "商品销售属性信息;无值时为空。"
},
"job_type": {
"type": "string",
"title": "任务类型",
"description": "来源数据中的任务类型;无值时为空。"
},
"level_name": {
"type": "string",
"title": "层级名称",
"description": "来源数据层级名称;无值时为空。"
},
"parent_comment_id": {
"type": "string",
"title": "父评论编号",
"description": "回复所关联的父评论编号;无值时为空。"
},
"platform_code": {
"type": "string",
"title": "平台编码",
"description": "来源平台编码;无值时为空。"
},
"product_title": {
"type": "string",
"title": "商品标题",
"description": "评论所属商品标题;无值时为空。"
},
"product_url": {
"type": "string",
"title": "商品链接",
"description": "评论所属商品详情页链接;无值时为空。"
},
"publish_time": {
"type": "string",
"title": "发布时间",
"description": "评论发布时间;无值时为空。"
},
"rating_score": {
"type": "string",
"title": "评分",
"description": "来源数据中的评分文本;回复或无评分记录可能为空。"
},
"sale_prop": {
"type": "string",
"title": "销售属性",
"description": "评论对应的销售属性;无值时为空。"
},
"shop_id": {
"type": "string",
"title": "店铺编号",
"description": "评论所属店铺编号;无值时为空。"
},
"shop_name": {
"type": "string",
"title": "店铺名称",
"description": "评论所属店铺名称;无值时为空。"
},
"site_code": {
"type": "string",
"title": "站点编码",
"description": "来源站点编码;无值时为空。"
},
"sku_id": {
"type": "string",
"title": "SKU 编号",
"description": "商品 SKU 编号;无值时为空。"
},
"source_crawler_time": {
"type": "string",
"title": "来源采集时间",
"description": "来源侧记录的采集时间;无值时为空。"
},
"spu_id": {
"type": "string",
"title": "SPU 编号",
"description": "商品 SPU 编号;无值时为空。"
},
"task_meta": {
"type": "string",
"title": "任务元信息",
"description": "本条记录对应的任务商品与无数据标记。"
},
"updated_at": {
"type": "integer",
"title": "更新时间戳",
"description": "来源记录更新时间的毫秒时间戳;无值时为空。"
},
"use_situation": {
"type": "string",
"title": "使用场景",
"description": "评论中记录的使用场景;无值时为空。"
},
"user_age": {
"type": "string",
"title": "用户年龄",
"description": "评论用户年龄信息;无值时为空。"
},
"user_avatar_url": {
"type": "string",
"title": "用户头像",
"description": "评论用户头像链接;无值时为空。"
},
"user_id": {
"type": "string",
"title": "用户编号",
"description": "评论用户编号;无值时为空。"
},
"user_name": {
"type": "string",
"title": "用户昵称",
"description": "评论用户昵称;无值时为空。"
},
"user_sex": {
"type": "string",
"title": "用户性别",
"description": "评论用户性别信息;无值时为空。"
},
"video_url_list": {
"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": {
"SpiderKing999__bestbuy-us-comment": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderKing999/bestbuy-us-comment",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 20 条为一个计费单位,不足 20 条按 20 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。