FastMoss — TikTok 商品搜索

本技能指导您如何使用 FastMoss 搜索和筛选 TikTok Shop 商品数据，帮助卖家与营销人员在全球 15 个 TikTok 市场中发现商品机会、评估销售表现，并识别由达人驱动的热门商品。

核心概念

FastMoss 是一款知名的 TikTok 跨境电商数据平台，可追踪多个 TikTok 市场的商品表现。该工具支持基于关键词的商品搜索，并提供丰富的筛选能力，返回详尽的商品数据，包括多周期销量（7 天 / 28 天 / 90 天 / 累计）、GMV（成交额）、价格、评分、评论数、佣金率、达人推广统计及店铺信息。

销量指标：商品包含多周期销量数据——7 天、28 天、90 天及累计销量。GMV（商品交易总额）同样按相同粒度提供。

佣金率：以小数形式存储（例如 0.10 表示 10%）。向用户展示时需转换为百分比格式。

店铺类型：商品可按店铺类型筛选——本地店铺（1）或跨境店铺（2）。isCrossBorder 字段（1=跨境，0=本地）与 isSShopText 字段（TikTok 全托管店铺）提供额外的店铺分类信息。

参数指南

搜索与筛选

布尔型筛选项

范围型筛选项

排序与分页

支持的市场（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 '' [--inline]
• 成本约束：本工具会消耗积分；同一会话中相同参数组合默认仅调用一次，脚本自带 24 小时本地缓存。失败或空结果不得自动更换关键词、翻页或修改邮编进行连续试探；如需继续检索，须先向用户说明将产生额外消耗。

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

• 始终将完整响应写入 /linkfox///data/linkfox-fastmoss-product-search-.json（其中 为脚本执行时的工作目录，在 Claude Code 中即当前项目目录； 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，若当前目录不可写则报错）
• 响应体 ≤ 8 KB：落盘后将完整 JSON 打印至 stdout
• 响应体 > 8 KB：落盘后 stdout 仅输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）
• 添加 --inline 参数可强制将全部内容打印至 stdout（仍会落盘）

读取数据建议：请先查看摘要判断是否足够；如需提取具体字段，请优先使用 jq 或 ConvertFrom-Json 从已保存的 JSON 文件中按需抽取，避免整份 JSON 进入上下文。

解决认证和积分问题

发生以下异常情况时，采用以下措施处理：

异常情况

• 未配置 API Key：环境变量既未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应状态码为 401 或 402
• 响应提示积分或余额不足：消息中包含“积分余额不足”、“计费不足”、“余额不足”、“quota exceeded”、“insufficient balance”、“套餐到期”、“需充值”、“请充值”等字眼，或具有类似含义的内容。

措施

• 优先通过本 skill 内的 onboarding.md 引导解决问题。
• 若找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这一 skill 并依据其引导流程处理。如尚未安装，请先安装：
  • 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装该 skill。如需用户授权方可下载，应主动询问用户并获得授权，你不得自行放弃下载。
• 兜底措施：仅当上述两种方式经全力尝试均不可行时，才提示用户参考 https://skill.linkfox.com/linkfoxskills/guide.htm 获取 API Key，或前往 https://os.linkfox.com/ 补充积分。

数据字段

每个商品返回的关键字段如下：

使用示例

1. 基础关键词搜索 — 查找热销商品

{
  "keyword": "phone case",
  "region": "US",
  "orderField": "total_units_sold",
  "pageSize": 10
}

2. 高佣金商品挖掘 — 佣金率 ≥ 10%

{
  "keyword": "beauty",
  "region": "US",
  "commissionRateRange": {"min": 0.10},
  "orderField": "commission_rate"}

3. 跨境店铺商品 — 按店铺类型筛选

{
  "keyword": "gadget",
  "region": "US",
  "shopType": 2,
  "orderField": "day7_units_sold"
}

4. 达人热推商品 — 由大量创作者推广的商品

{
  "keyword": "skincare",
  "region": "US",
  "creatorCountRange": {"min": 50},
  "orderField": "creator_count"
}

5. TikTok 上的热销新品

{
  "keyword": "fashion",
  "region": "GB",
  "isTopSelling": true,
  "isNewListed": true,
  "orderField": "day7_gmv"
}

展示规则

1. 仅呈现数据：以结构化表格形式展示查询结果，关键列包括商品名称、价格、累计销量、7 天销量、GMV、评分、佣金率、推广达人数量；不得提供主观商业建议
2. 佣金率格式化：佣金率为小数（0.10 = 10%），始终以百分比形式展示以提升可读性
3. 跨境识别：isCrossBorder：1 = 跨境店铺，0 = 本地店铺，需清晰标识
4. 币种识别：展示价格与 GMV 时须包含响应中的 currency 字段
5. 趋势标签：直接展示 salesTrendFlagText 字段作为趋势指示器
6. 店铺标识：直接展示 freeShippingText 和 isSShopText 字段（其值为可读文本）
7. 错误处理：当查询失败时，应根据响应内容解释原因，并建议调整参数

重要限制

• 无强制必填参数（全部为可选），但至少需提供 keyword 或 category 才能获得有意义的结果
• 每页最多返回 10 条数据

适用场景

不适用场景

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

边界判断：当用户表达“商品调研”或“我在 TikTok 上该卖什么”时，若其意图是基于 TikTok Shop 的销量数据、价格或佣金率进行商品搜索与筛选，则本技能适用；若其关注的是内容策略、视频制作或达人对接，则本技能不适用。

积分消耗规则

消耗 10.5 积分。

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

反馈机制：

当出现以下任一情形时，需自动识别并调用 Feedback API 上报反馈：

1. 本技能描述的功能或用途与实际行为不符
2. 本技能返回结果与用户真实意图不符
3. 用户明确表达了对该技能的不满或肯定
4. 你认为任何值得改进之处

Feedback API 的调用方式详见 references/api.md。请勿中断用户的操作流程。

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