linkfox-echotik-list-seller
搜索和分析 TikTok Shop 店铺(卖家),按站点、类目、近30日GMV、销售趋势、预估上架时间、本土或跨境属性及带货方式筛选店铺,返回销量、销售额、粉丝、评分、评价、服务表现、商品数和达人、视频、直播等指标,覆盖16个站点。适用于店铺发现、排行和竞品店铺对标;不适用于单店完整详情、商品搜索、达人或单条视频分析、其他平台数据及订单、物流、广告管理。
SKILL.mdskills/linkfox-echotik-list-seller/SKILL.md
GitHubEchoTik TikTok 店铺搜索
适用范围
适用
发现和比较 TikTok Shop 店铺,帮助跨境卖家和营销人员寻找表现突出的卖家、研究竞品及评估店铺经营表现。用户说“找店铺”或“竞品店铺”,且希望按销量、GMV 或店铺属性筛选列表时,使用本技能,无需明确提及 EchoTik。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| TikTok 店铺排行 / TikTok top stores | 按总销售额或总销量列举店铺。 |
| 找 TikTok 带货店铺 | 按视频或直播带货筛选。 |
| TikTok 本土店铺 / 跨境店铺分析 | 按店铺来源筛选并对标。 |
| 近期新开的 TikTok 店铺 | 按预估上架时间筛选。 |
| TikTok 销量上升的店铺 | 查找销售趋势上升的店铺。 |
| 东南亚 TikTok 店铺 | 按指定站点检索店铺。 |
边界
单个店铺的完整档案应使用返回的 sellerId 转交店铺详情技能。单品搜索或榜单、达人粉丝及互动分析、单条视频播放及点赞分析、Amazon 或 Shopee 等其他平台数据,以及店铺订单、物流和广告管理不属于本技能范围,应转交对应能力。
前置条件
先确定目标站点与筛选目标:未指定站点时,询问用户或默认按美国站开展查询,并向用户说明。类目编号、日期格式和分页等要求见 references/api.md。
查询流程
- 根据用户意图确定目标站点、类目、经营规模、销售趋势、店铺属性、带货方式和时间范围;按
references/api.md整理筛选、排序与分页请求。 - 发起一次店铺列表查询,优先复用同参数的本地缓存;根据接口文档判断响应,失败或空结果时说明原因,遵守成本约束再决定是否继续。
- 用店铺表格展示结果,说明记录数、当前页与统计周期;需要更多页或更精确筛选时提出建议,后续请求遵守成本约束。
- 单店深查时保留目标店铺标识交给详情能力;需要查看完整字段时从本次保存的 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。