logo

Olive Young 商品采集

按商品 ID 采集韩国美妆电商 Olive Young Global 的商品价格、品牌、评分、成分、规格等字段

发布者
价格
¥0.004 / 条
近 30 天成功率
—
最近更新
2026-11-20

概览

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)折扣率评分容量产国商品链接
GA230518746SKIN1004 Madagascar Centella Hyalu-Cica Water-Fit Sun Serum 50mL*2ea (Twin pack)SKIN100430.030.0null4.950ml*2eaSouth Koreahttps://global.oliveyoung.com/product/detail?prdtNo=GA230518746
GA220615265Beauty of Joseon Relief Sun: Rice + Probiotics (SPF50+ PA++++) Double Pack 50mL*2eaBeauty of Joseon23.3930.022.034.950ml*2eaSouth Koreahttps://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 或详情链接)
  • 需要抓取商品评论正文、问答或卖家联系方式

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1detail-data 端点返回非 200 或缺少 prdtNo/prdtName 时视为该商品采集失败,跳过并继续其余商品,不用空记录冒充成功
  2. 2description-info 端点失败时保留 detail-data 字段、specs/ingredients 留空,不视为整体失败
  3. 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 同源。

  • 商品IDproduct_idstring
    商品在 Olive Young Global 的 prdtNo,同一商品在多次运行中保持不变,用作去重键。
    示例GA230518746
  • 商品名称product_titlestring
    商品英文名称。
    示例SKIN1004 Madagascar Centella Hyalu-Cica Water-Fit Sun Serum 50mL*2ea (Twin pack)
  • 品牌brandstring
    商品品牌名。
    示例SKIN1004
  • 品牌IDbrand_idstring
    品牌在站点的数字编号,用于跨数据源对齐。
    示例B00568

示例数据

以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。

output.example
{
  "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 配置
{
  "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)。

价格

每条商品记录

按实际成功返回的数据条数计费,任务失败不计费。

¥0.004/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.004 / 条