给一个 Target 商品 SKU、期望评论数量和排序方式,返回该商品的公开评论明细
概览
将公开商品的文字评论整理成逐条记录,保留评论标题、正文、星级和日期,方便集中阅读消费者反馈。每条评论同时关联商品编号和名称,便于将反馈追溯到具体商品。
结果区分是否发现验证购买标记,帮助研究者按照证据筛选反馈。评论保留原文,不生成情感结论,也不会将缺失的星级补成好评或差评。
数据说明
覆盖埃及、加纳、科特迪瓦、肯尼亚、摩洛哥、尼日利亚、塞内加尔和乌干达公开商品下可访问的文字评论,按页面展示顺序读取,在一次结果中按评论标识去重。结果不包含评论者姓名,也不包含只有星级而没有可识别文字的反馈。
“验证购买”为是,表示页面出现明确的购买验证标记;为否表示未发现该标记,不能据此认定评论者没有购买。商品的评价数量与公开文字评论数量可能不同,不应互相代替。
可识别的评论日期统一为年、月、日;无法识别时保留原文,日期缺失时留空。评论日期不添加源站未提供的时区,采集时间使用世界协调时间。页面未提供的星级以 -1 表示,不能将其纳入正常星级平均值。已删除和非公开评论不在覆盖范围内。
结果长什么样
每条记录对应一条文字评论,以下为示意数据。
| 商品名称 | 评论星级 | 评论标题 | 评论日期 | 验证购买 |
|---|---|---|---|---|
| Poco M7 , 6.9" 6GB RAM / 128GB ROM - Silver | 5 | Just as advertised. | 2026-11-06 | 是 |
| G&G AVENUE Men's Summer Sports Shorts | 3 | Average quality | 2026-10-21 | 否 |
另外包含评论正文、商品链接和采集时间,方便复核原始语境。
应用场景
- 结合“评论星级”和“评论正文”整理低分原因,为商品改进寻找具体问题。
- 按“商品名称”和“评论日期”归集反馈,比较不同商品近期被提及的问题。
- 使用“验证购买”筛选有明确购买标记的记录,再阅读“评论正文”,形成证据范围清楚的反馈样本。
适用边界
支持八个国家公开商品评论,每次最多返回 2000 条,不包含评论者姓名和非公开评论。
- 适合用于
- 需要研究指定商品的公开文字评论和购买验证标记。
- 不要用于
- 需要评论者联系方式、非公开内容或自动生成情感结论。
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1访问受阻或要求验证时停止,不能将其视为空结果;请确认平台运行环境可正常访问目标站点。
- 2链接不存在时检查国家域名和商品地址,页面结构变化时需要更新采集程序。
- 3临时限流和连接超时可稍后重试;重跑会重新采集并按返回记录计费。
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 商品链接
product_urls必填array<string>填写埃及、加纳、科特迪瓦、肯尼亚、摩洛哥、尼日利亚、塞内加尔和乌干达八个站点的商品详情链接,保留页面原始国家域名,不接受分类和搜索链接。数量最多 20 项示例["https://www.jumia.com.ng/poco-m7-6.9-6gb-ram-128gb-rom-silver-419959878.html"] - 每件商品评论上限
max_reviews_per_product选填integer每件商品最多返回的评论数,默认 20,最大 2000;每件最多扫描 200 页,实际数量可能较少。范围1–2000默认值20 - 评论总数上限
max_reviews选填integer全部商品合计最多返回的评论数,默认 200,最大 2000。范围1–2000默认值200 - 仅验证购买评论
verified_only选填boolean是否只返回明确标记为验证购买的评论,默认否;开启后缺失标记的评论不会返回。默认值false
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 评论标识
idstring由国家、商品编号和源评论标识组成;源评论标识缺失时使用评论内容摘要。示例ng:419959878:538b38b4a60bc9af937907b748cb8620ed7ee9e5f27df71f643891352553dab9 - 国家
countrystring商品所属国家站点代码。示例ng - 商品编号
product_idstring商品链接中的数字编号。示例419959878 - 商品 SKU
skustring商品页面的配置 SKU,未提供时为空字符串。示例PO424MP82HAYFNAFAMZ
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"id": "ng:419959878:538b38b4a60bc9af937907b748cb8620ed7ee9e5f27df71f643891352553dab9",
"country": "ng",
"product_id": "419959878",
"sku": "PO424MP82HAYFNAFAMZ",
"product_url": "https://www.jumia.com.ng/poco-m7-6.9-6gb-ram-128gb-rom-silver-419959878.html",
"product_title": "Poco M7 , 6.9\" 6GB RAM / 128GB ROM - Silver",
"rating": 5,
"title": "Just as advertised.",
"text": "All specs work as it should based on the specs advertised. Very good battery life.",
"review_date": "2026-11-06",
"verified_purchase": true,
"scraped_at": "2026-11-09T10:30:25+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=donglichun/jumia-reviews",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。