TikTok / Social Commerce

TikTok Seller Detail MCP Tool

Query TikTok Shop store (seller) details, retrieving a complete store profile by sellerId with total sales, multi-period (1d/7d/30d/90d) sales and GMV, followers, rating, review count, positive feedback rate, delivery rate, response rate, in-store product count, promoting creator count, promotional video count, livestream count, price range, product categories, and estimated listing time.

MCP tool name
nexscope_tiktok_seller_detail
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-seller-detail/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-seller-detail-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_seller_detail",
    "arguments": {
      "sellerId": "7496162162184128712"
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-seller-detail/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/tiktok-seller-detail

Arguments

NameTypeRequiredMeaning
sellerIdstringrequired
TikTok Shop seller ID. Obtainable from the "EchoTik TikTok Seller Search" skill (nexscope-echotik-list-seller) results, or from the ID in a known store link. Max length 1000
Example: 7496162162184128712

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
errcodeintegeroptional
Business status code, 200 indicates success (see error codes below)
Example: 1
errmsgstringoptional
Business status description
Example: {}
costTokenintegeroptional
Token cost
Example: 1
columnsarrayoptional
Render column definitions (display metadata)
Example: []
typestringoptional
Render style (e.g., tableListWorkbenches)
Example: {}
columns[].sellerIdstringoptional
Store ID
Example: example-id
columns[].sellerNamestringoptional
Store name
Example: {}
columns[].sellerLinkstringoptional
Store link
Example: {}
columns[].coverUrlstringoptional
Store cover image URL
Example: https://example.com/image.jpg
columns[].regionstringoptional
Region
Example: US
columns[].categoryIdstringoptional
Primary category ID
Example: example-id
columns[].categoryL2Idstringoptional
Secondary category ID
Example: example-id
columns[].categoryL3Idstringoptional
Tertiary category ID
Example: example-id
columns[].totalSaleCntintegeroptional
Total sales
Example: 1
columns[].totalSale1dCntintegeroptional
Sales in last 1 day (increment)
Example: 1
columns[].totalSale7dCntintegeroptional
Sales in last 7 days (increment)
Example: 1
columns[].totalSale30dCntintegeroptional
Sales in last 30 days (increment)
Example: 1
columns[].totalSale90dCntintegeroptional
Sales in last 90 days (increment)
Example: 1
columns[].totalSaleGmvAmtnumberoptional
Total GMV
Example: 1
columns[].totalSaleGmv1dAmtnumberoptional
GMV in last 1 day (increment)
Example: 1
columns[].totalSaleGmv7dAmtnumberoptional
GMV in last 7 days (increment)
Example: 1
columns[].totalSaleGmv30dAmtnumberoptional
GMV in last 30 days (increment)
Example: 1
columns[].totalSaleGmv90dAmtnumberoptional
GMV in last 90 days (increment)
Example: 1
columns[].followersCountintegeroptional
Follower count
Example: 1
columns[].ratingnumberoptional
Rating
Example: 1
columns[].reviewCountintegeroptional
Review count
Example: 1
columns[].positiveFeedbackRatenumberoptional
Positive feedback rate
Example: 1
columns[].responseRatenumberoptional
Response rate
Example: 1
columns[].deliveryRateintegeroptional
Delivery rate
Example: 1
columns[].totalProductCntintegeroptional
Historical product count in store (including delisted)
Example: 1
columns[].totalCrawlProductCntintegeroptional
Current product count in store
Example: 1
columns[].spuAvgPricenumberoptional
Average SKU price across the store
Example: 1
columns[].minPriceintegeroptional
Minimum price
Example: 1
columns[].maxPriceintegeroptional
Maximum price
Example: 1
columns[].totalIflCntintegeroptional
Total promoting creator count
Example: 1
columns[].totalVideoCntintegeroptional
Total promotional video count
Example: 1
columns[].totalLiveCntintegeroptional
Total livestream count
Example: 1
columns[].salesFlagTextstringoptional
Primary selling method (video sales / livestream sales)
Example: {}
columns[].salesTrendFlagTextstringoptional
Sales trend (rising / falling / stable)
Example: {}
columns[].shopIdentityLabelstringoptional
Store identity (e.g., OFFICIAL SHOP)
Example: {}
columns[].shopTypeTextstringoptional
Whether a brand store (Yes / No)
Example: {}
columns[].fromFlagTextstringoptional
Cross-border identifier (local / cross-border)
Example: {}
columns[].productCategoryListstringoptional
Product categories (JSON string, containing category_name / category_id)
Example: {}
columns[].mostProductCategoryListstringoptional
TOP1 product category (JSON string)
Example: {}
columns[].firstCrawlDtintegeroptional
Estimated listing time, in yyyyMMdd format (e.g., 20240504 represents 2024-05-04)
Example: 1
columns[].userIdstringoptional
Creator UID
Example: example-id
columns[].sourceTypestringoptional
Product source (e.g., TikTok)
Example: {}
columns[].sourceToolstringoptional
Source tool (e.g., EchoTik-Seller Detail)
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

{
  "sellerId": "7496162162184128712"
}

Example structuredContent

{
  "errcode": 1,
  "costToken": 1,
  "columns": [
    {
      "sellerId": "example-id",
      "coverUrl": "https://example.com/image.jpg",
      "region": "US",
      "categoryId": "example-id",
      "categoryL2Id": "example-id",
      "categoryL3Id": "example-id",
      "totalSaleCnt": 1,
      "totalSale1dCnt": 1,
      "totalSale7dCnt": 1,
      "totalSale30dCnt": 1,
      "totalSale90dCnt": 1,
      "totalSaleGmvAmt": 1,
      "totalSaleGmv1dAmt": 1,
      "totalSaleGmv7dAmt": 1,
      "totalSaleGmv30dAmt": 1,
      "totalSaleGmv90dAmt": 1,
      "followersCount": 1,
      "rating": 1,
      "reviewCount": 1,
      "positiveFeedbackRate": 1,
      "responseRate": 1,
      "deliveryRate": 1,
      "totalProductCnt": 1,
      "totalCrawlProductCnt": 1,
      "spuAvgPrice": 1,
      "minPrice": 1,
      "maxPrice": 1,
      "totalIflCnt": 1,
      "totalVideoCnt": 1,
      "totalLiveCnt": 1,
      "firstCrawlDt": 1,
      "userId": "example-id"
    }
  ]
}