用途
本技能用于基于 FastMoss 数据搜索和筛选 TikTok Shop 商品数据，帮助卖家与营销人员发现商品机会、评估销售表现，并识别达人驱动的商品。覆盖全球 15 个 TikTok 市场。
主要能力
- 关键词搜索：按商品标题模糊匹配。
- 多维度筛选：市场区域、类目（英文类目名，匹配 TikTok 类目 ID）、店铺类型（1=本地店，2=跨境店）、布尔筛选（热销、新品、TikTok 全托管 S 店、免运费、本地仓）、范围筛选（销量、佣金率、达人数）。
- 排序与分页：排序字段支持 day7_units_sold、day7_gmv、commission_rate、total_units_sold、total_gmv、creator_count，默认降序；每页最多 10 条，默认 10 条。
- 返回字段：商品名称、商品 ID、区域、价格与价格区间、货币、多周期销量（1/7/28/90 天及累计）、多周期 GMV、视频数/直播数/达人数、佣金率（小数，0.10 表示 10%）、评分与评论数、SKU 数、店铺信息、是否跨境、全托管/免运费标识、销售趋势标签、类目名、TikTok/FastMoss 链接与图片。
支持市场（15 个）
US、GB、MX、ES、DE、IT、FR、ID、VN、MY、TH、PH、BR、JP、SG。
使用方式
- API 端点：POST /fastmoss/productSearch（完整参数、响应与错误码见 references/api.md）。
- Python 脚本：python scripts/fastmoss_product_search.py '<JSON 参数>' [--inline]。
- 成本约束：本工具消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24 小时本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
- 输出策略：始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-fastmoss-product-search-<timestamp>.json（<cwd> 为脚本执行时的工作目录，<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）。响应体 ≤ 8 KB 时落盘后把完整 JSON 打印到 stdout；> 8 KB 时落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）；加 --inline 强制全量打印到 stdout（同样落盘）。读数据建议先看摘要，需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取。
- 认证与算力问题：未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY）、响应 401 或 402、提示算力或余额不足时，按 references/onboarding.md 引导解决。
使用示例
- 基础关键词搜索：{"keyword": "phone case", "region": "US", "orderField": "total_units_sold", "pageSize": 10}
- 高佣金商品发现：{"keyword": "beauty", "region": "US", "commissionRateRange": {"min": 0.10}, "orderField": "commission_rate"}
- 跨境店商品：{"keyword": "gadget", "region": "US", "shopType": 2, "orderField": "day7_units_sold"}
- 达人热推商品：{"keyword": "skincare", "region": "US", "creatorCountRange": {"min": 50}, "orderField": "creator_count"}
- TikTok 热销新品：{"keyword": "fashion", "region": "GB", "isTopSelling": true, "isNewListed": true, "orderField": "day7_gmv"}
展示规则
仅呈现数据：以表格展示关键列（商品名、价格、总销量、7 天销量、GMV、评分、佣金率、推广达人数），不做主观商业建议。佣金率以小数存储（0.10 = 10%），展示时转为百分比。isCrossBorder: 1 = 跨境店，0 = 本地店，需清晰标注。展示价格与 GMV 时包含响应中的货币字段。salesTrendFlagText 直接作为趋势指标展示。freeShippingText 与 isSShopText 直接展示（值为可读文本）。查询失败时根据响应说明原因并建议调整参数。
适用场景
- 查找 TikTok 热门商品（按销量排序的关键词搜索）
- 查找高佣金 TikTok 商品（按佣金率范围筛选）
- 查看 TikTok Shop 某市场热销商品（按区域与销量搜索）
- 搜索 TikTok 跨境店商品（shopType=2）
- 查找达人推广多的商品（按达人数范围筛选）
- 查找 TikTok 全托管店商品（isSshop=true）
- 东南亚 TikTok 选品（搜索特定东南亚区域）
- 查找 TikTok 新热销商品（isTopSelling + isNewListed）
- 引用 FastMoss 商品数据
限制
- 无必填参数（全部可选），但至少提供 keyword 或 category 才能获得有意义的结果。
- 每页最多 10 条。
- 不适用于：TikTok 达人/创作者分析（粉丝数、互动率）、TikTok 视频表现分析（播放、点赞、分享）、TikTok 广告/广告活动管理、Amazon/Shopee 等非 TikTok 平台商品数据、TikTok Shop 店铺级分析、商品上架创建或优化建议、物流履约或配送分析。
- 边界判断：当用户说“选品”或“在 TikTok 上卖什么”，若涉及按 TikTok Shop 的销量、价格或佣金率搜索筛选商品，则适用本技能；若询问内容策略、视频创作或达人外联，则不适用。
算力消耗
消耗 11 算力。用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。