用途
Nexscope TikTok Product Search 是一个用于搜索和分析 TikTok Shop 商品数据的技能，面向卖家与营销人员，帮助其在 TikTok 上发现商品机会、评估销售表现、识别由达人推广带动的热门商品。该技能基于 Nexscope 的 TikTok Shop 分析平台，通过关键词检索商品并返回详细数据。
主要能力
- 关键词商品搜索，可按目标市场站点筛选。
- 返回商品的多周期销售数据：1 天、7 天、15 天、30 天、60 天、90 天及总销量，GMV 同样提供以上各周期的粒度。
- 返回价格、评分、评论数、佣金率、达人推广统计等字段。
- 支持多维度筛选：
- 销量与 GMV 区间（总量及 30 天）；
- SPU 均价区间、评分区间、评论数区间、佣金率区间（佣金以小数表示，如 0.05 代表 5%）；
- 推广达人数、推广视频数、推广视频总播放量区间；
- 上架日期区间（firstCrawlDt，格式为 YYYYMMDD，如 20240101）及上架天数。
- 支持排序：可按总销量、总 GMV、均价、7 天销量、30 天销量、7 天 GMV、30 天 GMV 排序，支持升序或降序，并支持分页（默认每页 50 条）。
支持的市场
US（美国）、ID（印尼）、TH（泰国）、PH（菲律宾）、MY（马来西亚）、VN（越南）、GB（英国）、MX（墨西哥）、SG（新加坡）、SA（沙特阿拉伯）、BR（巴西）、ES（西班牙）、JP（日本）、DE（德国）、IT（意大利）、FR（法国）。默认市场为 US。
使用方式
- API 端点：POST /echotik/listProduct。
- Python 脚本：python scripts/echotik_list_product.py '<JSON 参数>' [--inline]。
- 需设置 NEXSCOPE_API_KEY，积分可在 Nexscope 帮助页面管理。
- 成本约束：工具调用消耗积分；同一会话内相同参数组合默认只调用一次，脚本内置 24 小时本地缓存；失败或空结果时不应自动更换关键词、翻页或改筛选条件重试，追加查询前应先告知用户。
- 输出策略：完整响应写入工作目录下 nexscope/<日期>/<会话>/data/ 的 JSON 文件（会话取自 SESSION_ID 环境变量）；响应体不超过 8 KB 时在写盘后向标准输出打印完整 JSON，超过 8 KB 时仅输出摘要（顶层字段、total/costToken 等计数、最大列表字段长度及前 3 条样本）；加 --inline 可强制完整输出到标准输出（仍会写盘）。建议先用摘要判断数据是否足够，再按需用 jq 或 ConvertFrom-Json 从已保存文件中提取具体字段。
- 显示规则：以表格展示商品名、价格、总销量、30 天销量、GMV、评分、佣金率、推广达人数等关键列；显示价格与 GMV 时带上响应中的货币字段；佣金率以百分比展示（如 0.05 显示为 5%）；结果总量较大时展示当前页并告知用户总记录数，建议调整筛选或翻页；存在 imageUrl 或 coverUrl 时提示可获取商品图片；查询失败时根据响应说明原因并建议调整参数；目标为非英语市场时提醒用户关键词应使用该市场本地语言。
适用场景
- 按销量查找 TikTok 热门商品。
- 筛选高佣金商品。
- 查询某地区 TikTok Shop 热销商品。
- 结合上架日期与销量发现新品爆款。
- 查找推广达人众多的商品。
- 筛选低价高销量商品。
- 东南亚市场商品调研。
- 按评分与评论数筛选口碑商品。
限制
不适用于：TikTok 达人/创作者分析（粉丝数、互动率等）、TikTok 视频表现分析、TikTok 广告与投放管理、Amazon/Shopee 等其他平台商品数据、TikTok Shop 店铺级分析、商品上架创建或优化建议、物流履约分析。若用户询问内容策略、视频创作或达人外联，也不适用。