Shopee Product Research

Shopee Product Search MCP

Search and filter products across supported Shopee markets in Asia and Latin America for product selection and marketplace. Available via REST API or MCP.

CostRecent 10 credits / callOnline Test

Shopee Product Search AI Prompts & Use Cases

After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.

New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.

1. Find Shopee Products Matching My Selection Criteria

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Show the available results and clearly identify missing information.

2. Continue The Results Within A Page Limit

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Start at [my selected page] and return [my requested page size] within the documented limits. Ask before requesting another page and do not describe one page as the complete dataset.

3. Prioritize The Results For Review

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period. For this selection, choose rating, price, total sales, 30-day sales, 30-day revenue, favorites, rating count, listing time or estimated sales.

4. Find Matches By Total Product Price

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen total product price range]. Keep the lower and upper bounds consistent and show only the matching records.

5. Find Matches By Units Sold

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen units sold range]. Keep the lower and upper bounds consistent and show only the matching records.

6. Find Matches By Estimated Units Sold In Last 30 Days

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen estimated units sold in last 30 days range]. Keep the lower and upper bounds consistent and show only the matching records.

7. Find Matches By Total Historical Units Sold

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen total historical units sold range]. Keep the lower and upper bounds consistent and show only the matching records.

8. Find Matches By Sales Revenue In Last 30 Days

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen sales revenue in last 30 days range]. Keep the lower and upper bounds consistent and show only the matching records.

9. Find Matches By Product Rating

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen product rating range]. Keep the lower and upper bounds consistent and show only the matching records.

10. Find Matches By Number Of Ratings

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen number of ratings range]. Keep the lower and upper bounds consistent and show only the matching records.

11. Find Matches By Number Of Favorites

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen number of favorites range]. Keep the lower and upper bounds consistent and show only the matching records.

12. Find Matches By Total Sku Count

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen total sku count range]. Keep the lower and upper bounds consistent and show only the matching records.

13. Find Matches By Product Listing Date

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen product listing date range]. Keep the lower and upper bounds consistent and show only the matching records.

14. Find Matches By Reporting Date

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen reporting date range]. Keep the lower and upper bounds consistent and show only the matching records.

15. Find Matches By Observation Date

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen observation date range]. Keep the lower and upper bounds consistent and show only the matching records.

16. Find Matches By Store Opening Date

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen store opening date range]. Keep the lower and upper bounds consistent and show only the matching records.

17. Choose How Search Words Match

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Match [my search words] as [an exact phrase, all words or any word], according to my preference. Summarize only the returned records.

18. Narrow Results By Excluded Words

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected excluded words] to narrow the results. Report only what the selected records support.

19. Choose How Excluded Words Match

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Exclude results matching [my unwanted words] as [an exact phrase, all words or any word]. Summarize only the returned records.

20. Narrow Results By Level 1 Category ID

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected level 1 category id] to narrow the results. Report only what the selected records support.

21. Narrow Results By Level 2 Category ID

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected level 2 category id] to narrow the results. Report only what the selected records support.

22. Narrow Results By Level 3 Category ID

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected level 3 category id] to narrow the results. Report only what the selected records support.

23. Find Products In Selected Categories

Prompt: Find Shopee products matching [search phrase] in [target marketplace] within [selected category paths]. Keep the full category hierarchy for each selected category and summarize the matching products.

24. Narrow Results By Specific Store ID List, Comma-Separated

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected specific store id list, comma-separated] to narrow the results. Report only what the selected records support.

25. Narrow Results By Excluded Store ID List, Comma-Separated

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected excluded store id list, comma-separated] to narrow the results. Report only what the selected records support.

26. Narrow Results By Store Name Or Username

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected store name or username] to narrow the results. Report only what the selected records support.

27. Choose Local Or Overseas Shops

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Focus on [local or overseas] shops, according to my preference. Summarize only the returned records.

28. Narrow Results By Store Location Type

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected store location type] to narrow the results. Report only what the selected records support.

29. Choose Local Or Cross-Border Shipping

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Focus on products shipping [locally or across borders], according to my preference. Summarize only the returned records.

30. Choose Shopee Preferred Shops

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my preference for Shopee Preferred shops] to narrow the results. Summarize only the returned records.

31. Find Official Shops

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my preference for official shops] to narrow the results. Summarize only the returned records.

