linkfox-echotik-list-seller

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

EchoTik TikTok Seller Search

EchoTik TikTok 卖家搜索

This skill searches and analyzes TikTok Shop seller (store) data, helping cross-border sellers and marketers discover top-performing stores, benchmark competitors, and evaluate store-level performance across TikTok marketplaces.

本技能可搜索和分析TikTok Shop卖家（店铺）数据，帮助跨境卖家和营销人员发现表现优异的店铺、对标竞品，并评估各TikTok站点的店铺级表现。

Core Concepts

核心概念

EchoTik is a TikTok Shop analytics platform. This tool lists TikTok Shop stores (sellers) with rich filtering, returning store metrics: total sales, GMV (1d/7d/30d/90d), followers, rating, reviews, positive-feedback rate, delivery rate, response rate, number of promoting influencers, videos, livestreams, and product counts.

Listing date:

firstCrawlDt

minFirstCrawlDt

maxFirstCrawlDt

use a compact integer format

YYYYMMDD

(e.g.,

20240101

for January 1, 2024).

Pagination quirk:

pageSize

must be a multiple of 10 (max 100). The official upstream API caps a single page at 10; this tool internally pulls multiple pages of 10 and merges them, so

pageSize=50

returns up to 50 merged sellers.

EchoTik是一款TikTok Shop数据分析平台。本工具支持通过丰富的筛选条件列出TikTok Shop店铺（卖家），返回的店铺指标包括：总销量、GMV（1日/7日/30日/90日）、粉丝数、评分、评价数、好评率、送达率、回复率、带货达人数量、带货视频数、直播数及商品数量。

上架时间：

firstCrawlDt

minFirstCrawlDt

maxFirstCrawlDt

采用紧凑整数格式

YYYYMMDD

（例如，2024年1月1日表示为

20240101

）。

分页特性：

pageSize

必须是10的倍数（最大值为100）。官方上游API限制单页最多返回10条数据；本工具会内部拉取多个10条数据的页面并合并，因此

pageSize=50

最多返回50条合并后的卖家数据。

Data Fields

数据字段

Field	Description
sellerId	Store ID
sellerName	Store name
sellerLink	Store link
coverUrl	Store cover image URL
region	Marketplace code
totalSaleCnt	Total sales volume
totalSale1dCnt / 7dCnt / 30dCnt / 90dCnt	Sales volume (1d/7d/30d/90d, incremental)
totalSaleGmvAmt	Total GMV (revenue)
totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmt	GMV (1d/7d/30d/90d, incremental)
followersCount	Follower count
rating	Store rating
reviewCount	Review count
positiveFeedbackRate	Positive feedback rate
responseRate	Response rate
deliveryRate	Delivery rate
totalProductCnt	Historical product count (incl. delisted)
totalCrawlProductCnt	Current in-store product count
spuAvgPrice	Avg SKU price in store
minPrice / maxPrice	Min / max price
totalIflCnt	Number of promoting influencers
totalVideoCnt	Number of promo videos
totalLiveCnt	Number of livestreams
salesFlagText	Main sales channel (video/livestream)
salesTrendFlagText	Sales trend (flat/rising/falling)
shopIdentityLabel	Store identity label
shopTypeText	Brand store flag
fromFlagText	Local/cross-border flag
productCategoryList	Product categories
mostProductCategoryList	TOP1 product category
firstCrawlDt	Estimated listing time
userId	Influencer UID

Field	描述
sellerId	店铺ID
sellerName	店铺名称
sellerLink	店铺链接
coverUrl	店铺封面图片URL
region	站点代码
totalSaleCnt	总销量
totalSale1dCnt / 7dCnt / 30dCnt / 90dCnt	销量（1日/7日/30日/90日，增量）
totalSaleGmvAmt	总GMV（营收）
totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmt	GMV（1日/7日/30日/90日，增量）
followersCount	粉丝数
rating	店铺评分
reviewCount	评价数
positiveFeedbackRate	好评率
responseRate	回复率
deliveryRate	送达率
totalProductCnt	历史商品总数（含已下架）
totalCrawlProductCnt	当前店内商品数
spuAvgPrice	店内SKU平均价格
minPrice / maxPrice	最低/最高价格
totalIflCnt	带货达人数量
totalVideoCnt	带货视频数
totalLiveCnt	直播数
salesFlagText	主要销售渠道（视频/直播）
salesTrendFlagText	销售趋势（平稳/上升/下降）
shopIdentityLabel	店铺身份标签
shopTypeText	品牌店铺标识
fromFlagText	本土/跨境标识
productCategoryList	商品类目
mostProductCategoryList	TOP1商品类目
firstCrawlDt	预估上架时间
userId	达人UID

