SHEIN Single Product Extractor (URL/ID)

SHEIN Product Discovery

Overview

This project discovers SHEIN products from three different input modes:

• shein_product_by-url
• shein_product_by-id

The worker opens the corresponding SHEIN page, attempts to pass SHEIN risk verification automatically, parses the product grid, and returns a structured product particulars.

Typical use cases:

• Product discovery by products Url page
• Product discovery by products ID
• particulars monitoring
• Price tracking
• Competitor research
• Trend and badge analysis

Workflow

1. Read type and value from the input payload.
2. Build the target SHEIN URL according to the selected mode.
3. Connect to a remote Chromium instance through ChromeWs.
4. Open the SHEIN page and attempt to pass SHEIN verification automatically when required.
5. Wait until the SHEIN product page is actually ready.
6. Parse product cards from the page.
7. Return a normalized product array.

Runtime Requirements

The worker depends on:

• playwright
• selectolax
• httpx
• grpcio
• protobuf

Environment variables used at runtime:

• ChromeWs: required, remote Chromium CDP websocket host
• PROXY_AUTH: optional, authentication prefix added to the websocket URL

Parameters

Supported Countries

Top-Level Response Fields

Notes About Field Availability

• Not every product card exposes every field.
• price_usd and original_price_usd depend on whether SHEIN provides US price attributes for the card.
• original_price, discount_percent, rating, reviews_count, sold_count, and color_count may be null when the card does not show the corresponding element.
• badges may be an empty array.

Error Codes