{"code":0,"msg":null,"data":{"version":"1.0.0","description":"MCP-compatible metadata for callable Nexscope ecommerce skill APIs.","name":"nexscope-skill-api","authentication":{"type":"apiKey","header":"Authorization","format":"Bearer ${NEXSCOPE_API_KEY}"},"tools":[{"name":"nexscope_data_fm_product_rank_top_selling","description":"TikTok Intelligence FM: product Rank Top Selling API.","endpoint":"https://api.nexscope.ai/fm/productRankTopSelling","method":"POST","inputSchema":{"type":"object","properties":{"region":{"type":"string","description":"Market area code. Optional values: `US` (United States), `GB` (UK), `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).","default":"US","enum":["US","GB","MX","ES","DE","IT","FR","ID","VN","MY","TH","PH","BR","JP","SG"]},"dateInfo":{"type":"object","description":"Date specification object, including two fields: `type` and `value`.","properties":{"type":{"type":"string","description":"Time granularity: `day` (day), `week` (week), `month` (month)."},"value":{"type":"string","description":"Date values: `day` is in the format `YYYY-MM-DD`, `week` is in the format `YYYY-week number` (such as `2025-18`), `month` is in the format `YYYY-MM`."}},"required":["type","value"]},"category":{"type":"string","description":"The product category name (English) will be matched to the TikTok category ID; non-English input must be translated into English first."},"orderby":{"type":"object","description":"The collation object contains two fields: `field` and `order`.","properties":{"field":{"type":"string","description":"Sorting fields: `units_sold` (sales), `gmv` (sales), `total_units_sold` (total sales), `total_gmv` (total sales), `growth_rate` (growth rate)."},"order":{"type":"string","description":"Sorting direction: `desc` (descending) or `asc` (ascending).","default":"desc"}}},"page":{"type":"integer","description":"Page number.","default":1},"pageSize":{"type":"integer","description":"Number of items per page, maximum `10`.","default":10}},"required":["region","dateInfo"],"additionalProperties":true},"outputSchema":{"properties":{"data":{"anyOf":[{"type":"object","properties":{"page":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer"},{"type":"null"}]},"total":{"anyOf":[{"type":"integer"},{"type":"null"}]},"products":{"anyOf":[{"type":"array"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer"},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer"},{"type":"null"}]},"matchedCategoryIdPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"matchedCategoryNamePath":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxPrice":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalSaleCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalSale1dCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalSale7dCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalSale30dCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalSaleGmvAmt":{"anyOf":[{"type":"number"},{"type":"null"}]},"totalSaleGmv1dAmt":{"anyOf":[{"type":"number"},{"type":"null"}]},"totalSaleGmv7dAmt":{"anyOf":[{"type":"number"},{"type":"null"}]},"totalSaleGmv30dAmt":{"anyOf":[{"type":"number"},{"type":"null"}]},"growthRate":{"anyOf":[{"type":"number"},{"type":"null"}]},"shopName":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopTotalUnitsSold":{"anyOf":[{"type":"integer"},{"type":"null"}]},"shopSellerId":{"anyOf":[{"type":"string"},{"type":"null"}]},"categoryName":{"anyOf":[{"type":"string"},{"type":"null"}]},"categoryIds":{"anyOf":[{"type":"array"},{"type":"null"}]},"productCommissionRate":{"anyOf":[{"type":"number"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"array"},{"type":"null"}]},"shopAvatar":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string"},{"type":"null"}]},"offShelvesText":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string"},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer"},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]}},"type":"object","required":["code","msg","data","ts","time","cost","traceId"]},"title":"TikTok Intelligence FM: product Rank Top Selling API","_meta":{"nexscope/billing":{"consumesCredits":true,"instruction":"Check current pricing before execution. Do not automatically retry a paid call."},"nexscope/inputExamples":[{"region":"US","dateInfo":{"type":"day","value":"2026-04-15"},"page":1,"pageSize":10}],"nexscope/examplesAreIllustrative":true}},{"name":"nexscope_data_fm_product_search","description":"TikTok Intelligence FM: product Search API.","endpoint":"https://api.nexscope.ai/fm/productSearch","method":"POST","inputSchema":{"type":"object","properties":{"keyword":{"type":"string","description":"Search keywords (fuzzy matching of product titles)."},"region":{"type":"string","description":"Market area code. Optional values: `US` (United States), `GB` (UK), `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).","enum":["US","GB","MX","ES","DE","IT","FR","ID","VN","MY","TH","PH","BR","JP","SG"]},"category":{"type":"string","description":"For English category names, the system automatically matches the TikTok category ID; non-English names need to be translated into English first."},"shopType":{"type":"integer","description":"Store type: `1`=local store, `2`=cross-border store."},"isTopSelling":{"type":"boolean","description":"Filter only the best-selling items."},"isNewListed":{"type":"boolean","description":"Only filter new listings."},"isSshop":{"type":"boolean","description":"Filter only TikTok fully hosted (S-shop) items."},"isFreeShipping":{"type":"boolean","description":"Filter only free shipping products."},"isLocalWarehouse":{"type":"boolean","description":"Only filter products shipped from local warehouses."},"unitsSoldRange":{"type":"object","description":"Sales range filtering, format: `{\"min\": 100, \"max\": 5000}`."},"commissionRateRange":{"type":"object","description":"Commission rate range filtering, format: `{\"min\": 0.05, \"max\": 0.20}` (decimal, `0.10`=10%)."},"creatorCountRange":{"type":"object","description":"Filter the number of people carrying goods, format: `{\"min\": 10, \"max\": 500}`."},"orderField":{"type":"string","description":"Sorting fields: `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` (number of customers). Default is descending order."},"page":{"type":"integer","description":"Page number.","default":1},"pageSize":{"type":"integer","description":"Number of items per page, maximum `10`.","default":10}},"required":[],"additionalProperties":true},"outputSchema":{"properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer"},{"type":"null"}]},"products":{"anyOf":[{"type":"array"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxPrice":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalSaleCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalSale1dCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalSale7dCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalSale28dCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalSale90dCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalSaleGmvAmt":{"anyOf":[{"type":"number"},{"type":"null"}]},"totalSaleGmv7dAmt":{"anyOf":[{"type":"number"},{"type":"null"}]},"totalSaleGmv28dAmt":{"anyOf":[{"type":"number"},{"type":"null"}]},"totalVideoCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalLiveCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalIflCnt":{"anyOf":[{"type":"integer"},{"type":"null"}]},"productCommissionRate":{"anyOf":[{"type":"number"},{"type":"null"}]},"productRating":{"anyOf":[{"type":"number"},{"type":"null"}]},"reviewCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"skuCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"shopName":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopSellerId":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopTotalUnitsSold":{"anyOf":[{"type":"integer"},{"type":"null"}]},"isCrossBorder":{"anyOf":[{"type":"integer"},{"type":"null"}]},"isSShopText":{"anyOf":[{"type":"string"},{"type":"null"}]},"freeShippingText":{"anyOf":[{"type":"string"},{"type":"null"}]},"availableDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"categoryName":{"anyOf":[{"type":"string"},{"type":"null"}]},"salesTrendFlagText":{"anyOf":[{"type":"string"},{"type":"null"}]},"tiktokUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string"},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer"},{"type":"null"}]},"page":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer"},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]}},"type":"object","required":["code","msg","data","ts","time","cost","traceId"]},"title":"TikTok Intelligence FM: product Search API","_meta":{"nexscope/billing":{"consumesCredits":true,"instruction":"Check current pricing before execution. Do not automatically retry a paid call."},"nexscope/inputExamples":[{"keyword":"phone case","region":"US","orderField":"day7_units_sold","pageSize":10}],"nexscope/examplesAreIllustrative":true}}],"jsonRpcEndpoint":{"url":"https://api.nexscope.ai/api/skill-api/v1/mcp","protocol":"MCP JSON-RPC over HTTP","method":"POST","supportedMethods":["initialize","tools/list","tools/call"]}},"ts":"1792169627565","time":"2026-10-16 16:53:47","cost":"3","traceId":null}