TikTok / Social Commerce

TikTok Product Discovery MCP Tool

Search and filter TikTok global e-commerce products based on FastMoss data, supporting keyword search, multi-dimensional filtering (category, shop type, commission rate, sales, creator count, etc.) and sorting.

MCP tool name
nexscope_tiktok_product_discovery
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-product-discovery/run
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "tiktok-product-discovery-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_product_discovery",
    "arguments": {
      "region": "US",
      "pageSize": 10,
      "keyword": "phone case",
      "pageNumber": 1
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-product-discovery/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/tiktok-product-discovery

Arguments

NameTypeRequiredMeaning
keywordstringoptional
Search keyword (fuzzy match on product title)
Example: phone case
regionstringoptional
Market region code. Options: US (United States), GB (United Kingdom), MX (Mexico), ES (Spain), DE (Germany), IT (Italy), FR (France), ID (Indonesia), VN (Vietnam), MY (Malaysia), TH (Thailand), PH (Philippines), BR (Brazil), JP (Japan), SG (Singapore)
Example: US
categorystringoptional
English category name, automatically matched to TikTok category ID. Non-English input must be translated to English first
Example: {}
shopTypeintegeroptional
Store type: 1=local store, 2=cross-border store
Example: 1
isTopSellingbooleanoptional
Filter hot-selling products only
Example: false
isNewListedbooleanoptional
Filter newly listed products only
Example: false
isSshopbooleanoptional
Filter TikTok fully managed (S-shop) products only
Example: false
isFreeShippingbooleanoptional
Filter free shipping products only
Example: false
isLocalWarehousebooleanoptional
Filter local warehouse shipping products only
Example: false
unitsSoldRangeobjectoptional
Sales volume range filter, format: {"min": 100, "max": 5000}
Example: {}
commissionRateRangeobjectoptional
Commission rate range filter, format: {"min": 0.05, "max": 0.20} (decimal, 0.10=10%)
Example: {}
creatorCountRangeobjectoptional
Creator count range filter, format: {"min": 10, "max": 500}
Example: {}
orderFieldstringoptional
Sort field: day7_units_sold (7-day sales), day7_gmv (7-day GMV), commission_rate (commission rate), total_units_sold (total sales), total_gmv (total GMV), creator_count (creator count). Default descending order
Example: {}
pageintegeroptional
Page number, default 1
Example: 1
pageSizeintegeroptional
Items per page, max 10, default 10
Example: 10

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
totalintegeroptional
Total number of matching records
Example: 1
productsarrayoptional
Product information list (see below)
Example: []
columnsarrayoptional
Render column definitions
Example: []
typestringoptional
Render style type
Example: {}
costTokenintegeroptional
Token cost
Example: 1
products[].titlestringoptional
Product title
Example: {}
products[].productIdstringoptional
Product unique identifier ID
Example: example-id
products[].regionstringoptional
Market region code
Example: US
products[].pricenumberoptional
Product price
Example: 1
products[].minPricenumberoptional
Minimum price
Example: 1
products[].maxPricenumberoptional
Maximum price
Example: 1
products[].currencystringoptional
Currency code
Example: {}
products[].totalSaleCntintegeroptional
Cumulative total sales
Example: 1
products[].totalSale1dCntintegeroptional
1-day sales
Example: 1
products[].totalSale7dCntintegeroptional
7-day sales
Example: 1
products[].totalSale28dCntintegeroptional
28-day sales
Example: 1
products[].totalSale90dCntintegeroptional
90-day sales
Example: 1
products[].totalSaleGmvAmtnumberoptional
Cumulative total GMV
Example: 1
products[].totalSaleGmv7dAmtnumberoptional
7-day GMV
Example: 1
products[].totalSaleGmv28dAmtnumberoptional
28-day GMV
Example: 1
products[].totalVideoCntintegeroptional
Number of promotional videos
Example: 1
products[].totalLiveCntintegeroptional
Number of livestream promotions
Example: 1
products[].totalIflCntintegeroptional
Number of promoting creators
Example: 1
products[].productCommissionRatenumberoptional
Product commission rate (decimal, 0.10=10%)
Example: 1
products[].productRatingnumberoptional
Product rating
Example: 1
products[].reviewCountintegeroptional
Review count
Example: 1
products[].skuCountintegeroptional
SKU count
Example: 1
products[].shopNamestringoptional
Store name
Example: {}
products[].shopSellerIdstringoptional
Seller ID
Example: example-id
products[].shopTotalUnitsSoldintegeroptional
Store total sales
Example: 1
products[].isCrossBorderintegeroptional
Whether cross-border: 1=cross-border, 0=local
Example: 1
products[].isSShopTextstringoptional
Whether a fully managed store (Yes/No)
Example: {}
products[].freeShippingTextstringoptional
Whether free shipping (Yes/No)
Example: {}
products[].availableDatestringoptional
Listing time
Example: 2026-01-01
products[].categoryNamestringoptional
Product category name
Example: {}
products[].salesTrendFlagTextstringoptional
Sales trend indicator
Example: {}
products[].tiktokUrlstringoptional
TikTok product link
Example: https://example.com/image.jpg
products[].fastmossUrlstringoptional
FastMoss product detail link
Example: https://example.com/image.jpg
products[].imageUrlstringoptional
Product image URL
Example: https://example.com/image.jpg
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "region": "US",
  "pageSize": 10,
  "keyword": "phone case",
  "pageNumber": 1
}

Example structuredContent

{
  "total": 1,
  "products": [
    {
      "productId": "example-id",
      "region": "US",
      "price": 1,
      "minPrice": 1,
      "maxPrice": 1,
      "totalSaleCnt": 1,
      "totalSale1dCnt": 1,
      "totalSale7dCnt": 1,
      "totalSale28dCnt": 1,
      "totalSale90dCnt": 1,
      "totalSaleGmvAmt": 1,
      "totalSaleGmv7dAmt": 1,
      "totalSaleGmv28dAmt": 1,
      "totalVideoCnt": 1,
      "totalLiveCnt": 1,
      "totalIflCnt": 1,
      "productCommissionRate": 1,
      "productRating": 1,
      "reviewCount": 1,
      "skuCount": 1,
      "shopSellerId": "example-id",
      "shopTotalUnitsSold": 1,
      "isCrossBorder": 1,
      "availableDate": "2026-01-01",
      "tiktokUrl": "https://example.com/image.jpg",
      "fastmossUrl": "https://example.com/image.jpg",
      "imageUrl": "https://example.com/image.jpg"
    }
  ],
  "columns": [],
  "costToken": 1
}