Ecommerce Shopee Product Search Skill for Claude

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

The YouYing Shopee Product Selection tool provides structured query capabilities for products across all Shopee marketplaces. Sellers can flexibly combine multi-dimensional filtering criteria such as keywords, price ranges, sales volume, listing date, and store attributes to discover trending products and market opportunities.

Core Data Dimensions:

• Sales Data: Sold units in the last 30 days (sold), estimated sold units in the last 30 days (estimateSold), total historical sold units (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, local/overseas, cross-border/local
• Product Attributes: Rating, rating count, favorites, views, SKU count, listing date, 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 | Main product image URL | https://... |

| Product Link | productUrl | Shopee product page link | https://... |

| Default Price | price | Default product price (local currency) | 29.90 |

| Minimum Price | minPrice | Lowest SKU price | 19.90 |

| Maximum Price | maxPrice | Highest SKU price | 39.90 |

| Sold (30 days) | sold | Actual sales in last 30 days | 1500 |

| Estimated Sold (30 days) | estimateSold | Estimated sales in last 30 days | 1200 |

| Total Sold | historicalSold | Cumulative total sales | 50000 |

| Revenue (30 days) | payment | Sales revenue in last 30 days (local currency) | 45000 |

| Rating | rating | 0-5 rating | 4.8 |

| Rating Count | ratings | Total number of ratings received | 320 |

| Favorites | favorite | Number of times favorited | 2800 |

| Views | viewCount | Number of views | 15000 |

| Stock | stock | Current inventory quantity | 500 |

| SKU Count | skuNumber | Number of SKU variants | 8 |

| Listing Date | genTime | Date first listed | 2025-06-01 |

| Category Structure | categoryStructure | Category path hierarchy | Home & Living > Storage |

| Store Name | shopName | Store name | 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 |

| Fulfillment Type | cbOption | 1=Cross-border, 0=Local | 0 |

| Store Location Type | shippingIconType | 0=Local, 1=Overseas | 0 |

| Product Status | status | 1=Active, 0=Delisted | 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. Pass the marketplace name (e.g., malaysia) or code (e.g., MY). When the user does not specify a marketplace, ask the user which marketplace they want to query.

Invocation

• API Endpoint: POST /youying/shopee/getProductInfos (full parameters/response/error codes in references/api.md)
• Python Script: python scripts/shopee_product_search.py '<JSON params>' [--inline]
• Cost Constraints: This tool consumes credits. The same parameter combination defaults to a single call per session. The script includes a 24-hour local cache. Do not automatically retry with different keywords, pagination, or modified parameters on failure or empty results; inform the user that additional costs will be incurred before continuing to search.

Output Strategy (default script behavior):

• Always write the full response to <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-youying-shopee-get-product-infos-<timestamp>.json (<cwd> is the working directory at script execution time, which in Claude Code is the current project directory; <session> is taken from the SESSION_ID environment variable, auto-grouped by user task; writing to /tmp is forbidden -- error if the current directory is not writable)
• Response body <= 8 KB: print the full JSON to stdout after writing to disk
• Response body > 8 KB: print only a summary to stdout after writing to disk (top-level fields, common counts like total/costToken, length of the largest list field + first 3 samples)
• Add --inline to force full output to stdout (still writes to disk)

Data Reading Tip: Check the summary first to determine if it is sufficient; when specific fields are needed, prefer using jq or ConvertFrom-Json to extract from the saved JSON file on demand to avoid loading the entire JSON into context.

Authentication

Set NEXSCOPE_API_KEY. Visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to manage credits.

How to Build Queries

Convert natural language requirements into API parameter combinations. The core principle is precisely mapping user filtering criteria to the corresponding parameters.

Principles for Building API Calls

• Required marketplace: Every call must specify station. User says "Malaysia" -> malaysia; "Taiwan" -> taiwan_china; "Indonesia" -> indonesia, etc.
• Keyword search: keyword for title keywords, paired with keywordType to control matching mode (1=exact phrase match, 2=multi-word AND, 3=multi-word OR)
• Numeric ranges: Most filtering criteria use Start/End or Min/Max paired parameters, set one or both sides as needed
• Sorting: orderBy specifies the sort field, orderByType specifies ascending/descending (default DESC)
• Pagination: page starts from 1, pageSize range 1-1000, default 1000
• Exclusion logic: notExistKeyword excludes products containing specific words, notExistShopIdList excludes specific stores

Common Query Scenarios

1. Keyword product 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 some 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 selection -- filter by category + revenue

station: vietnam
pL1Id: 11036379
paymentStart: 10000000
orderBy: payment
orderByType: DESC
pageSize: 200

6. Competitor store analysis -- view products from a specific store

station: malaysia
shopIdList: 123456789
orderBy: sold
orderByType: DESC

7. Verified product filtering -- Shopee Verified + high rating

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

8. Top-seller exclusion -- discover small/medium seller opportunities

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, payment, rating) and remind users they can view more via pagination
• Key metrics highlight: Prioritize showing sold (30-day sales), payment (30-day revenue), 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:

| User Says | Scenario |

|-----------|----------|

| "What sells well on Shopee" / "Shopee bestsellers" | Hot-selling product discovery |

| "Search for XX product on Shopee" | Keyword product search |

| "Newly listed products on Malaysia site" | New product discovery by listing date |

| "Products with over 1000 sales" | Volume-based product filtering |

| "Which categories have opportunities in SE Asia" | Category-level opportunity scan |

| "Show me products from this store" | Competitor shop analysis |

| "Compare cross-border vs local products" | Cross-border vs local comparison |

| "Shopee Verified 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 other platforms such as Amazon, TikTok, eBay, 1688
• Shopee advertising strategy
• Shopee store operations advice
• Shopee logistics/warehousing solutions
• Processing of local Shopee data files that already exist

Boundary judgment: When users say "SE 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.