linkfox-fastmoss-product-search

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 全托管店铺）提供了额外的店铺分类信息。

参数指南

搜索与筛选

参数	类型	必填	描述
keyword	string	否	搜索关键词（商品标题模糊匹配）
region	string	否	市场区域代码。支持：US、GB、MX、ES、DE、IT、FR、ID、VN、MY、TH、PH、BR、JP、SG
category	string	否	英文类别名称，用于匹配 TikTok 类别 ID。非英文类别应先翻译
shopType	integer	否	店铺类型：1=本地店铺，2=跨境店铺

布尔筛选条件

参数	类型	必填	描述
isTopSelling	boolean	否	仅筛选热销商品
isNewListed	boolean	否	仅筛选新品
isSshop	boolean	否	仅筛选 TikTok 全托管（S-shop）商品
isFreeShipping	boolean	否	仅筛选免运费商品
isLocalWarehouse	boolean	否	仅筛选本地仓库商品

范围筛选条件

参数	类型	必填	描述
unitsSoldRange	object	否	销量范围筛选：{min, max}
commissionRateRange	object	否	佣金率范围筛选：{min, max}
creatorCountRange	object	否	创作者／网红数量范围筛选：{min, max}

排序与分页

参数	类型	必填	描述
orderField	string	否	排序字段：day7_units_sold、day7_gmv、commission_rate、total_units_sold、total_gmv、creator_count。默认按降序排列
page	integer	否	页码，默认为 1
pageSize	integer	否	每页条目数，最多 10 条，默认为 10

支持的市场（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]
• 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-fastmoss-product-search-<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 放入上下文。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

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

数据字段

每个产品返回的关键字段：

字段	描述
title	产品名称
productId	唯一产品标识符
region	市场区域代码
price, minPrice, maxPrice	产品价格和价格区间
currency	货币代码
totalSaleCnt	累计总销量
totalSale1dCnt, totalSale7dCnt, totalSale28dCnt, totalSale90dCnt	各时间段销量
totalSaleGmvAmt, totalSaleGmv7dAmt, totalSaleGmv28dAmt	各时间段 GMV
totalVideoCnt, totalLiveCnt, totalIflCnt	视频数、直播数、达人数量
productCommissionRate	佣金率（小数，0.10 = 10%）
productRating, reviewCount	评分和评价数
skuCount	SKU 数量
shopName, shopSellerId, shopTotalUnitsSold	店铺信息
isCrossBorder	1 = 跨境，0 = 本地
isSShopText, freeShippingText	全托管店铺标记、免运费标记
salesTrendFlagText	销售趋势标签
categoryName	产品类别
tiktokUrl, fastmossUrl, imageUrl	链接和图片

使用示例

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 时，包含响应中的货币字段
5. 趋势标签：直接将 salesTrendFlagText 显示为趋势指标
6. 店铺标记：直接显示 freeShippingText 和 isSShopText（其值为易读文本）
7. 错误处理：查询失败时，根据响应说明原因，并建议调整参数

重要限制

• 无必填参数（全部可选），但至少提供关键词或类别才能获得有意义的结果
• 每页最多 10 项

适用场景

用户说	场景
“查找 TikTok 上的热门产品”	按销量排序的关键词搜索
“TikTok 上佣金高的产品”	按佣金率范围筛选
“TikTok Shop 美国站哪些产品卖得好”	按销量搜索区域产品
“搜索 TikTok 跨境店铺产品”	按 shopType=2 筛选
“哪些产品有很多达人推广”	按创作者数量范围筛选
“TikTok 全托管店铺产品”	使用 isSshop=true 筛选
“东南亚 TikTok 产品调研”	搜索特定东南亚地区
“TikTok 新上架的热销产品”	使用 isTopSelling + isNewListed 标志
“FastMoss 产品数据”	直接提及平台名称

不适用场景

• TikTok 达人/创作者分析（粉丝数、创作者互动率）
• TikTok 视频表现分析（特定视频的观看次数、点赞数、分享数）
• TikTok 广告/广告活动管理
• Amazon、Shopee 或其他非 TikTok 平台的产品数据
• TikTok Shop 店铺级分析
• 产品上架或优化建议
• 物流、履约或运输分析

边界判断：当用户提到“产品调研”或“在 TikTok 上应该卖什么”时，如果涉及根据 TikTok Shop 上的销售数据、定价或佣金率搜索和筛选产品，则适用此技能。如果用户询问的是内容策略、视频创作或达人拓展，则不适用。

算力消耗规则

消耗 11 算力。

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

反馈：

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

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

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

---

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