SHEIN 产品详情提取工具（URL 与 ID 双模式）

定价

SHEIN 产品详情提取工具（URL 与 ID 双模式）

yankun-guo/shein_product_particulars

一款专用于 SHEIN 单个商品详情数据提取的工具，支持产品 URL 和商品 ID 两种输入方式。通过连接远程 Chromium 实例自动绕过 SHEIN 风险验证，加载目标商品页面并解析完整产品属性，返回标准化的结构化数据。适配全球 10 + 区域站点，支持自定义工作流重试次数，适用于商品信息监控、价格跟踪、竞品调研及趋势分析等场景。

免费试用

SHEIN 商品发现

项目概述

本项目支持 3 种 SHEIN 商品发现模式：

shein_product_by-url
shein_product_by-id

Worker 会根据输入模式打开对应的 SHEIN 页面，自动尝试通过 SHEIN 风控验证，解析商品详情，并返回结构化商品数据。

适用场景包括：

按商品 Url发现商品
按商品 ID 发现商品
详情页监控
价格跟踪
竞品调研
趋势与标签分析

执行流程

从输入参数中读取 type 和 value。
根据所选模式组装目标 SHEIN URL。
通过 ChromeWs 连接远程 Chromium 浏览器。
打开 SHEIN 页面，并在需要时自动尝试通过 SHEIN 风控验证。
等待页面真正进入商品详情状态。
解析商品卡片。
输出标准化商品数组。

运行依赖

项目依赖：

playwright
selectolax
httpx
grpcio
protobuf

运行时会读取以下环境变量：

ChromeWs：必填，远程 Chromium 的 CDP WebSocket 地址
PROXY_AUTH：可选，用于拼接 WebSocket 认证信息

参数说明

参数	类型	必填	说明
`type`	string	是	发现模式，可选 `shein_product_by-url`、`shein_product_by-id`。
`value`	string	是	当前模式对应的输入值。可以是详情 URL 或详情 ID。
`flow_retry_num`	integer	否	整个浏览器流程的重试次数，默认 `3`。
`country`	string	否	SHEIN 站点区域。关键词模式和类目 ID 模式会使用该参数，默认 `us`。

支持的国家站点

值	站点
`us`	美国
`uk`	英国
`de`	德国
`fr`	法国
`it`	意大利
`es`	西班牙
`ca`	加拿大
`au`	澳大利亚
`mx`	墨西哥
`jp`	日本

顶层返回字段

字段	类型	说明
`type`	string	当前执行所使用的发现模式。
`url`	string	Worker 实际打开的 SHEIN URL。
`code`	number	`1` 表示成功，`0` 表示失败。
`count`	number	解析出的商品数量。
`products`	array	商品列表。
`error`	string	失败时的错误信息，成功时为空字符串。
`error_code`	string	失败时的错误码，成功时为空字符串。

字段可用性说明

并不是每个商品卡片都会包含全部字段。
price_usd 和 original_price_usd 依赖 SHEIN 是否在卡片属性中提供美元价格。
original_price、discount_percent、rating、reviews_count、sold_count、color_count 在页面未展示时可能为 null。
badges 可能为空数组。

错误码

错误码	说明
`400`	输入参数无效或缺少必填参数。
`500`	内部执行异常。
`BROWSER_CONNECT_FAILED`	连接远程 Chromium 失败。
`PAGE_OPEN_FAILED`	打开 SHEIN 页面失败。
`SHEIN_VERIFY_FAILED`	出现 SHEIN 验证且未能通过。
`PRODUCT_LIST_NOT_FOUND`	页面中未找到商品列表容器。
`PRODUCT_EXTRACT_FAILED`	页面已打开，但商品解析失败。