linkfox-fastmoss-product-rank-top-selling

FastMoss - TikTok 热销排行榜

本技能将指导你如何通过 FastMoss 数据源查询和分析 TikTok 热销商品排行榜，帮助跨境电商卖家按日、周或月识别 TikTok 全球市场中的热销商品。

核心概念

TikTok 热销排行榜追踪 TikTok Shop 在全球 15 个市场中表现最佳的商品。它展示了商品在可配置的时间范围（日、周、月）内的销量、GMV 和增长率排名。这是 TikTok 电商选品、趋势分析和竞争情报的重要工具。

数据范围：该排行榜覆盖 15 个 TikTok Shop 市场，并通过 dateInfo 参数支持三种时间粒度——日、周和月。每个商品条目都包含销量、GMV、增长率、佣金率、店铺信息、类别等。

dateInfo 格式很重要：

• type: "day" -> value: "2025-02-01"（YYYY-MM-DD）
• type: "week" -> value: "2025-18"（year-weekNumber）
• type: "month" -> value: "2025-02"（year-month）

分页：结果采用分页形式。使用 page（页码，从 1 开始）和 pageSize（每页条目数，最大 10，默认 10）浏览结果集。

参数指南

参数	类型	必填	描述
region	string	是	市场地区代码（US、GB、MX、ES、DE、IT、FR、ID、VN、MY、TH、PH、BR、JP、SG）
dateInfo	object	是	日期指定，包含 type（day/week/month）和 value（参见上述格式）
category	string	否	英文类别名称，与 TikTok 类别 ID 匹配。非英文输入应先翻译
orderby	object	否	排序：field（units_sold/gmv/total_units_sold/total_gmv/growth_rate）+ order（desc/asc）。默认值：desc
page	integer	否	页码，默认值为 1
pageSize	integer	否	每页条目数，最大 10，默认值为 10

支持的市场

代码	市场
US	美国
GB	英国
MX	墨西哥
ES	西班牙
DE	德国
IT	意大利
FR	法国
ID	印度尼西亚
VN	越南
MY	马来西亚
TH	泰国
PH	菲律宾
BR	巴西
JP	日本
SG	新加坡

默认市场为 US。用户未指定市场时，请使用 US。

调用方式

• API 端点：POST /fastmoss/productRankTopSelling（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/fastmoss_product_rank_top_selling.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-fastmoss-product-rank-top-selling-<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/套餐到期/需充值/请充值"，或类似含义的内容。

使用示例

1. 美国今日热销商品（日榜） 查询美国市场某一天的数据，查看哪些商品销量领先。

region: "US", dateInfo: {"type": "day", "value": "2026-04-15"}

2. 英国周榜热销商品 查看英国市场每周表现最佳的商品。

region: "GB", dateInfo: {"type": "week", "value": "2026-15"}

3. 东南亚月榜 GMV 领先商品 查询印度尼西亚市场的月度热销商品，并按 GMV 排序。

region: "ID", dateInfo: {"type": "month", "value": "2026-03"}, orderby: {"field": "gmv", "order": "desc"}

4. 特定类别排行榜 查找特定类别中的热销商品。

region: "US", dateInfo: {"type": "day", "value": "2026-04-15"}, category: "Beauty"

数据字段（响应）

