linkfox-echotik-product-search

EchoTik TikTok 商品搜索

此技能将指导你如何搜索和分析 TikTok Shop 商品数据，帮助卖家和营销人员发现商品机会、评估销售表现，并识别由达人带货的商品。

核心概念

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 用法

此工具调用 LinkFox 工具网关 API。有关调用约定、请求参数和响应结构，请参阅 references/api.md。你也可以直接执行 scripts/echotik_list_product.py 来运行查询。

使用示例

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 的销量数据、定价或佣金率搜索和筛选产品，则适用此技能。如果用户询问的是内容策略、视频制作或网红拓展，则不适用。

反馈：

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

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

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

处理大型响应

为避免撑满 Agent 上下文，请将响应持久化到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/echotik_list_product.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

请将 --out-dir 指定在任何 git 工作树之外（例如，Unix 上的 /tmp/...，Windows 上的 %TEMP%/...）。持久化的响应可能包含个人身份信息、定价信息或敏感的身份验证数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并且只输出架构预览和文件路径。read 可提取特定字段；可使用 --limit/--offset 进行切片，并使用 --format json|jsonl|csv|table 指定输出格式。

适合采用此模式的情况——请根据响应特点自行判断，例如：

• 每条记录包含大量字段，或包含不需要的字段
• 批量/分页结果（每次调用返回多个项目）
• 长文本字段（描述、评价、HTML、时间序列）
• 响应会在后续步骤中重复使用，而不是立即消费

对于小型、仅使用一次的响应，直接调用主脚本即可。

⚠️ 预览是经过截断的架构和样例，并非完整数据。任何字段级决策都必须通过 read 从持久化文件中读取。

---

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