This skill guides you on how to query and filter Shopee product data across 11 marketplaces, helping cross-border sellers discover trending products and market opportunities on Shopee.
Core Concepts
The YouYing Shopee product selection tool provides structured query capabilities for products across all Shopee sites. Sellers can flexibly combine and filter by multiple dimensions such as keywords, price range, sales, listing time, and store attributes to discover best-selling sources and market opportunities.
Core Data Dimensions：
- Sales Data: sales quantity in the previous 30 days (sold), estimated sales quantity in the previous 30 days (estimateSold), total product sales quantity (historicalSold), sales amount in the previous 30 days (payment)
- Price Data: default price (price), lowest price (minPrice), highest price (maxPrice)
- Store Data: store name, whether it is an official store, Shopee Preferred, local/overseas, cross-border/local
- Product Attributes: rating, number of ratings, number of favorites, number of views, SKU count, listing time, category structure
Data Fields
Product Fields (Output)
| Field | API Name | Description | Example |
|---|---|---|---|
| Product ID | pid | Unique product identifier | 12345678 |
| Product Title | title | Product name | Storage Box Organizer |
| Product Description | description | Detailed product description | ... |
| Product Main Image | imageUrl | Product main image URL | https://... |
| Product Link | productUrl | Shopee product page link | https://... |
| Shopee Product Link | shopeeUrl | Product link under the Shopee domain | https://shopee.sg/... |
| Default Price | price | Product default price (local currency) | 29.90 |
| Lowest Price | minPrice | SKU lowest price | 19.90 |
| Highest Price | maxPrice | SKU highest price | 39.90 |
| Sales Quantity in the Previous 30 Days | sold | Actual sales in the last 30 days | 1500 |
| Estimated Sales in the Previous 30 Days | estimateSold | Estimated sales in the last 30 days | 1200 |
| Total Sales Quantity | historicalSold | Cumulative total product sales | 50000 |
| Sales Amount in the Previous 30 Days | payment | Sales amount in the last 30 days (local currency) | 45000 |
| Product Rating | rating | 0-5 points | 4.8 |
| Number of Ratings | ratings | Total number of ratings received | 320 |
| Number of Favorites | favorite | Number of times favorited | 2800 |
| Number of Views | viewCount | Number of views | 15000 |
| Stock | stock | Current stock quantity | 500 |
| SKU Count | skuNumber | Number of SKU variants | 8 |
| Listing Time | genTime | Date when the product was first listed | 2025-06-01 |
| Category Structure | categoryStructure | Category hierarchy path it belongs to | Home & Living > Storage |
| Store Name | shopName | Name of the store it belongs to | BestHome Official |
| Store Link | shopUrl | Store page link | https://... |
| Whether It Is an Official Store | isOfficialShop | 1=Yes, 0=No | 1 |
| Shopee Preferred | isShopeeVerified | 1=Preferred, 0=Not Preferred | 1 |
| Shipping Type | cbOption | 1=Cross-border, 0=Local | 0 |
| Store location type | shippingIconType | 0=Local, 1=Overseas | 0 |
| Product status | status | 1=Normal, 0=Delisted | 1 |
Supported Marketplaces
| Site | station value | Code |
|---|---|---|
| Malaysia | malaysia | MY |
| Taiwan, China | taiwan_china | Taiwan_CHN |
| Indonesia | indonesia | ID |
| Thailand | thailand | TH |
| Philippines | philippines | PH |
| Singapore | singapore | SG |
| Vietnam | vietnam | VN |
| Brazil | brazil | BR |
| Mexico | mexico | MX |
| Chile | chile | CL |
| Colombia | columbia | CO |
station is arequiredparameter; you can pass the site name (e.g. malaysia) or the code (e.g. MY). When the user has not specified a site, you need toask the userwhich site they want to query.
Invocation method
- API endpoint：
POST /youying/shopee/getProductInfos(for full parameters/responses/error codes, seereferences/api.md） - Python script：
python scripts/youying_shopee_search.py '<JSON 参数>' [--inline] - Cost constraint: This tool consumes compute; by default, the same parameter combination in the same session is called only once, and the script has a 24h local cache. On failure/empty results, you must not automatically try different keywords, paginate, or change the postal code to probe continuously; if you need to continue searching, first explain to the user that additional consumption will be incurred.
Output strategy (script default behavior)：
- Alwayswrite the full response to
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-youying-shopee-get-product-infos-<timestamp>.json（<cwd>is the working directory when the script is executed, which in Claude Code is the current project directory;<session>is taken from the environment variableSESSION_ID, automatically aggregated according to the user's task;writing to /tmp is prohibited, and if the current directory is not writable, report an error) - Response body ≤ 8 KB: after writing to disk, print the full JSON to stdout
- Response body > 8 KB: after writing to disk, stdout outputs only a summary (top-level fields, common counts such as
total/costToken, length of the largest list field + first 3 samples) - Add
--inlineto force full printing to stdout (also written to disk)
Data reading suggestion: First look at the summary to determine whether it is sufficient; when specific fields are needed, prefer using jqorConvertFrom-Json to extract on demand from the saved json file, avoiding putting the entire JSON into the context.
Resolve authentication and compute issues
When the following abnormal situations occur, use references/onboarding.md to guide resolution:
Abnormal situation
- API Key not configured: The environment variable is not configured with
LINKFOX_AGENT_API_KEY, andLINKFOXAGENT_API_KEY。 - Response 401 or 402 status code
- Response indicates insufficient compute or balance: The message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with a similar meaning.
How to Build Queries
According to user needs, convert natural language into API parameter combinations. The core principle is toaccurately map the user's filter conditions to the corresponding parameters。
Principles for Building API Calls
- Required site: Each call must specify
station. If the user says "Malay" or "Malaysia" →malaysia; "Taiwan, China" →taiwan_china; "Indonesia" →indonesia, etc. - Keyword search：
keywordis the title keyword, paired withkeywordTypeto control the matching mode (1=exact phrase match, 2=multi-word AND, 3=multi-word OR) - Numeric range: Most filters use Start/End or Min/Max paired parameters; set one side or both as needed
- Sorting：
orderBySpecify the sort field,orderByTypespecify ascending/descending order (default DESC descending) - Pagination：
pagestarts from 1,pageSizerange 1-1000, default 1000 - Exclusion logic：
notExistKeywordcan exclude products containing specific words,notExistShopIdListcan exclude specific stores
Common Query Scenarios
1. Keyword product selection — filter hot-selling products by sales
station: malaysia
keyword: Storage Box
keywordType: 2
soldMin: 100
orderBy: sold
orderByType: DESC
pageSize: 100
2. New product discovery — products recently listed with a certain amount of sales
station: thailand
keyword: Phone Case
listingDateFrom: 2025-06-01
soldMin: 50
orderBy: gen_time
orderByType: DESC
3. High-potential products — low price, high sales
station: indonesia
keyword: LED Light
priceMax: 50000
soldMin: 500
orderBy: payment
orderByType: DESC
4. Cross-border seller product filtering
station: malaysia
keyword: Wireless Earbuds
cbOption: 1
soldMin: 200
orderBy: sold
orderByType: DESC
5. Category product selection — filter by category + sales revenue
station: vietnam
pL1Id: 11036379
paymentStart: 10000000
orderBy: payment
orderByType: DESC
pageSize: 200
6. Competitor store analysis — view products of a specific store
station: malaysia
shopIdList: 123456789
orderBy: sold
orderByType: DESC
7. Preferred product filtering — Shopee Preferred + high rating
station: philippines
keyword: Beauty
isShopeeVerified: 1
ratingMin: 4.5
soldMin: 100
orderBy: rating
orderByType: DESC
8. Big seller exclusion — discover opportunities among small and medium sellers
station: taiwan_china
keyword: 收纳盒
notExistShopIdList: 111111,222222,333333
soldMin: 50
soldMax: 500
orderBy: sold
orderByType: DESC
Display Rules
- Present data only: Show query results in clear tables without subjective business advice
- Currency notice: Different marketplaces use different currencies (MYR, TWD, IDR, THB, PHP, SGD, VND, BRL, MXN, CLP, COP). Always remind users of the currency context when showing price/payment data
- Volume notice: When results are large, show core data (title, price, sold, payment, rating) and remind users they can view more via pagination
- Key metrics highlight: Prioritize showing
sold(sales in the past 30 days),payment(sales revenue in the past 30 days),price,ratingas these are the most decision-relevant metrics - Error handling: When a query fails, explain the reason based on the error response and suggest adjusting query criteria
- Image display: When
imageUrlis available, include product images to help users make visual assessments
Important Limitations
- Result cap:
pageSizemaximum is 1000 records per request - Required field:
stationis always required — if missing, ask the user which marketplace to query - Price currency: Prices are in local currency of the selected marketplace, not USD
- Data freshness: Data depends on 友鹰's crawling schedule, see
lastModiTimefor last update time
User Expression & Scenario Quick Reference
Applicable - Shopee product search and filtering:
| User Says | Scenario |
|---|---|
| "What sells well on Shopee" "Shopee hot-selling products" | Hot-selling product discovery |
| "Help me search for xx products on Shopee" | Keyword product search |
| "Recently listed new products on the Malaysia site" | New product discovery by listing date |
| "What products have sales over a thousand" | Volume-based product filtering |
| "Which categories in Southeast Asia have opportunities" | Category-level opportunity scan |
| "Help me look at this store's products" | Competitor shop analysis |
| "Comparison of cross-border products and local products" | Cross-border vs local comparison |
| "Shopee Preferred product filtering" | Shopee Verified product filtering |
| "Low-price, high-sales products" | Price-volume opportunity mining |
Not applicable - Needs beyond Shopee product search:
- Product search on Amazon, TikTok, eBay, 1688 and other platforms
- Shopee advertising strategy
- Shopee store operation suggestions
- Shopee logistics/warehousing solutions
- Processing of existing local Shopee data files
Boundary judgment: When users say "Southeast Asia product selection", "Shopee market analysis", or "cross-border e-commerce product selection", if it boils down to searching and filtering products on Shopee by various criteria, this skill applies. If they're asking about logistics planning, advertising strategy, or store operations, it does not apply.
Compute power consumption rules
Consumes 4 compute power.
Users pay for compute power consumption. Please evaluate carefully: when this skill needs to be called frequently, or the user's expectation of compute power consumption is insufficient, be sure to remind the user and let the user decide whether to continue.
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
- The functionality or purpose described in this skill does not match actual behavior
- The skill's results do not match the user's intent
- The user expresses dissatisfaction or praise about this skill
- Anything you believe could be improved
Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.