字段	API 名称	描述
商品标题	title	商品名称
商品 ID	productId	唯一商品标识符
区域	region	市场区域代码
价格	price	商品价格
最低价格	minPrice	最低价格；可选，仅价格区间商品包含此字段
最高价格	maxPrice	最高价格；可选，仅价格区间商品包含此字段
货币	currency	API 返回的货币符号或名称
总销量	totalSaleCnt	售出商品总数
1 日销量	totalSale1dCnt	过去 1 日的销量（当 dateType=day 时）
7 日销量	totalSale7dCnt	过去 7 日的销量（当 dateType=week 时）
30 日销量	totalSale30dCnt	过去 30 日的销量（当 dateType=month 时）
总 GMV	totalSaleGmvAmt	商品交易总额
1 日 GMV	totalSaleGmv1dAmt	过去 1 日的 GMV（当 dateType=day 时）
7 日 GMV	totalSaleGmv7dAmt	过去 7 日的 GMV（当 dateType=week 时）
30 日 GMV	totalSaleGmv30dAmt	过去 30 日的 GMV（当 dateType=month 时）
增长率	growthRate	销售增长率（百分比）
店铺名称	shopName	卖家店铺名称
店铺总销量	shopTotalUnitsSold	店铺售出的商品总数
店铺卖家 ID	shopSellerId	唯一店铺卖家标识符
类目名称	categoryName	商品类目
类目 ID	categoryIds	从第 1 级到第 3 级的类目 ID 路径
佣金率	productCommissionRate	以基点表示的佣金率（1000 = 10%）
图片 URL	imageUrl	商品图片 URL
封面 URL	coverUrl	商品封面图片 URL 列表
店铺头像	shopAvatar	店铺头像 URL
来源工具	sourceTool	来源工具标识符
来源类型	sourceType	商品来源类型
下架状态	offShelvesText	下架标识（"是" = 已下架，"否" = 正常销售）

顶层响应包含 errcode、errmsg、page、pageSize、total、products、columns、type 和 costTime。部分响应变体还可能包含 costToken、matchedCategoryIdPath 或 matchedCategoryNamePath；使用方应将这些字段视为可选字段。

显示规则

1. 仅展示数据：使用清晰的表格展示查询结果，不提供主观的商业建议
2. 增长率：增长率以百分比表示，显示时应加上 % 符号
3. 佣金率：佣金率以基点表示（1000 = 10%），显示时应转换为百分比
4. 货币注意事项：价格旁始终显示货币，因为不同市场使用的货币不同
5. dateInfo 格式：根据所选时间粒度验证并提醒用户使用正确的格式
6. 下架状态：offShelvesText 值为 "是" 表示已下架，为 "否" 表示正常销售；应向用户说明

重要限制

• dateInfo 为必填项：必须提供 type 和 value，且需符合特定格式要求
• 不支持关键词搜索：此工具不支持关键词搜索（如需搜索，请使用 linkfox-fastmoss-product-search）
• 每页最多 10 项：pageSize 参数不能超过 10
• 数据延迟：数据存在 T+1 统计延迟

用户表达与场景速查

适用——TikTok 畅销商品排名与趋势分析：

用户说法	场景
"What are the top selling products on TikTok"	畅销商品排名查询
"TikTok bestsellers this week", "hot products on TikTok Shop"	周榜／日榜查询
"TikTok GMV ranking", "highest revenue products on TikTok"	基于 GMV 的排名
"TikTok category hot sellers", "top selling beauty products on TikTok"	特定品类排名
"TikTok weekly product report", "monthly top sellers"	时间维度分析
"FastMoss top selling", "FastMoss ranking data"	直接提及数据来源
"Which products are growing fastest on TikTok"	按增长率排序的排名

不适用——需求超出 TikTok 畅销商品排名范围：

• Amazon 商品研究或 ABA 关键词数据
• TikTok 广告／广告活动管理
• TikTok 内容创作或视频编辑
• 商品评价或商品详情文案撰写
• TikTok 商品关键词搜索（请改用 linkfox-fastmoss-product-search）
• 利润率计算或定价策略

边界判断：用户提到“商品研究”或“哪些商品卖得好”时，如果上下文明确涉及 TikTok Shop 或 TikTok 电商排名，则适用此技能。如果用户询问的是 Amazon、Shopify 或其他平台，则不适用。如果用户想按关键词搜索商品，而不是浏览排名，请改用 linkfox-fastmoss-product-search。

算力消耗规则

消耗 11 算力。

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

反馈：

遇到以下任一情况时，请通过 Feedback API 自动检测并提交反馈：

1. 此技能所述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户对该技能表示不满或赞扬
4. 任何你认为可以改进的地方

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

---

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