概览
把商品搜索结果整理成可比较的清单,将搜索关键词、展示位置、当地价格和评价信息保存在同一行。研究一类商品时,可以直接观察搜索列表里出现了哪些品牌与型号,而不必逐条抄录页面。
同一商品可能出现在不同关键词的结果中。保留这种对应关系,有助于区分不同搜索意图下的商品覆盖,也方便把后续采集结果与本次清单做比较。
数据说明
数据来自公开商品搜索列表,保留采集时的默认展示顺序。搜索排名表示本次读取到的列表位置,包含推荐位,不代表销量;同一关键词内按商品去重,不同关键词独立保留。站点调整排序时,位置可能变化。
当前价格和划线价格均为列表展示值,使用当地币种,不能跨币种直接比较;划线价不是上次采集价,最终结算金额还可能受运费及优惠条件影响。未提供的数值记为 -1,文本留空,不能视为零价格或零评分。未发现官方店标记时表示未确认。
只覆盖公开可见商品,不包含登录后专属内容。采集时间采用世界协调时间,用于区分不同批次。
结果长什么样
每条记录表示一个关键词下的一件商品。
| 搜索关键词 | 搜索排名 | 商品名称 | 当前价格 | 币种 | 平均评分 |
|---|---|---|---|---|---|
| samsung | 1 | Galaxy A07 4G, 6.7", 64GB + 4GB RAM (Dual SIM), 5000mAh, Black (2YRs WRTY) | 14700.0 | KES | 4.4 |
| samsung | 2 | Galaxy A06, 6.7", 4GB RAM+ 64GB (Dual SIM), 5000mAh, Black (1YR WRTY) | 13300.0 | KES | 4.2 |
结果还包含品牌、商品编号、商品图片、商品链接和采集时间。
应用场景
- 商品覆盖研究:结合搜索关键词、品牌和商品名称,观察不同需求下有哪些商品出现。
- 定价比较:在相同国家和币种内,按当前价格分组,再结合平均评分与评价数量筛选比较对象。
- 展示位置观察:保存多次采集结果,通过记录标识、搜索排名和采集时间比较同一商品的位置变化。
适用边界
覆盖八个国家的公开商品搜索列表,最多 20 个关键词、每词最多 50 页且全次合计不超过 2000 条,不采详情、评论或登录后信息。
- 适合用于
- 需要按关键词收集商品列表,并比较展示位置、价格和评分。
- 不要用于
- 需要销售数量、付费广告归因、个性化排名、商品完整详情或历史价格。
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1要求验证码或拒绝访问时停止,不会将访问失败记为空结果;请确认运行环境能访问所选国家站点。
- 2页面结构变化或分页改变关键词时需要检查采集程序;无匹配商品时正常返回空结果。
- 3临时限流或连接超时可稍后重试,已写回的记录仍保留并计费;再次运行会重新采集。
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 国家站点
country必填string(enum)选择要搜索的国家,结果价格保留当地币种。可选值埃及eg加纳gh科特迪瓦ci肯尼亚ke摩洛哥ma尼日利亚ng塞内加尔sn乌干达ug示例ke - 搜索关键词
keywords必填array<string>每个词组作为一次独立搜索,最多 20 个;同一关键词内去重,不同关键词分别保留结果。每个词组最多 200 个字符。数量最多 20 项示例["samsung"] - 每个关键词最多返回条数
max_results_per_keyword选填integer默认每个关键词最多返回 100 条,按站内默认顺序采集;每次运行合计最多 2000 条,每个关键词最多扫描 50 页。范围1–2000默认值100
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 记录标识
idstring由国家、关键词摘要和商品编号组合,同一关键词的同一商品重复采集时保持不变。示例ke:968e2d5b08687bf42997461c:325675454 - 国家
countrystring商品所属国家站点代码。示例ke - 搜索关键词
keywordstring本条结果对应的关键词,去除首尾空白。示例samsung - 搜索排名
rankinteger在采集到的列表中的展示位置,从 1 开始跨页累计;包含推荐位,去重后可能不连续,不代表销量排名。示例1
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"id": "ke:968e2d5b08687bf42997461c:325675454",
"country": "ke",
"keyword": "samsung",
"rank": 1,
"page": 1,
"product_id": "325675454",
"sku": "SA948MP5POCTWNAFAMZ",
"title": "Galaxy A07 4G, 6.7\", 64GB + 4GB RAM (Dual SIM), 5000mAh, Black (2YRs WRTY)",
"brand": "Samsung",
"price": 14700,
"currency": "KES",
"old_price": 18500,
"discount_percent": 21,
"rating": 4.4,
"review_count": 249,
"product_url": "https://www.jumia.co.ke/samsung-galaxy-a07-4g-6.7-64gb-4gb-ram-dual-sim-5000mah-black-2yrs-wrty-325675454.html",
"image_url": "https://ke.jumia.is/unsafe/fit-in/520x520/filters:fill(white)/product/45/4576523/1.jpg?6869",
"official_store": "yes",
"scraped_at": "2026-11-10T08:36:42+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-keyword-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。