YouYing - Shopee Product Selection

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

YouYing Shopee Product Selection Tool provides structured query capabilities for products across all Shopee sites. Sellers can flexibly combine multi-dimensional filters such as keywords, price ranges, sales volume, listing time, and store attributes to discover best-selling product sources and market opportunities.

Core Data Dimensions:

Sales Volume Data: Sales in the last 30 days (sold), estimated sales in the last 30 days (estimateSold), total historical sales (historicalSold), sales revenue in the last 30 days (payment)
Price Data: Default price (price), minimum price (minPrice), maximum price (maxPrice)
Store Data: Store name, official store status, Shopee Verified status, local/overseas, cross-border/local
Product Attributes: Rating, number of ratings, number of favorites, number of views, number of SKUs, 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	URL of product main image	https://...
Product Link	productUrl	Shopee product page link	https://...
Default Price	price	Default product price (local currency)	29.90
Minimum Price	minPrice	Minimum SKU price	19.90
Maximum Price	maxPrice	Maximum SKU price	39.90
Sales in Last 30 Days	sold	Actual sales in the last 30 days	1500
Estimated Sales in Last 30 Days	estimateSold	Estimated sales in the last 30 days	1200
Total Historical Sales	historicalSold	Cumulative total sales of the product	50000
Sales Revenue in Last 30 Days	payment	Sales revenue in the last 30 days (local currency)	45000
Product Rating	rating	0-5 scale	4.8
Number of Ratings	ratings	Total number of ratings received	320
Number of Favorites	favorite	Number of times the product was favorited	2800
Number of Views	viewCount	Number of views	15000
Stock	stock	Current stock quantity	500
Number of SKUs	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	Home & Living > Storage
Store Name	shopName	Name of the affiliated store	BestHome Official
Store Link	shopUrl	Store page link	https://...
Official Store	isOfficialShop	1=Yes, 0=No	1
Shopee Verified	isShopeeVerified	1=Verified, 0=Not Verified	1
Shipping Type	cbOption	1=Cross-border, 0=Local	0
Store Location Type	shippingIconType	0=Local, 1=Overseas	0
Product Status	status	1=Active, 0=Offline	1

Supported Marketplaces

Marketplace	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 a required parameter, which can be passed as the marketplace name (e.g.,

malaysia

) or code (e.g.,

MY

). When the user does not specify a marketplace, you must ask the user which marketplace they want to query.

Calling Methods

API Endpoint:
```
POST /youying/shopee/getProductInfos
```
(complete parameters/responses/error codes can be found in
```
references/api.md
```
)

Python Script:

python scripts/youying_shopee_search.py '<JSON parameters>' [--inline]

Cost Constraints: This tool consumes points; by default, the same parameter combination in the same session is only called once, and the script has a 24-hour local cache. Do not automatically try different keywords, pagination, or zip codes continuously for failed/empty results; explain to the user that additional consumption will occur before continuing the search.

Output Strategy (Default Script Behavior):