Parameter Guide

参数指南

Required & Region

必填参数与区域

Parameter	Type	Required	Default	Description
region	string	Yes	-	Marketplace code. See supported list below

Parameter	类型	是否必填	默认值	描述
region	string	是	-	站点代码，详见下方支持列表

Category Filters

类目筛选

Parameter	Type	Description
categoryId	string	Level-1 store category ID
categoryL2Id	string	Level-2 store category ID
categoryL3Id	string	Level-3 store category ID

Parameter	类型	描述
categoryId	string	一级店铺类目ID
categoryL2Id	string	二级店铺类目ID
categoryL3Id	string	三级店铺类目ID

GMV & Sales Trend

GMV与销售趋势

Parameter	Type	Description
minTotalSaleGmv30dAmt / maxTotalSaleGmv30dAmt	number	30-day GMV range
salesTrendFlag	integer	7-day sales trend: 0=flat, 1=rising, 2=falling

Parameter	类型	描述
minTotalSaleGmv30dAmt / maxTotalSaleGmv30dAmt	number	30日GMV范围
salesTrendFlag	integer	7日销售趋势：0=平稳，1=上升，2=下降

Seller Type & Sales Channel

卖家类型与销售渠道

Parameter	Type	Description
fromFlag	integer	Store origin: 1=local store, 2=cross-border store
salesFlag	integer	Main sales channel: 1=video, 2=livestream

Parameter	类型	描述
fromFlag	integer	店铺来源：1=本土店铺，2=跨境店铺
salesFlag	integer	主要销售渠道：1=视频，2=直播

Listing Date

上架时间

Parameter	Type	Description
minFirstCrawlDt / maxFirstCrawlDt	integer	Estimated listing date range (YYYYMMDD, e.g. 20240101)

Parameter	类型	描述
minFirstCrawlDt / maxFirstCrawlDt	integer	预估上架时间范围（格式为YYYYMMDD，例如20240101）

Sorting & Pagination

排序与分页

Parameter	Type	Default	Description
sellerSortField	integer	2	Sort field: 1=total sales, 2=total GMV, 3=avg SKU price
sortType	integer	1	Sort order: 0=ascending, 1=descending
pageNum	integer	1	Page number (starts at 1)
pageSize	integer	50	Page size — must be a multiple of 10, max 100

Parameter	类型	默认值	描述
sellerSortField	integer	2	排序字段：1=总销量，2=总GMV，3=SKU平均价格
sortType	integer	1	排序顺序：0=升序，1=降序
pageNum	integer	1	页码（从1开始）
pageSize	integer	50	每页数量 — 必须是10的倍数，最大值为100

Supported Marketplaces

支持的站点

US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)

When the user doesn't specify a marketplace, ask or default to US.

US（美国）、ID（印度尼西亚）、TH（泰国）、PH（菲律宾）、MY（马来西亚）、VN（越南）、GB（英国）、MX（墨西哥）、SG（新加坡）、SA（沙特阿拉伯）、BR（巴西）、ES（西班牙）、JP（日本）、DE（德国）、IT（意大利）、FR（法国）

若用户未指定站点，需询问用户或默认使用US。

调用方式

