linkfox-fastmoss-top-selling

FastMoss - TikTok 畅销商品排行榜

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

核心概念

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

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

dateInfo 格式很重要：

• 类型："day" -> 值："2025-02-01"（YYYY-MM-DD）
• 类型："week" -> 值："2025-18"（年-周数）
• 类型："month" -> 值："2025-02"（年-月）

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

参数指南

参数	类型	必填	说明
region	string	是	市场区域代码（US、GB、MX、ES、ID、VN、MY、TH、PH）
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	西班牙
ID	印度尼西亚
VN	越南
MY	马来西亚
TH	泰国
PH	菲律宾

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

API 用法

此工具调用 LinkFox 工具网关 API。调用约定、请求参数和响应结构请参见 references/api.md。你也可以直接运行 scripts/fastmoss_product_rank_top_selling.py 来执行查询。

使用示例

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	货币代码
总销量	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	产品类别
佣金率	productCommissionRate	以基点为单位的佣金率（1000 = 10%）
图片 URL	imageUrl	产品图片 URL
下架状态	offShelvesText	下架标志（“是” = 已下架，“否” = 正常）

显示规则

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。

反馈：

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

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

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

处理大型响应

为避免占满 Agent 上下文，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/fastmoss_product_rank_top_selling.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

请将 --out-dir 指定在任何 git 工作树之外（例如，在 Unix 上使用 /tmp/...，在 Windows 上使用 %TEMP%/...）。保存的响应可能包含个人身份信息、定价或敏感认证数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并仅输出架构预览和文件路径。read 会筛选特定字段，并通过 --limit/--offset 分段读取，通过 --format json|jsonl|csv|table 指定输出格式。

适合采用此模式的情况——请根据响应特征自行判断，例如：

• 每条记录包含大量字段，或包含你不需要的字段
• 批量／分页结果（每次调用返回多个条目）
• 长文本字段（描述、评论、HTML、时间序列）
• 输出将在后续步骤中重复使用，而不是立即处理

对于较小且只使用一次的响应，直接调用主脚本即可。

⚠️ 预览内容是经过截断的架构和样例，并非完整数据。任何字段级决策都必须通过 read 从保存的文件中读取。

---

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