Shopify 店铺评论采集
输入 Shopify 店铺域名,返回店铺的商品评论和店铺评论;不管店铺用哪个评论插件,字段都统一
概览
Shopify 上的 DTC 品牌把最真实的用户反馈放在自己的网站上:商品评论和对店铺本身的评论,通过十几种不同的评论插件展示。这个 App 把一批店铺域名变成一张干净的评论表,不管每家店用的是哪个评论插件,字段都一样。
这样品牌独立站的评论就能规模化使用:产品团队可以看用户怎么评价自家和竞品的商品,洞察团队可以把多个品牌的成千上万条评论放进情感或话题分析,品类经理不用逐个打开网站,就能比较同类商品在不同品牌的口碑。
数据说明
评论直接来自每个店铺自己的评论插件,和消费者在品牌网站上看到的一致。大多数评论插件按最新优先返回。每条评论只出现一次:店铺在同一商品的多个规格或版本(例如正装和旅行装)下展示同一条评论时,只在第一个商品下返回,其他版本列在「同时显示在」里;同样的文字发在确实不同的商品下,算作不同的评论。
「评论类型」区分针对商品的评论和针对店铺本身(服务、物流)的评论。「评分」为 1–5 分,「评论时间」为 UTC 时区。有些店铺在网站上隐藏评论日期,这类评论没有日期。「评论人」和「评论人地区」属于个人信息,只有选择包含评论人信息时才返回。
不覆盖:用 REVIEWS.io 展示评论的店铺(暂不支持,会标记为 blocked)、非 Shopify 店铺、其他服务商展示的评论(例如电商平台或第三方评分网站)、店铺隐藏或未发布的评论,以及少数评论插件下已下架商品的评论。
结果示例
每条记录是一条评论。
| 店铺 | 商品名称 | 评分 | 评论标题 | 评论时间 | 已验证买家 |
|---|---|---|---|---|---|
| www.brooklinen.com | Luxe Sateen Core Sheet Set | 5 | These are the best sheets | 2026-11-05T06:19:19+00:00 | 是 |
| www.brooklinen.com | Luxe Sateen Core Sheet Set | 5 | Really nice | 2026-11-05T02:22:41+00:00 | 是 |
| www.tentree.com | Juniper Fleece Hoodie | 4 | Cozy but runs large | 2026-10-28T15:04:11+00:00 | 是 |
另有评论内容、评论类型、评论插件、商品链接、同时显示在、店铺回复等字段。
使用场景
- 找出差评原因:筛选「评分」为 1–2 的评论,按「商品名称」分组阅读「评论内容」,反复出现的问题(尺码、耐用度、物流)指出先改哪个商品或环节。
- 和竞品对比:一次采集多个品牌,在相同的「评论时间」范围内,按「店铺」和「商品名称」比较平均「评分」和评论数量。
- 跟踪上新或调整后的变化:对某个「商品名称」按「评论时间」的月份统计评论数和平均「评分」,并看其中「已验证买家」评论的占比。
- 看品牌如何应对差评:统计低分评论中有「店铺回复」的比例,并对照「评论内容」阅读回复。
适用边界
采集使用 Judge.me、Yotpo、Okendo、Loox、Klaviyo Reviews、Stamped、Junip、Fera、Growave 或 Rivyo 的 Shopify 店铺的公开评论;每次最多 200 个店铺,每个店铺最多 10,000 条评论。暂不支持 REVIEWS.io
- 适合用于
- 需要一个或多个 Shopify 品牌独立站上展示的用户评论,用于评论分析、产品反馈或竞品对比
- 手上有一批 DTC 品牌域名,想把它们的评论汇总成一张表,不管各店用的是哪个评论插件
- 不要用于
- 店铺不是 Shopify,或评论来自不在支持列表里的服务商(例如 Bazaarvoice、PowerReviews、Trustpilot):请使用对应网站或服务商的 App
- 店铺用 REVIEWS.io 展示评论:暂不支持,因为 REVIEWS.io 目前拒绝来自平台的请求,这类店铺会标记为 blocked
- 需要电商平台评论(Amazon、eBay、Walmart):请使用对应平台的评论 App
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1店铺没有支持的评论插件或没有公开评论时不返回记录,运行日志里会写明原因
- 2店铺限制访问时会自动重试一次;仍然没有结果的,稍后单独再跑一次
- 3本次所有店铺都没有返回结果时,运行以 no-store-collected 失败结束,而不是空结果成功
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- Shopify 店铺域名
stores必填array<string>要采集的 Shopify 店铺域名,例如 www.brooklinen.com。填完整网址也可以,只取其中的域名。数量最多 200 项示例["www.brooklinen.com"] - 评论插件
plugin选填string(enum)读取哪个评论插件的评论。默认自动识别每个店铺用的插件;只有店铺同时装了两个评论插件、而你想要评论较少的那个时才需要手动指定。可选值如 auto(自动识别) / judgeme(Judge.me) / yotpo(Yotpo) / okendo(Okendo) / loox(Loox) / klaviyo_reviews(Klaviyo Reviews) / stamped(Stamped) / junip(Junip) …(共 11 项,试运行表单可搜索)默认值auto - 每个店铺最多评论数
max_reviews_per_store选填integer每个店铺最多返回多少条评论,插件支持时从最新的开始取。默认 1000,最多 10000。范围1–10000默认值1000 - 包含店铺评论
include_store_reviews选填boolean除了商品评论,也返回对店铺本身(服务、物流)的评论。默认开启。默认值true - 起始日期(YYYY-MM-DD)
since选填string只返回这一天及之后写的评论,例如 2025-01-01。留空表示不限日期;没有日期的评论始终保留。默认值 - 包含评论人姓名和地区
include_reviewer_info选填boolean返回评论人的显示名和地区,属于个人信息。默认关闭。默认值false
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 记录编号
record_idstring评论的唯一编号:店铺域名、评论插件和评论自身编号组合而成。同一条评论再次采集时不变。示例www.brooklinen.com:yotpo:921327143 - 店铺
storestring评论所在店铺的域名。示例www.brooklinen.com - 评论插件
pluginstring店铺用来收集和展示评论的插件,例如 Judge.me 或 Yotpo。示例Yotpo - 评论类型
review_typestring评论针对的是商品,还是店铺本身(服务、物流)。示例product
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"record_id": "www.brooklinen.com:yotpo:921327143",
"store": "www.brooklinen.com",
"plugin": "Yotpo",
"review_type": "product",
"review_id": "921327143",
"product_id": "7580256390",
"product_handle": "luxe-core-sheet-set",
"product_title": "Luxe Sateen Core Sheet Set",
"product_url": "https://www.brooklinen.com/products/luxe-core-sheet-set",
"shared_with_products": "Luxe Sateen Core Sheet Set - Travel Size",
"rating": 5,
"title": "These are the best sheets",
"body": "These are the best sheets ever. I look forward to getting into bed each night now. I agree with past reviewers that they feel incredible. Can’t recommend them more.",
"created_at": "2026-11-05T06:19:19+00:00",
"verified_buyer": true,
"reviewer_name": "Jane D.",
"reviewer_location": "United States",
"store_reply": "Thank you so much for the kind words, we're thrilled you love them!",
"collected_at": "2026-11-06T19:52:48+00:00"
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=data_gogetter/shopify-store-reviews",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。