Always write the complete response to
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-youying-shopee-get-product-infos-<timestamp>.json
```
(
```
<cwd>
```
is the working directory where the script is executed, which is the current project directory in Claude Code;
```
<session>
```
is obtained from the environment variable
```
SESSION_ID
```
and is automatically aggregated by user tasks; prohibited from writing to /tmp, report an error if the current directory is not writable)
Response body ≤ 8 KB: After saving to disk, print the complete JSON to stdout
Response body > 8 KB: After saving to disk, only output a summary to stdout (top-level fields, common counts such as
```
total
```
/
```
costToken
```
, length of the largest list field + first 3 samples)
Add
```
--inline
```
to force full printing to stdout (also saves to disk)

Data Reading Recommendations: First check the summary to see if it is sufficient; when specific fields are needed, use

jq

ConvertFrom-Json

to extract from the saved JSON file on demand to avoid loading the entire JSON into the context.

Resolving Authentication and Point Issues

When the following exceptions occur, guide users to resolve them using references/onboarding.md:

Exception Scenarios

API Key Not Configured: The environment variable
```
LINKFOX_AGENT_API_KEY
```
is not configured, nor is
```
LINKFOXAGENT_API_KEY
```
.
Response with 401 or 402 Status Code
Insufficient Points or Balance: The message contains content such as "insufficient point balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/need to recharge/please recharge" or similar meanings.

How to Build Queries

Convert natural language user requirements into API parameter combinations. The core principle is to accurately map user filtering conditions to corresponding parameters.

Principles for Building API Calls

Required Marketplace: The
```
station
```
parameter must be specified for each call. If the user says "Malaysia" →
```
malaysia
```
; "Taiwan (China)" →
```
taiwan_china
```
; "Indonesia" →
```
indonesia
```
, etc.
Keyword Search:
```
keyword
```
is the title keyword, paired with
```
keywordType
```
to control the matching mode (1=Exact phrase match, 2=Multi-word AND, 3=Multi-word OR)
Numeric Ranges: Most filtering conditions use Start/End or Min/Max paired parameters; set one-sided or two-sided as needed
Sorting:
```
orderBy
```
specifies the sorting field,
```
orderByType
```
specifies ascending/descending order (default DESC descending order)
Pagination:
```
page
```
starts from 1,
```
pageSize
```
ranges from 1-1000, default is 1000
Exclusion Logic:
```
notExistKeyword
```
can exclude products containing specific words,
```
notExistShopIdList
```
can exclude specific stores

Common Query Scenarios

1. Keyword-based Selection — Filter Hot-selling Products by Sales Volume

station: malaysia
keyword: Storage Box
keywordType: 2
soldMin: 100
orderBy: sold
orderByType: DESC
pageSize: 100

2. New Product Discovery — Recently Listed Products with Certain Sales Volume

station: thailand
keyword: Phone Case
listingDateFrom: 2025-06-01
soldMin: 50
orderBy: gen_time
orderByType: DESC

3. High-potential Products — Low Price with High Sales Volume

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-based 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. Shopee Verified Product Filtering — Shopee Verified + High Rating

station: philippines
keyword: Beauty
isShopeeVerified: 1
ratingMin: 4.5
soldMin: 100
orderBy: rating
orderByType: DESC

8. Exclude Top Sellers — Discover Opportunities for Small and Medium Sellers

station: taiwan_china
keyword: Storage Box
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 (sales volume in last 30 days), payment (sales revenue in last 30 days), rating) and remind users they can view more via pagination
Key metrics highlight: Prioritize showing
```
sold
```
(sales volume in last 30 days),
```
payment
```
(sales revenue in last 30 days),
```
price
```
,
```
rating
```
as 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
```
imageUrl
```
is available, include product images to help users make visual assessments

Important Limitations

Result cap:
```
pageSize
```
maximum is 1000 records per request
Required field:
```
station
```
is 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 YouYing's crawling schedule, see
```
lastModiTime
```
for last update time

User Expression & Scenario Quick Reference

Applicable - Shopee product search and filtering:

What User Says	Scenario
"What sells well on Shopee?" "Shopee bestsellers"	Hot-selling product discovery
"Help me search for xx products on Shopee"	Keyword product search
"New products recently listed on Malaysia site"	New product discovery by listing date
"Which products have sales over 1000?"	Volume-based product filtering
"Which categories have opportunities in Southeast Asia?"	Category-level opportunity scan
"Help me check the products of this store"	Competitor shop analysis
"Comparison between cross-border and local products"	Cross-border vs local comparison
"Filter Shopee Verified products"	Shopee Verified product filtering
"Low-price products with high sales volume"	Price-volume opportunity mining

Not applicable - Needs beyond Shopee product search:

Product search on other platforms such as Amazon, TikTok, eBay, 1688, etc.
Shopee advertising strategy
Shopee store operation suggestions
Shopee logistics/warehousing solutions
Processing of existing local Shopee data files

Boundary judgment: When users say "Southeast Asian product selection", "Shopee market analysis", or "cross-border e-commerce product selection", this skill applies if it boils down to searching and filtering products on Shopee by various criteria. If they're asking about logistics planning, advertising strategy, or store operations, it does not apply.

Point Consumption Rules

Costs 4 points.

Users will pay fees based on point consumption. Please fully evaluate: when this skill needs to be called frequently, or when users have insufficient expectations about point consumption, be sure to remind users and let them 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.

linkfox-youying-shopee-get-product-infos

NPX Install

Tags

SKILL.md Content (Chinese)