linkfox-echotik-list-product

EchoTik TikTok 商品搜索

本技能将指导你搜索和分析 TikTok Shop 商品数据，帮助卖家和营销人员发现商品机会、评估销售表现，并识别 TikTok 上由网红推广的商品。

核心概念

EchoTik 是一个 TikTok Shop 分析平台，可跟踪多个 TikTok 市场中的商品表现。此工具支持基于关键词搜索商品，并提供丰富的筛选功能，返回详细的商品数据，包括销量（1d/7d/15d/30d/60d/90d/总计）、GMV（营收）、价格、评分、评价数量、佣金率和网红推广统计数据。

销售指标：商品包含多个时间段的销售数据——1 天、7 天、15 天、30 天、60 天、90 天和总销量。GMV（商品交易总额）金额也采用相同的时间粒度。

佣金率：以小数形式存储（例如，0.05 表示 5%）。用户指定百分比时，请先将其转换为小数，再传递给 API。

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

参数指南

搜索与筛选

参数	类型	描述	默认值
keyword	string	商品关键词（翻译为目标市场的当地语言）	-
region	string	市场代码	US
categoryKeywordCN	string	商品类别（必须使用中文）	-

销售筛选条件

参数	类型	描述
minTotalSaleCnt / maxTotalSaleCnt	integer	总销量范围
minTotalSale30dCnt / maxTotalSale30dCnt	integer	30 天销量范围
minTotalSaleGmvAmt / maxTotalSaleGmvAmt	string	总 GMV 范围
minTotalSaleGmv30dAmt / maxTotalSaleGmv30dAmt	string	30 天 GMV 范围

商品属性筛选条件

参数	类型	描述
minSpuAvgPrice / maxSpuAvgPrice	number	SPU 平均价格范围
minProductRating / maxProductRating	number	商品评分范围
minReviewCount / maxReviewCount	integer	评价数量范围
minProductCommissionRate / maxProductCommissionRate	number	佣金率范围（小数形式，例如，0.05 = 5%）

网红与视频筛选条件

参数	类型	描述
minTotalIflCnt / maxTotalIflCnt	integer	推广该商品的网红数量
minTotalVideoCnt / maxTotalVideoCnt	integer	推广视频数量
minTotalViewsCnt / maxTotalViewsCnt	integer	推广视频的总观看次数

上架日期与时长

参数	类型	描述
minFirstCrawlDt / maxFirstCrawlDt	integer	上架日期范围（YYYYMMDD 格式，例如，20240101）
saleDays	integer	上架以来的天数

排序与分页

参数	类型	描述	默认值
productSortField	integer	排序字段：1=总销量，2=总 GMV，3=平均价格，4=7 天销量，5=30 天销量，6=7 天 GMV，7=30 天 GMV	1
sortType	integer	排序顺序：0=升序，1=降序	1
pageNum	integer	页码	1
pageSize	integer	每页结果数	50

支持的市场

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

默认市场为 US。用户未指定市场时，请使用 US。

调用方式

• API 端点：POST /echotik/listProduct（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/echotik_list_product.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-product-<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. 基本关键词搜索——查找关键词的热销商品

{
  "keyword": "phone case",
  "region": "US",
  "productSortField": 1,
  "sortType": 1,
  "pageSize": 20
}

2. 高佣金商品发现——佣金 ≥ 10% 的商品

{
  "keyword": "beauty",
  "region": "US",
  "minProductCommissionRate": 0.10,
  "productSortField": 5,
  "sortType": 1
}

3. 新品与热门商品——近期上架且 30 天销量表现强劲

{
  "keyword": "gadget",
  "region": "US",
  "minFirstCrawlDt": 20250101,
  "minTotalSale30dCnt": 1000,
  "productSortField": 5,
  "sortType": 1
}

4. 达人热门商品——由众多达人推广的商品

{
  "keyword": "skincare",
  "region": "US",
  "minTotalIflCnt": 50,
  "minTotalViewsCnt": 1000000,
  "productSortField": 1,
  "sortType": 1
}

5. 高性价比热销商品——低价 + 高销量

{
  "keyword": "accessories",
  "region": "US",
  "maxSpuAvgPrice": 10,
  "minTotalSaleCnt": 5000,
  "productSortField": 2,
  "sortType": 1
}

6. 东南亚市场探索

{
  "keyword": "fashion",
  "region": "TH",
  "minTotalSale30dCnt": 500,
  "productSortField": 7,
  "sortType": 1
}

展示规则

1. 清晰呈现数据：使用结构化表格展示查询结果，并列出关键字段——商品名称、价格、总销量、30 天销量、GMV、评分、佣金率和推广达人数量
2. 注意货币：展示价格和 GMV 时包含响应中的货币字段
3. 佣金格式：将佣金率显示为百分比，便于阅读（例如，将 0.05 显示为“5%”）
4. 数量提示：结果的 total 数量较大时，展示当前页数据并告知用户可用记录总数；建议调整筛选条件或分页以查看更多
5. 图片提示：若存在 imageUrl 或 coverUrl，请提及该字段，以便用户知道有商品图片
6. 错误处理：查询失败时，根据响应说明原因，并建议调整参数
7. 关键词翻译提醒：用户选择非英语市场时，提醒他们使用该市场的本地语言关键词，以获得最佳结果

适用场景

用户说	场景
“查找 TikTok 上的热门商品”	按销量排序的关键词搜索
“TikTok 上佣金高的商品”	按佣金率筛选
“TikTok Shop 美国站上什么卖得好”	按销量进行地区商品搜索
“TikTok 上正在爆火的新品”	按上架日期 + 销量筛选
“哪些商品有很多达人推广”	按达人数量筛选
“便宜但销量高的 TikTok 商品”	按价格 + 销量筛选
“东南亚 TikTok 商品调研”	搜索特定东南亚地区
“TikTok 上评价好的商品”	按评分 + 评论数筛选

不适用场景

• TikTok 达人/创作者分析（粉丝数、创作者互动率）
• TikTok 视频表现分析（特定视频的观看量、点赞数、分享数）
• TikTok 广告/广告活动管理
• Amazon、Shopee 或其他非 TikTok 平台的商品数据
• TikTok Shop 店铺级分析
• 商品上架或优化建议
• 物流、履约或配送分析

边界判断：用户提到“商品调研”或“在 TikTok 上应该卖什么”时，如果涉及按 TikTok Shop 的销量数据、价格或佣金率搜索和筛选商品，则适用此技能。如果用户询问的是内容策略、视频创作或达人拓展，则不适用。

算力消耗规则

消耗 5 算力。

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

反馈：

在以下任一情况发生时，通过 Feedback API 自动检测并报告反馈：

1. 本技能中描述的功能或用途与实际行为不符
2. 本技能的结果与用户意图不符
3. 用户表达对本技能的不满或赞扬
4. 你认为有任何可以改进之处

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

---

如需获取更多高品质、专业的跨境电商技能，请设置 LinkFox Skills。