用途
本技能用于搜索和分析 TikTok Shop 商品数据，帮助卖家与营销人员发现选品机会、评估销售表现，并识别由达人带货驱动的商品。它基于 EchoTik 这一 TikTok Shop 分析平台，追踪多个 TikTok 市场的商品表现。
主要能力
- 关键词商品搜索：以关键词检索商品，关键词建议翻译为目标市场的本地语言。
- 多周期销量与 GMV：商品包含 1 天、7 天、15 天、30 天、60 天、90 天及总计的销量数据，GMV（商品交易总额）采用相同粒度。
- 丰富筛选维度：
- 销量筛选：总销量范围、30 天销量范围、总 GMV 范围、30 天 GMV 范围。
- 商品属性：SPU 平均价格范围、商品评分范围、评论数范围、佣金比例范围。
- 达人与视频：带货达人数、推广视频数、推广视频总播放量。
- 上架日期与时长：上架日期范围（YYYYMMDD 整数格式，如 20240101）、上架天数。
- 排序与分页：排序字段支持 1=总销量、2=总 GMV、3=平均价格、4=7 天销量、5=30 天销量、6=7 天 GMV、7=30 天 GMV；排序方向 0=升序、1=降序；支持页码与每页条数（默认 50）。
- 多站点覆盖：US（美国）、ID（印尼）、TH（泰国）、PH（菲律宾）、MY（马来西亚）、VN（越南）、GB（英国）、MX（墨西哥）、SG（新加坡）、SA（沙特）、BR（巴西）、ES（西班牙）、JP（日本）、DE（德国）、IT（意大利）、FR（法国）。默认站点为 US。
使用方式
- API 端点：POST /echotik/listProduct（完整参数、响应与错误码见 references/api.md）。
- Python 脚本：python scripts/echotik_list_product.py '<JSON 参数>' [--inline]。
- 参数要点：佣金比例以小数存储（如 0.05 表示 5%），用户给出百分比时需先转换为小数；上架日期字段 firstCrawlDt 使用 YYYYMMDD 紧凑整数格式。
- 输出策略（脚本默认行为）：
- 始终将完整响应写入 <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 进入上下文。
- 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
- 认证与算力问题：出现未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 未配置）、响应 401 或 402 状态码、或提示算力/余额不足（如“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”等）时，按 references/onboarding.md 引导解决。
使用示例
- 基础关键词搜索——查找某关键词的畅销商品：{"keyword": "phone case", "region": "US", "productSortField": 1, "sortType": 1, "pageSize": 20}
- 高佣金商品发现——佣金 ≥ 10% 的商品：{"keyword": "beauty", "region": "US", "minProductCommissionRate": 0.10, "productSortField": 5, "sortType": 1}
- 新品与趋势商品——近期上架且 30 天销量强劲：{"keyword": "gadget", "region": "US", "minFirstCrawlDt": 20250101, "minTotalSale30dCnt": 1000, "productSortField": 5, "sortType": 1}
- 达人热推商品——由众多达人推广的商品：{"keyword": "skincare", "region": "US", "minTotalIflCnt": 50, "minTotalViewsCnt": 1000000, "productSortField": 1, "sortType": 1}
- 低价高销商品——低价格 + 高销量：{"keyword": "accessories", "region": "US", "maxSpuAvgPrice": 10, "minTotalSaleCnt": 5000, "productSortField": 2, "sortType": 1}
- 东南亚市场探索：{"keyword": "fashion", "region": "TH", "minTotalSale30dCnt": 500, "productSortField": 7, "sortType": 1}
展示规则
- 清晰呈现数据：以有序表格展示查询结果，关键列包括商品名称、价格、总销量、30 天销量、GMV、评分、佣金比例和带货达人数。
- 货币意识：展示价格与 GMV 时包含响应中的 currency 字段。
- 佣金格式化：佣金比例以百分比展示（如 0.05 显示为“5%”）。
- 数量提示：结果总数较大时，展示当前页数据并告知用户可用记录总数，建议调整筛选或分页以探索更多。
- 图片引用：若存在 imageUrl 或 coverUrl，应提及以便用户知道有商品图片可用。
- 错误处理：查询失败时根据响应说明原因并建议调整参数。
- 关键词翻译提醒：用户面向非英语市场时，提醒关键词应使用该市场本地语言以获得最佳结果。
适用场景
- “Find trending products on TikTok”——按销量排序的关键词搜索。
- “TikTok products with high commission”——按佣金比例筛选。
- “What's selling well on TikTok Shop US”——按销量进行区域商品搜索。
- “New products blowing up on TikTok”——按上架日期 + 销量筛选。
- “Which products have many influencers promoting them”——按达人数筛选。
- “Cheap but high-volume TikTok products”——按价格 + 销量筛选。
- “TikTok product research for Southeast Asia”——搜索特定东南亚区域。
- “Products with good reviews on TikTok”——按评分 + 评论数筛选。
边界判断：当用户提到“product research”或“what should I sell on TikTok”，若涉及在 TikTok Shop 上按销量数据、定价或佣金比例搜索和筛选商品，则适用本技能；若询问内容策略、视频创作或达人外联，则不适用。
限制
以下场景不适用：
- TikTok 达人/创作者分析（创作者的粉丝数、互动率）。
- TikTok 视频表现分析（特定视频的播放量、点赞、分享）。
- TikTok 广告/广告活动管理。
- Amazon、Shopee 或其他非 TikTok 平台商品数据。
- TikTok Shop 店铺级分析。
- 商品上架创建或优化建议。
- 物流、履约或运输分析。
算力消耗
消耗 5 算力。用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。
反馈
在以下情况时，通过 Feedback API 自动检测并报告反馈（按 references/api.md 调用，不要打断用户流程）：本技能描述的功能或目的与实际行为不符；技能结果与用户意图不符；用户对本技能表达不满或赞扬；任何你认为可改进之处。