linkfox-echotik-list-seller

EchoTik TikTok 卖家搜索

此技能可搜索和分析 TikTok Shop 卖家（店铺）数据，帮助跨境卖家和营销人员发现表现出色的店铺、对标竞争对手，并评估 TikTok 各市场的店铺表现。

核心概念

EchoTik 是一个 TikTok Shop 数据分析平台。此工具可通过丰富的筛选条件列出 TikTok Shop 店铺（卖家），并返回店铺指标：总销量、GMV（1d/7d/30d/90d）、粉丝数、评分、评论数、好评率、配送率、响应率、推广达人数量、视频数、直播数和商品数。

上架日期：firstCrawlDt / minFirstCrawlDt / maxFirstCrawlDt 使用紧凑的整数格式 YYYYMMDD（例如，20240101 表示 2024 年 1 月 1 日）。

分页注意事项：pageSize 必须是 10 的倍数（最大为 100）。官方上游 API 每页最多返回 10 条；此工具会在内部拉取多个每页 10 条的结果并合并，因此 pageSize=50 最多可返回 50 个合并后的卖家。

数据字段

字段	说明
sellerId	店铺 ID
sellerName	店铺名称
sellerLink	店铺链接
coverUrl	店铺封面图片 URL
region	市场代码
totalSaleCnt	总销量
totalSale1dCnt / 7dCnt / 30dCnt / 90dCnt	销量（1d/7d/30d/90d，增量）
totalSaleGmvAmt	总 GMV（收入）
totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmt	GMV（1d/7d/30d/90d，增量）
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

参数指南

必填项与市场

参数	类型	必填	默认值	说明
region	string	是	-	市场代码。请参阅下方的支持列表

类别筛选条件

参数	类型	说明
categoryId	string	一级店铺类别 ID
categoryL2Id	string	二级店铺类别 ID
categoryL3Id	string	三级店铺类别 ID

GMV 与销售趋势

参数	类型	说明
minTotalSaleGmv30dAmt / maxTotalSaleGmv30dAmt	number	30 天 GMV 范围
salesTrendFlag	integer	7 天销售趋势：0=持平，1=上升，2=下降

卖家类型与销售渠道

参数	类型	说明
fromFlag	integer	店铺来源：1=本地店铺，2=跨境店铺
salesFlag	integer	主要销售渠道：1=视频，2=直播

上架日期

参数	类型	说明
minFirstCrawlDt / maxFirstCrawlDt	integer	预计上架日期范围（YYYYMMDD，例如 20240101）

排序与分页

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

支持的市场

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 进入上下文。

解决认证和算力问题

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

异常情况

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

使用示例

1. GMV 总额最高的 US 商店

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

2. 东南亚快速增长的跨境商店

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

3. GMV 高、由直播带动的商店

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

4. 近期上架的商店

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

显示规则

1. 清晰呈现数据：以表格展示结果，并包含关键列——商店名称、地区、总销量、近 30 天 GMV、粉丝数、评分、评价数和带货达人数量
2. GMV 和销量粒度：适用时展示近 30 天 GMV 和总销量；说明保存的 JSON 中提供多个时间段的数据（1d/7d/30d/90d）
3. 商店链接：存在 sellerLink 时，显示该链接，方便用户打开商店
4. 商店属性：显示 fromFlagText（本地/跨境）、salesFlagText（视频/直播）和 salesTrendFlagText（趋势），以便对标竞争对手
5. 结果数量：始终告知用户记录总数 total 和当前页；结果集较大时，建议翻页或收紧筛选条件
6. 不支持二次处理：结果来自实时查询，不会存储在数据库中；不支持二次 SQL/数据处理

重要限制

1. 必须指定地区：region 为必填项；API 不会应用默认值。
2. pageSize 规则：必须是 10 的倍数（最大 100）。其他值可能会被拒绝或调整。
3. 类目 ID：categoryId / categoryL2Id / categoryL3Id 是内部 ID，并非人类可读的名称——请从先前的结果或类目分类体系中获取。
4. 上架日期格式：minFirstCrawlDt / maxFirstCrawlDt 使用 YYYYMMDD 整数（例如 20240101）。
5. 数据实时性：结果来自实时查询，不会存储在数据库中；不支持二次 SQL/数据处理。
6. 单店详情：如需查看某家商店的完整资料，请使用店铺详情技能，并传入此处返回的 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 API 自动检测并提交反馈：

1. 此技能描述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户对本技能表示不满或赞赏
4. 任何你认为可以改进的内容

请按 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

---

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