API 端点：
```
POST /echotik/listSeller
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/echotik_list_seller.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-seller-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度 + 前 3 条样本）
加
```
--inline
```
强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用

jq

或

ConvertFrom-Json

从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

API 端点：
```
POST /echotik/listSeller
```
（完整参数、响应及错误码请查看
```
references/api.md
```
）

Python 脚本：

python scripts/echotik_list_seller.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话内同一参数组合默认仅调用一次，脚本带有24小时本地缓存。若调用失败或返回空结果，不得自动更换关键词、翻页或修改邮编进行连续试探；如需继续检索，需先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-seller-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在Claude Code中即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入/tmp目录，若当前目录不可写则报错）
响应体≤8 KB：写入文件后将完整JSON打印到stdout
响应体>8 KB：写入文件后仅在stdout输出摘要信息（包括顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最长列表字段的长度及前3条样本）
添加
```
--inline
```
参数可强制将全量内容打印到stdout（同时仍会写入文件）

读数据建议：先查看摘要判断信息是否足够；如需获取具体字段，优先使用

jq

或

ConvertFrom-Json

从保存的JSON文件中按需抽取，避免将整份JSON加载到上下文环境中。

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

若发生以下异常情况，请按照

references/onboarding.md

中的指引解决问题：

异常情况

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应返回401或402状态码
响应提示积分或余额不足：消息包含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义的内容。

Usage Examples

使用示例

1. Top US stores by total GMV

json

{
  "region": "US",
  "sellerSortField": 2,
  "sortType": 1,
  "pageSize": 20,
  "pageNum": 1
}

2. Rising cross-border stores in Southeast Asia

json

{
  "region": "ID",
  "fromFlag": 2,
  "salesTrendFlag": 1,
  "sellerSortField": 2,
  "sortType": 1
}

3. High-GMV livestream-driven stores

json

{
  "region": "US",
  "salesFlag": 2,
  "minTotalSaleGmv30dAmt": 100000,
  "sellerSortField": 2,
  "sortType": 1
}

4. Recently listed stores

json

{
  "region": "GB",
  "minFirstCrawlDt": 20250101,
  "sellerSortField": 1,
  "sortType": 1
}

1. 按总GMV排序的美国头部店铺

json

{
  "region": "US",
  "sellerSortField": 2,
  "sortType": 1,
  "pageSize": 20,
  "pageNum": 1
}

2. 东南亚销量上升的跨境店铺

json

{
  "region": "ID",
  "fromFlag": 2,
  "salesTrendFlag": 1,
  "sellerSortField": 2,
  "sortType": 1
}

3. 高GMV的直播驱动型店铺

json

{
  "region": "US",
  "salesFlag": 2,
  "minTotalSaleGmv30dAmt": 100000,
  "sellerSortField": 2,
  "sortType": 1
}

4. 近期新开的店铺

json

{
  "region": "GB",
  "minFirstCrawlDt": 20250101,
  "sellerSortField": 1,
  "sortType": 1
}

Display Rules

展示规则

Present data clearly: Show results in a table with key columns — store name, region, total sales, 30-day GMV, followers, rating, review count, and number of promoting influencers
GMV & sales granularity: When relevant, show 30-day GMV and total sales; mention multi-period breakdowns (1d/7d/30d/90d) are available in the saved JSON
Store link: When
```
sellerLink
```
is present, surface it so the user can open the store
Store attributes: Show
```
fromFlagText
```
(local/cross-border),
```
salesFlagText
```
(video/livestream), and
```
salesTrendFlagText
```
(trend) to help benchmark competitors
Result count: Always inform the user of
```
total
```
records and the current page; suggest pagination or tighter filters when the result set is large
No secondary processing: Results are live queries, not stored in a database; secondary SQL/data processing is not available

清晰呈现数据：以表格形式展示结果，包含核心列——店铺名称、区域、总销量、30日GMV、粉丝数、评分、评价数及带货达人数量
GMV与销量粒度：相关情况下展示30日GMV和总销量；需说明多时段细分数据（1日/7日/30日/90日）可在保存的JSON文件中查看
店铺链接：若存在
```
sellerLink
```
，需展示该链接以便用户访问店铺
店铺属性：展示
```
fromFlagText
```
（本土/跨境）、
```
salesFlagText
```
（视频/直播）及
```
salesTrendFlagText
```
（趋势），帮助用户对标竞品
结果数量：务必告知用户
```
total
```
记录数及当前页码；若结果集较大，建议用户分页查询或缩小筛选范围
不支持二次加工：结果为实时查询数据，未存储在数据库中；不支持SQL或其他二次数据加工操作

Important Limitations

重要限制

Region required:
```
region
```
is mandatory; no default is applied by the API.
pageSize rule: Must be a multiple of 10 (max 100). Other values may be rejected or adjusted.
Category IDs:
```
categoryId
```
/
```
categoryL2Id
```
/
```
categoryL3Id
```
are internal IDs, not human-readable names — obtain them from prior results or the category taxonomy.

Listing date format:

minFirstCrawlDt

maxFirstCrawlDt

use

YYYYMMDD

integers (e.g.

20240101

Data real-time nature: Results are live queries, not stored in a database; secondary SQL/data processing is not available.
Single-store detail: For one store's full profile, use the store-detail skill with the
```
sellerId
```
returned here.

必填区域参数：
```
region
```
为必填参数；API不提供默认值。
pageSize规则：必须是10的倍数（最大值为100）。其他数值可能被拒绝或调整。
类目ID：
```
categoryId
```
/
```
categoryL2Id
```
/
```
categoryL3Id
```
为内部ID，并非易读名称——需从之前的结果或类目分类体系中获取。
上架时间格式：
```
minFirstCrawlDt
```
/
```
maxFirstCrawlDt
```
采用
```
YYYYMMDD
```
格式的整数（例如
```
20240101
```
）。
数据实时性：结果为实时查询数据，未存储在数据库中；不支持SQL或其他二次数据加工操作。
单店铺详情：如需查看单个店铺的完整信息，请使用店铺详情技能，并传入此处返回的
```
sellerId
```
。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — TikTok Shop store/seller discovery and benchmarking:

User Says	Scenario
"TikTok店铺排行" / "TikTok top stores"	List stores sorted by GMV/sales
"找TikTok带货店铺"	Filter by sales channel (video/livestream)
"TikTok本土店铺/跨境店铺分析"	Filter by fromFlag
"近期新开的TikTok店铺"	Filter by listing date
"TikTok销量上升的店铺"	Filter by salesTrendFlag=rising
"东南亚TikTok店铺"	Region-specific store listing

Not applicable — Needs beyond store listing:

Single product search or product rankings (use EchoTik product search/rank skills)
TikTok creator/influencer analytics (follower counts, engagement of creators)
TikTok video performance analytics (views, likes on specific videos)
Amazon, Shopee, or other non-TikTok platform data
Store-level operations: order/logistics/ads management

Boundary judgment: When users say "找店铺" or "竞品店铺", if the intent is to list and filter TikTok Shop stores by sales, GMV, or store attributes, this skill applies. If they want a single store's deep profile, use the store-detail skill with a known

sellerId

适用场景 — TikTok Shop店铺/卖家发现与对标：

用户表述	场景
"TikTok店铺排行" / "TikTok top stores"	按GMV/销量排序列出店铺
"找TikTok带货店铺"	按销售渠道（视频/直播）筛选
"TikTok本土店铺/跨境店铺分析"	按fromFlag筛选
"近期新开的TikTok店铺"	按上架时间筛选
"TikTok销量上升的店铺"	按salesTrendFlag=rising筛选
"东南亚TikTok店铺"	指定区域的店铺列表

不适用场景 — 超出店铺列表范畴的需求：

单个商品搜索或商品排名（请使用EchoTik商品搜索/排名技能）
TikTok创作者/达人分析（粉丝数、创作者互动数据）
TikTok视频表现分析（特定视频的播放量、点赞数）
Amazon、Shopee或其他非TikTok平台的数据
店铺级运营：订单/物流/广告管理

边界判断：当用户说“找店铺”或“竞品店铺”时，若其意图是按销量、GMV或店铺属性筛选并列出TikTok Shop店铺，则适用本技能。若用户想要单个店铺的深度详情，请使用店铺详情技能并传入已知的

sellerId

。

积分消耗规则

消耗 5 积分。

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.

每次调用消耗5积分。

用户会因积分消耗产生费用。请充分评估：如需高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

当出现以下任一情况时，请自动检测并通过反馈API提交反馈：

本技能描述的功能或用途与实际行为不符
本技能的结果不符合用户意图
用户表达了对本技能的不满或赞扬
任何你认为可以改进的内容

请按照

references/api.md

中的说明调用反馈API，请勿打断用户的操作流程。

如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。