32. Find Hot-Selling Products

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my preference for hot-selling products] to narrow the results. Summarize only the returned records.

33. Narrow Results By Product ID List , Comma-Separated

Prompt: Find Shopee products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected product id list , comma-separated] to narrow the results. Report only what the selected records support.

What You Need to Provide

Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.

Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.

Step 1 · Connect

Connect Your AI Assistant

Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Using an API key? Get your key from API Access and include it in the Authorization header shown above.

Call this MCP tool

MCP tool name

nexscope_shopee_product_search

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "shopee-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_shopee_product_search",
    "arguments": {
      "keyword": "phone case",
      "keywordType": 1,
      "page": 1,
      "pageSize": 1000,
      "station": "SG"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`station`	`string`	required	Required. Shopee site, accepts name or code. See site mapping table below Example: SG
`keyword`	`string`	optional	Product title keyword Example: phone case
`keywordType`	`integer`	optional	Match mode: 1=Exact phrase (default), 2=Multi-word AND, 3=Multi-word OR Example: 1
`notExistKeyword`	`string`	optional	Exclude products containing this keyword Example: phone case
`notExistKeywordType`	`integer`	optional	Exclusion match mode: 1=Exact phrase (default), 2=Multi-word AND, 3=Multi-word OR Example: 1
`priceMin`	`number`	optional	Minimum total product price (local currency) Example: 1
`priceMax`	`number`	optional	Maximum total product price Example: 1
`soldMin`	`integer`	optional	Minimum units sold in last 30 days Example: 1
`soldMax`	`integer`	optional	Maximum units sold in last 30 days Example: 1
`estimateSoldStart`	`integer`	optional	Minimum estimated units sold in last 30 days Example: 1
`estimateSoldEnd`	`integer`	optional	Maximum estimated units sold in last 30 days Example: 1
`historicalSoldStart`	`integer`	optional	Minimum total historical units sold Example: 1
`historicalSoldEnd`	`integer`	optional	Maximum total historical units sold Example: 1
`paymentStart`	`number`	optional	Minimum sales revenue in last 30 days Example: 1
`paymentEnd`	`number`	optional	Maximum sales revenue in last 30 days Example: 1
`ratingMin`	`number`	optional	Minimum product rating (0-5) Example: 1
`ratingMax`	`number`	optional	Maximum product rating Example: 1
`ratingsMin`	`integer`	optional	Minimum number of ratings Example: 1
`ratingsMax`	`integer`	optional	Maximum number of ratings Example: 1
`favoriteMin`	`integer`	optional	Minimum number of favorites Example: 1
`favoriteMax`	`integer`	optional	Maximum number of favorites Example: 1
`skuNumberStart`	`integer`	optional	Minimum total SKU count Example: 1
`skuNumberEnd`	`integer`	optional	Maximum total SKU count Example: 1
`listingDateFrom`	`string`	optional	Product listing date range start (format: yyyy-MM-dd) Example: 2026-01-01
`listingDateTo`	`string`	optional	Product listing date range end (format: yyyy-MM-dd) Example: 2026-01-01
`statTimeStart`	`string`	optional	Statistics time range start (format: yyyy-MM-dd HH:mm:ss)
`statTimeEnd`	`string`	optional	Statistics time range end (format: yyyy-MM-dd HH:mm:ss)
`lastModiTimeStart`	`string`	optional	Latest crawl time range start (format: yyyy-MM-dd)
`lastModiTimeEnd`	`string`	optional	Latest crawl time range end (format: yyyy-MM-dd)
`approvedDateStart`	`string`	optional	Store opening time range start (format: yyyy-MM-dd) Example: 2026-01-01
`approvedDateEnd`	`string`	optional	Store opening time range end (format: yyyy-MM-dd) Example: 2026-01-01
`pL1Id`	`string`	optional	Level 1 category ID Example: example-id
`pL2Id`	`string`	optional	Level 2 category ID Example: example-id
`pL3Id`	`string`	optional	Level 3 category ID Example: example-id
`cidList`	`string`	optional	Category ID list, full path, multiple groups separated by
`shopIdList`	`string`	optional	Specific store ID list, comma-separated
`notExistShopIdList`	`string`	optional	Excluded store ID list, comma-separated
`merchant`	`string`	optional	Store name or username
`shopLocation`	`string`	optional	Store location
`shippingIconType`	`integer`	optional	Store location type: 0=Local, 1=Overseas Example: 1
`cbOption`	`integer`	optional	Shipping origin: 0=Local, 1=Cross-border Example: 1
`isShopeeVerified`	`integer`	optional	Shopee Preferred: 0=Not preferred, 1=Preferred Example: 1
`isOfficialShop`	`integer`	optional	Official store: 0=No, 1=Yes Example: 1
`isHotSales`	`integer`	optional	Hot selling: 0=Not hot, 1=Hot Example: 1
`pids`	`string`	optional	Product ID list (max 500), comma-separated
`orderBy`	`string`	optional	Sort field: rating, price, historical_sold (total sales), sold (30-day sales), payment (30-day revenue), favorite, ratings, gen_time (listing time), estimate_sold (estimated sales)
`orderByType`	`string`	optional	Sort direction: ASC (ascending), DESC (descending) Example: DESC
`page`	`integer`	optional	Page number (starting from 1) Example: 1
`pageSize`	`integer`	optional	Products per page (range 1-1000) Example: 1000

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	The current number of records returned.
`totalSize`	`integer`	optional	Total number of results.
`sourceType`	`string`	optional	Source type: `shopee`.
`columns`	`array`	optional	Render column definitions.
`costToken`	`integer`	optional	Consume token.
`type`	`string`	optional	Rendering style.
`products`	`array`	optional	List of products (see fields below).
`pid`	`string`	optional	Product unique ID.
`title`	`string`	optional	Product title.
`description`	`string`	optional	Product description.
`imageUrl`	`string`	optional	Product main image URL.
`productUrl`	`string`	optional	Shopee product link.
`shopeeUrl`	`string`	optional	Product links under the Shopee domain name.
`price`	`number`	optional	Product default price (local currency).
`minPrice`	`number`	optional	SKU lowest price.
`maxPrice`	`number`	optional	The highest price of the SKU.
`sold`	`integer`	optional	Number of units sold in the previous 30 days.
`estimateSold`	`integer`	optional	Estimate the number of units sold in the previous 30 days.
`historicalSold`	`integer`	optional	The total number of items sold.
`payment`	`number`	optional	Sales in the previous 30 days (local currency).
`rating`	`number`	optional	Product rating (0-5).
`ratings`	`integer`	optional	Rating number.
`favorite`	`integer`	optional	Number of collections.
`viewCount`	`integer`	optional	Number of views.
`stock`	`integer`	optional	Stock count.
`skuNumber`	`integer`	optional	SKU quantity.
`genTime`	`string`	optional	Shelf time.
`statTime`	`string`	optional	Statistics time.
`lastModiTime`	`string`	optional	Latest crawl time.
`categoryStructure`	`string`	optional	Category structure path.
`cid`	`string`	optional	Category IDs (comma separated).
`shopId`	`string`	optional	Store ID.
`shopName`	`string`	optional	Store name.
`shopUrl`	`string`	optional	Store link.
`userName`	`string`	optional	Store owner name.
`shopLocation`	`string`	optional	Store location.
`shopProductsCount`	`integer`	optional	The total number of items in the store.
`approvedDate`	`string`	optional	Store opening hours.
`isOfficialShop`	`integer`	optional	Is it an official store (1=yes, 0=no).
`isShopeeVerified`	`integer`	optional	Shopee is preferred (1=yes, 0=no).
`isHotSales`	`integer`	optional	Is it a hot seller (1=yes, 0=no).
`shippingIconType`	`integer`	optional	Store location type (0=local, 1=overseas, 3 or null=unknown).
`cbOption`	`integer`	optional	Shipping location (0=domestic, 1=cross-border).
`estimatedDays`	`integer`	optional	Estimated days of arrival.
`status`	`integer`	optional	Product status (1=normal, 0=removed, 8=excluded from list).
`notExist`	`integer`	optional	Whether it exists (0=exists, 1=does not exist).

Format Illustration

Illustrative example with fictional data, not a live tool call.

Illustrative Question

Find Shopee products matching my selection criteria. Use “phone case”. Focus on Singapore.

Illustrative Response Explanation

The illustrative result shows title: Example product; price: 19.99; rating: 4.5. These figures describe only the shown record. Missing measures cannot be calculated from this example.

About this sample: Illustrative example with fictional records, not a live tool call. Identifiers, prices and counts are demonstration values.

Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.

View the MCP Request & Response Format

Examples