Skip to main content
Glama

Nexscope Ecommerce Data MCP

TikTok Intelligence ET: list Seller API

nexscope_data_et_list_seller

TikTok Intelligence ET: list Seller API.

Input Schema

NameRequiredDescriptionDefault
regionYesarea. Optional values: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (UK), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)
pageNumNoPagination page number, starting from 1
fromFlagNoStore source: 1=local store, 2=cross-border store
pageSizeNoNumber of items per page. **must be a multiple of 10, the maximum is 100**; the upper limit of a single page in the official interface is 10, internally it is 10 after multiple pulls per page and then merged
sortTypeNoSorting method: 0=ascending order (asc), 1=descending order (desc)
salesFlagNoMain delivery methods: 1=video, 2=live broadcast
categoryIdNoStore-level category ID. Maximum length 1000
categoryL2IdNoStore secondary category ID. Maximum length 1000
categoryL3IdNoThe third-level category ID of the store. Maximum length 1000
salesTrendFlagNoSales trend in the past 7 days: 0=stable, 1=increasing, 2=declining
maxFirstCrawlDtNoEstimated shelf time filter (maximum value), yyyyMMdd format
minFirstCrawlDtNoEstimated shelf time filter (minimum value), yyyyMMdd format (for example, 20240101 represents 2024-01-01)
sellerSortFieldNoSorting fields: 1=total sales (total_sale_cnt), 2=total sales (total_sale_gmv_amt), 3=average price of product SKU in the store (spu_avg_price)
maxTotalSaleGmv30dAmtNoGMV filtering in the past 30 days (maximum value)
minTotalSaleGmv30dAmtNoGMV screening in the past 30 days (minimum value)

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

D1.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare readOnlyHint=false and openWorldHint=true, meaning the description must explain the external-data call profile — latency, quota, pagination depth, or what the query consumes. It adds nothing: no mention of pagination limits, per-page caps, region gating, or that results are pulled from a third-party endpoint and merged internally.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One short sentence, so there is no bloat, but brevity here is under-specification rather than economy. There is no front-loaded statement of what the tool returns or what distinguishes it, and the abbreviation 'ET' wastes the only token of scope the sentence has.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 15 parameters, 1 required, no output schema, and no meaningful annotations beyond a permissive readOnly/openWorld pair, the description would need to carry substantial context. Instead an agent must infer everything about return shape, pagination behavior, and result ordering from the schema alone.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description contributes zero parameter knowledge — nothing about region being required, how salesFlag/fromFlag combine, or the sort semantics — but the schema already carries that load.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description restates the title verbatim: 'TikTok Intelligence ET: list Seller API.' The only signal is 'list Seller', which weakly implies retrieving a list of TikTok sellers, but 'ET' is an unexplained abbreviation and no scope (ranking, search, filtering) is articulated. It comes close to tautology against the name/title.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives. Siblings such as nexscope_data_cj_sellers_search, nexscope_data_et_seller_detail, nexscope_tiktok_seller_detail, nexscope_data_et_list_seller_product, and nexscope_data_cj_sellers_rankings_top_selling are indistinguishable from this tool on the description's evidence.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources