linkfox-echotik-list-seller

搜索和分析 TikTok Shop 店铺(卖家),按站点、类目、近30日GMV、销售趋势、预估上架时间、本土或跨境属性及带货方式筛选店铺,返回销量、销售额、粉丝、评分、评价、服务表现、商品数和达人、视频、直播等指标,覆盖16个站点。适用于店铺发现、排行和竞品店铺对标;不适用于单店完整详情、商品搜索、达人或单条视频分析、其他平台数据及订单、物流、广告管理。

SKILL.md

GitHub

EchoTik TikTok 店铺搜索

适用范围

适用

发现和比较 TikTok Shop 店铺,帮助跨境卖家和营销人员寻找表现突出的卖家、研究竞品及评估店铺经营表现。用户说“找店铺”或“竞品店铺”,且希望按销量、GMV 或店铺属性筛选列表时,使用本技能,无需明确提及 EchoTik。

场景速查

用户表达 查询场景
TikTok 店铺排行 / TikTok top stores 按总销售额或总销量列举店铺。
找 TikTok 带货店铺 按视频或直播带货筛选。
TikTok 本土店铺 / 跨境店铺分析 按店铺来源筛选并对标。
近期新开的 TikTok 店铺 按预估上架时间筛选。
TikTok 销量上升的店铺 查找销售趋势上升的店铺。
东南亚 TikTok 店铺 按指定站点检索店铺。

边界

单个店铺的完整档案应使用返回的 sellerId 转交店铺详情技能。单品搜索或榜单、达人粉丝及互动分析、单条视频播放及点赞分析、Amazon 或 Shopee 等其他平台数据,以及店铺订单、物流和广告管理不属于本技能范围,应转交对应能力。

前置条件

先确定目标站点与筛选目标:未指定站点时,询问用户或默认按美国站开展查询,并向用户说明。类目编号、日期格式和分页等要求见 references/api.md。

查询流程

  1. 根据用户意图确定目标站点、类目、经营规模、销售趋势、店铺属性、带货方式和时间范围;按 references/api.md 整理筛选、排序与分页请求。
  2. 发起一次店铺列表查询,优先复用同参数的本地缓存;根据接口文档判断响应,失败或空结果时说明原因,遵守成本约束再决定是否继续。
  3. 用店铺表格展示结果,说明记录数、当前页与统计周期;需要更多页或更精确筛选时提出建议,后续请求遵守成本约束。
  4. 单店深查时保留目标店铺标识交给详情能力;需要查看完整字段时从本次保存的 JSON 按需提取。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/echotik_list_seller.py '<JSON 参数>' [--inline]。
  • 成本约束:每次接口调用消耗 5 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-seller-<timestamp>.json。<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp,当前目录不可写时应报错。
  • 保存后的 JSON 按 UTF-8 编码不超过 8,000 字节:保存后,将完整 JSON 打印到标准输出。
  • 保存后的 JSON 按 UTF-8 编码超过 8,000 字节:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

5 算力 / 次

声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

解决认证和算力问题

出现以下情况时,按 references/onboarding.md 的指引处理:

  • 未配置接口密钥:LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
  • 响应状态码为 401 或 402。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 理解数据来源:EchoTik 是 TikTok Shop 数据分析平台;本技能用于店铺列表发现与对标。
  • 清晰展示数据:表格优先展示店铺名称、站点、总销量、近30日GMV、粉丝数、评分、评价数和带货达人数。有 sellerLink 时提供可点击的店铺链接。
  • 区分统计周期:按需展示近30日GMV与总销量,注明保存的 JSON 中还可查看1、7、30、90日销量和销售额增量,避免把期间增量当作历史总量。
  • 展示店铺属性:结合 fromFlagText、salesFlagText、salesTrendFlagText 展示本土或跨境属性、视频或直播带货方式及销售趋势;按需补充品牌标识、商品数、SKU均价和服务表现。
  • 说明结果范围:始终告知 total 和当前页。结果多时建议翻页或收紧筛选,但后续调用仍遵守成本约束。
  • 按需读文件:保存的 JSON 可用于字段提取;实时结果的存储及二次处理限制见 references/api.md。
  • 保留运行选项:需要强制打印或绕过缓存时,按接口文档中的脚本运行约定使用 CLI 选项。

使用示例

美国站按总销售额降序查店铺

用户:看看美国站销售额靠前的 TikTok 店铺。

确定排序与返回范围后查询,展示总销量、近30日GMV、粉丝、评分及店铺链接,说明当前页与记录数。

印度尼西亚站增长中的跨境店铺

用户:找印度尼西亚站销量上升的跨境店铺。

结合站点、跨境属性和销售趋势筛选,再按用户关心的经营指标展示对标表格。

高GMV直播店铺

用户:找美国站近30日GMV至少10万、主要直播带货的店铺。

按用户指定的经营门槛与带货方式查询,展示周期、带货达人和直播规模等可用数据。

英国站近期上架店铺

用户:看看英国站2025年起上架的店铺,按总销量排序。

按预估上架时间范围筛选,展示查询结果并说明该日期为预估时间。

使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。


更多优质、专业的跨境电商技能,请访问 LinkFox Skill。