概览
Olive Young 商品采集:输入商品 ID 或商品详情链接,输出韩国美妆电商 Olive Young Global 的商品记录,包括现价/原价、折扣、品牌、评分、条码、分类路径、成分表、容量、产国、规格参数、图片和 SKU 明细等字段。适合用于 K-Beauty 竞品比价、选品库建设、成分趋势研究和品类铺货分析。
数据说明
- 数据来源是 Olive Young Global 面向公众的商品详情数据,价格为美元(USD),评分是 5 分制。
- 关键词搜索/列表页被站点防护拦截,因此本 App 以商品 ID 为入口;可选开启"关联商品扩展",从你给的商品沿同分类/同品牌发现更多商品。
overview模式只返回主数据(价格、品牌、评分、图片、分类);detail模式在此基础上追加成分表、规格参数、容量和产国。- 同一商品在不同运行中以商品 ID 自动去重;
discovery_depth标记该商品是直接指定(0)还是关联扩展发现(1+)。 - 不覆盖:商品评论正文、问答、登录后专属价、购物车/下单操作、已下架商品的详情。
结果长什么样
每条记录是一个商品。
| 商品ID | 商品名称 | 品牌 | 现价(USD) | 原价(USD) | 折扣率 | 评分 | 容量 | 产国 | 商品链接 |
|---|---|---|---|---|---|---|---|---|---|
| GA230518746 | SKIN1004 Madagascar Centella Hyalu-Cica Water-Fit Sun Serum 50mL*2ea (Twin pack) | SKIN1004 | 30.0 | 30.0 | null | 4.9 | 50ml*2ea | South Korea | https://global.oliveyoung.com/product/detail?prdtNo=GA230518746 |
| GA220615265 | Beauty of Joseon Relief Sun: Rice + Probiotics (SPF50+ PA++++) Double Pack 50mL*2ea | Beauty of Joseon | 23.39 | 30.0 | 22.03 | 4.9 | 50ml*2ea | South Korea | https://global.oliveyoung.com/product/detail?prdtNo=GA220615265 |
此外还包括 GTIN 条码、分类路径、成分表、适用肤质、规格参数、图片链接和 SKU 明细等字段。
应用场景
- 竞品比价:把"现价"、"原价"和"折扣率"按品牌分组,看同一品类(如防晒、精华)的价格带和促销力度,为定价提供参考。
- 成分趋势研究:用"成分表"字段统计某类成分(如烟酰胺、积雪草)在不同品牌/品类中的出现频率和浓度标注。
- 选品库建设:把"商品名称 + 品牌 + GTIN + 图片 + 规格参数"直接导入自己的商品库或 PIM,字段规整可对齐。
- 品类铺货分析:用"分类路径"和"发现层级"看某分类下有哪些品牌和 SKU,找出尚未覆盖的细分市场。
适用边界
仅覆盖 Olive Young Global(global.oliveyoung.com)公开商品详情数据,单次运行最多 200 个商品;不支持关键词搜索列表页(被 WAF 拦截)、评论正文、登录后价格或购物车/下单操作
- 适合用于
- 按商品 ID 批量抓取 K-Beauty 商品的价格、原价、折扣、品牌、评分、成分和规格表,做竞品比价或选品库
- 通过关联商品扩展抓取同分类/同品牌的更多商品,做品类铺货或成分趋势研究
- 不要用于
- 需要按关键词搜索商品列表(本 App 只接受明确的商品 ID 或详情链接)
- 需要抓取商品评论正文、问答或卖家联系方式
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1detail-data 端点返回非 200 或缺少 prdtNo/prdtName 时视为该商品采集失败,跳过并继续其余商品,不用空记录冒充成功
- 2description-info 端点失败时保留 detail-data 字段、specs/ingredients 留空,不视为整体失败
- 3所有商品都采集失败时按整体失败处理并报告原因
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 商品 ID 列表
productIds必填array<string>Olive Young Global 商品 ID(形如 GA230518746),或完整的商品详情链接(https://global.oliveyoung.com/product/detail?prdtNo=...)。可一次填多个,作为采集种子。示例["GA230518746"] - 采集模式
detailMode选填string(enum)overview 只抓商品主数据(价格、品牌、评分、图片、分类);detail 在此基础上追加成分、规格表、容量和产国。可选值overview 快速主数据overviewdetail 详情含成分规格detail默认值detail示例detail - 最多采集商品数
maxProducts选填integer单次运行最多返回的商品条数(含关联商品扩展),全次运行不超过 200 条。范围1–200默认值50示例50 - 关联商品扩展层数
relatedDepth选填integer从种子商品沿同分类/同品牌关联商品向外扩展的层数,0 = 只采集你填的商品 ID;1 = 再抓一层关联商品;最大 3。层数越大采集越多、耗时越长。范围0–3默认值1示例1
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 商品ID
product_idstring商品在 Olive Young Global 的 prdtNo,同一商品在多次运行中保持不变,用作去重键。示例GA230518746 - 商品名称
product_titlestring商品英文名称。示例SKIN1004 Madagascar Centella Hyalu-Cica Water-Fit Sun Serum 50mL*2ea (Twin pack) - 品牌
brandstring商品品牌名。示例SKIN1004 - 品牌ID
brand_idstring品牌在站点的数字编号,用于跨数据源对齐。示例B00568
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"product_id": "GA230518746",
"product_title": "SKIN1004 Madagascar Centella Hyalu-Cica Water-Fit Sun Serum 50mL*2ea (Twin pack)",
"brand": "SKIN1004",
"brand_id": "B00568",
"price_usd": 30,
"original_price_usd": 30,
"discount_rate": 22.03,
"on_promotion": true,
"rating": 4.9,
"gtin": "8809913830122",
"category_path": "OliveYoungGlobal > Suncare > Sunscreen",
"category_id": "1000000028",
"in_stock": true,
"volume": "50ml*2ea",
"country_of_manufacture": "South Korea",
"ingredients": "Water, Dibutyl Adipate, Propanediol, ...",
"ideal_for": "For all skin types",
"specs": "Content volume or weight=50ml*2ea; Ideal for=For all skin types; ...",
"image_urls": "[\"https://cdn-image.oliveyoung.com/prdtImg/1198/2de4e6b6-e128-4589-a082-c4cf676e853c.jpg\"]",
"option_count": 1,
"options": "<options>",
"related_product_ids": "GA220615265;GA241227407",
"discovery_depth": 0,
"source_url": "https://global.oliveyoung.com/product/detail?prdtNo=GA230518746"
}调用方式
本 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=Matrix_He/olive-young-product-scraper",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。