概览
将公开商品页面整理成商品表,集中呈现名称、品牌、当地币种价格、折扣、评分和图片。分散在多个页面的信息可以放在一起查看,为商品选品和定价研究提供依据。
商品详情还能补充描述和规格,便于区分名称相近但配置不同的商品。结果保留原始名称与描述,不自动翻译商品内容,也不会根据名称猜测缺失属性。
数据说明
覆盖埃及、加纳、科特迪瓦、肯尼亚、摩洛哥、尼日利亚、塞内加尔和乌干达的公开商品,按页面展示顺序读取,同一国家的同一商品在一次结果中只保留一条。商品编号在不同国家之间不能直接视为相同商品。
价格是采集时的页面展示值,各国使用各自币种,运费和结算优惠不单独计算。划线价格是页面展示的比较价,不是历史采集价。未知数值以 -1 表示,未知文本为空或标记为未知;缺失的官方店标记不能据此判断为非官方店。采集时间使用世界协调时间。
结果不包含会员专属、无法公开访问或已经移除的商品,评价数量也不等同于可获取的文字评论数量。
结果长什么样
每条记录对应一件商品,以下为示意数据。
| 商品名称 | 当前价格 | 币种 | 平均评分 | 评价数量 |
|---|---|---|---|---|
| Poco M7 , 6.9" 6GB RAM / 128GB ROM - Silver | 225015 | NGN | 4 | 4 |
| Wireless Earbuds - Black | 15000 | NGN | 4.3 | 120 |
另外包含商品编号、品牌、商品链接、商品图片及可获取的详情信息。
应用场景
- 按“品牌”和“当前价格”比较同类商品的价格分布,为选品和定价寻找参考。
- 结合“平均评分”和“评价数量”筛选反馈较充分的商品,避免只凭评分高低作判断。
- 对照“商品名称”和“商品规格”检查配置差异,减少把不同容量或型号直接比较的情况。
适用边界
支持八个国家公开页面,每次最多返回 2000 件商品,不支持关键词搜索、历史价格比较和登录后数据。
- 适合用于
- 需要将支持国家的公开商品信息整理为表格。
- 不要用于
- 需要实时结算价、历史价格变化或登录后才能查看的数据。
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1访问受阻或要求验证时停止,不能将其视为空结果;请确认平台运行环境可正常访问目标站点。
- 2链接不存在时检查国家域名和商品地址,页面结构变化时需要更新采集程序。
- 3临时限流和连接超时可稍后重试;重跑会重新采集并按返回记录计费。
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 分类或商品链接
start_urls必填array<string>填写埃及、加纳、科特迪瓦、肯尼亚、摩洛哥、尼日利亚、塞内加尔和乌干达八个站点的分类或商品详情链接,可混合多个国家;不支持站内搜索和被禁止的筛选链接。数量最多 20 项示例["https://www.jumia.com.ng/smartphones/"] - 商品数量上限
max_products选填integer本次最多返回的商品总数,默认 100,最大 2000;每个分类最多扫描 50 页,总计最多扫描 10000 件。范围1–2000默认值100 - 采集商品详情
include_details选填boolean是否为分类中的商品补充详情,默认否;开启会增加页面读取量,商品链接本身始终读取详情。默认值false - 商品筛选
filters选填object按各国当地币种价格及五分制评分筛选,默认不筛选;筛选后的结果数量可能小于上限。
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 记录标识
idstring国家和商品编号组合,重复采集同一商品时保持不变。示例ng:419959878 - 国家
countrystring商品所属国家站点代码。示例ng - 币种
currencystring价格使用当地币种,未换算汇率。示例NGN - 商品编号
product_idstring商品链接中的数字编号。示例419959878
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"id": "ng:419959878",
"country": "ng",
"currency": "NGN",
"product_id": "419959878",
"sku": "PO424MP82HAYFNAFAMZ",
"title": "Poco M7 , 6.9\" 6GB RAM / 128GB ROM - Silver",
"brand": "Poco",
"price": 225015,
"old_price": 250000,
"discount_percent": 9.99,
"rating": 4,
"review_count": 4,
"product_url": "https://www.jumia.com.ng/poco-m7-6.9-6gb-ram-128gb-rom-silver-419959878.html",
"images": "<images>",
"seller": "FINET Comms - AC",
"official_store": "yes",
"availability": "in_stock",
"description": "Network & Connectivity :Dual SIM + microSDGSM:2/3/5/8 WCDMA: B1/2/4/5/8 LTE FDD: B1/2/3/4/5/7/8/18/19/20/26/28/66* LTE TDD: B38/40/41 *B66 supports 70MHz narrowband frequencyWireless NetworksWi-Fi: 2.4GHz | 5GHzSupports FM radio (with headphone luetooth 5.2Supports AAC / SBCNavigation & PositioningGPS | Glonass | Galileo | BDS (only B1C Audio3.5mm headphone SensorsVirtual proximity sensor | Virtual ambient light sensor | Accelerometer | Electronic compassOperating SystemAndroid 15 (Go Edition)",
"specifications": "[{\"@type\":\"PropertyValue\",\"name\":\"SKU\",\"value\":\"PO424MP82HAYFNAFAMZ\"},{\"@type\":\"PropertyValue\",\"name\":\"GTIN Barcode\",\"value\":\"05510181682889\"},{\"@type\":\"PropertyValue\",\"name\":\"Model\",\"value\":\"M7\"},{\"@type\":\"PropertyValue\",\"name\":\"Weight (kg)\",\"value\":\"0.2\"},{\"@type\":\"PropertyValue\",\"name\":\"Color\",\"value\":\"Silver\"}]",
"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-products",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。