linkfox-fastmoss-product-rank-top-selling

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

FastMoss - TikTok Top Selling Rankings

FastMoss - TikTok热销商品排行榜

This skill guides you on how to query and analyze the TikTok top selling product rankings via the FastMoss data source, helping cross-border e-commerce sellers identify hot-selling products across TikTok's global markets by day, week, or month.

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

Core Concepts

核心概念

The TikTok Top Selling Ranking tracks the best-performing products on TikTok Shop across 9 global markets. It reveals which products are leading in sales volume, GMV, and growth rate over configurable time windows (daily, weekly, monthly). This is an essential tool for product scouting, trend analysis, and competitive intelligence in TikTok e-commerce.

Data scope: The ranking covers 9 TikTok Shop markets and supports three time granularities — day, week, and month — via the

dateInfo

parameter. Each product entry includes sales volume, GMV, growth rate, commission rate, shop information, category, and more.

dateInfo format is important:

type:
```
"day"
```
-> value:
```
"2025-02-01"
```
(YYYY-MM-DD)
type:
```
"week"
```
-> value:
```
"2025-18"
```
(year-weekNumber)
type:
```
"month"
```
-> value:
```
"2025-02"
```
(year-month)

Pagination: Results are paginated. Use

page

(page number, starting from 1) and

pageSize

(items per page, max 10, default 10) to navigate through the result set.

TikTok热销商品排行榜追踪TikTok Shop在9个全球市场中表现最佳的商品，展示在可配置的时间窗口（日、周、月）内销量、GMV和增长率领先的商品。这是TikTok电商领域中选品、趋势分析和竞品情报的必备工具。

数据范围：排行榜覆盖9个TikTok Shop市场，支持三种时间粒度——日、周、月，通过

dateInfo

参数配置。每个商品条目包含销量、GMV、增长率、佣金率、店铺信息、类目等内容。

dateInfo格式很重要：

type:
```
"day"
```
-> value:
```
"2025-02-01"
```
（YYYY-MM-DD格式）
type:
```
"week"
```
-> value:
```
"2025-18"
```
（年份-周数格式）
type:
```
"month"
```
-> value:
```
"2025-02"
```
（年份-月份格式）

分页机制：结果采用分页展示。使用

page

（页码，从1开始）和

pageSize

（每页条目数，最大10，默认10）来浏览结果集。

Parameter Guide

参数指南

Parameter	Type	Required	Description
region	string	Yes	Market region code (US, GB, MX, ES, ID, VN, MY, TH, PH)
dateInfo	object	Yes	Date specification with `type` (day/week/month) and `value` (see format above)
category	string	No	Category name in English, matched to TikTok category ID. Non-English input should be translated first
orderby	object	No	Sorting: `field` (units_sold/gmv/total_units_sold/total_gmv/growth_rate) + `order` (desc/asc). Default: desc
page	integer	No	Page number, default 1
pageSize	integer	No	Items per page, max 10, default 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

Supported Markets

支持的市场

Code	Market
US	United States
GB	United Kingdom
MX	Mexico
ES	Spain
ID	Indonesia
VN	Vietnam
MY	Malaysia
TH	Thailand
PH	Philippines

Default market is US. Use US when the user does not specify a market.

代码	市场
US	美国
GB	英国
MX	墨西哥
ES	西班牙
ID	印度尼西亚
VN	越南
MY	马来西亚
TH	泰国
PH	菲律宾

默认市场为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 进入上下文。

API 端点：

POST /fastmoss/productRankTopSelling

（完整参数/响应/错误码见

references/api.md

）

Python 脚本：

python scripts/fastmoss_product_rank_top_selling.py '<JSON 参数>' [--inline]

成本限制：本工具会消耗积分；同一会话同一参数组合默认仅调用一次，脚本带有24小时本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时，需先向用户说明会产生额外消耗。

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

始终将完整响应写入
```
<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：写入文件后标准输出仅打印摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度 + 前3条样本）
添加
```
--inline
```
参数可强制将全量内容打印到标准输出（同时仍会写入文件）

读数据建议：先查看摘要判断是否满足需求；需要具体字段时优先使用

jq

或

ConvertFrom-Json

从保存的JSON文件中按需抽取，避免整份JSON进入上下文。

解决认证和积分问题

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

发生以下异常情况时，参考references/onboarding.md引导解决：

异常情况

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

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

Usage Examples

使用示例

1. Today's top selling products in the US (daily) Query the US market for a specific day to see which products lead in sales.

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

2. Weekly top sellers in the UK Check the UK market for weekly best-performing products.

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

3. Monthly GMV leaders in Southeast Asia Scout the Indonesian market for monthly top sellers sorted by GMV.

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

4. Category-specific ranking Find top selling products in a specific category.

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

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"

Data Fields (Response)

数据字段（响应）

Field	API Name	Description
Product Title	title	Name of the product
Product ID	productId	Unique product identifier
Region	region	Market region code
Price	price	Product price
Min Price	minPrice	Lowest price
Max Price	maxPrice	Highest price
Currency	currency	Currency code
Total Sales	totalSaleCnt	Total units sold
1-Day Sales	totalSale1dCnt	Units sold in the last 1 day (when dateType=day)
7-Day Sales	totalSale7dCnt	Units sold in the last 7 days (when dateType=week)
30-Day Sales	totalSale30dCnt	Units sold in the last 30 days (when dateType=month)
Total GMV	totalSaleGmvAmt	Total gross merchandise value
1-Day GMV	totalSaleGmv1dAmt	GMV in the last 1 day (when dateType=day)
7-Day GMV	totalSaleGmv7dAmt	GMV in the last 7 days (when dateType=week)
30-Day GMV	totalSaleGmv30dAmt	GMV in the last 30 days (when dateType=month)
Growth Rate	growthRate	Sales growth rate (percentage)
Shop Name	shopName	Name of the seller's shop
Shop Total Units Sold	shopTotalUnitsSold	Total units sold by the shop
Shop Seller ID	shopSellerId	Unique shop seller identifier
Category Name	categoryName	Product category
Commission Rate	productCommissionRate	Commission rate in basis points (1000 = 10%)
Image URL	imageUrl	Product image URL
Delisted Status	offShelvesText	Delisted indicator ("是" = delisted, "否" = active)

字段	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天成交总额（当dateType=day时）
7天GMV	totalSaleGmv7dAmt	过去7天成交总额（当dateType=week时）
30天GMV	totalSaleGmv30dAmt	过去30天成交总额（当dateType=month时）
增长率	growthRate	销量增长率（百分比）
店铺名称	shopName	卖家店铺名称
店铺总销量	shopTotalUnitsSold	店铺累计销量
店铺卖家ID	shopSellerId	店铺卖家唯一标识
类目名称	categoryName	商品类目
佣金率	productCommissionRate	佣金率（基点，1000=10%）
图片URL	imageUrl	商品图片链接
下架状态	offShelvesText	下架标识（"是"=已下架，"否"=在售）

Display Rules

展示规则

Present data only: Show query results in clear tables without subjective business advice
Growth rate: Growth rate is in percentage -- show with % sign
Commission rate: Commission rate is in basis points (1000 = 10%) -- convert to percentage for display
Currency awareness: Always display currency alongside prices since different markets use different currencies
dateInfo format: Validate and remind users of the correct format for the selected time granularity
Delisted status:
```
offShelvesText
```
value "是" means delisted, "否" means active -- clarify this for users

仅展示数据：以清晰表格形式呈现查询结果，不提供主观商业建议
增长率：增长率为百分比形式——需添加%符号展示
佣金率：佣金率为基点（1000=10%）——需转换为百分比形式展示
货币标识：价格需始终附带货币标识，因为不同市场使用不同货币
dateInfo格式：验证并提醒用户所选时间粒度的正确格式
下架状态：
```
offShelvesText
```
值为"是"表示已下架，"否"表示在售——需向用户说明此含义

Important Limitations

重要限制

dateInfo is mandatory: Both
```
type
```
and
```
value
```
must be provided with specific format requirements
No keyword search: This tool does NOT support keyword search (use linkfox-fastmoss-product-search for that)
Max 10 items per page: The
```
pageSize
```
parameter cannot exceed 10
Data delay: Data has T+1 statistical delay

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

User Expression & Scenario Quick Reference

用户表达与场景速查

Applicable -- TikTok top selling product rankings and trend analysis:

User Says	Scenario
"What are the top selling products on TikTok"	Top selling ranking lookup
"TikTok bestsellers this week", "hot products on TikTok Shop"	Weekly/daily ranking query
"TikTok GMV ranking", "highest revenue products on TikTok"	GMV-based ranking
"TikTok category hot sellers", "top selling beauty products on TikTok"	Category-specific ranking
"TikTok weekly product report", "monthly top sellers"	Time-dimension analysis
"FastMoss top selling", "FastMoss ranking data"	Direct data source reference
"Which products are growing fastest on TikTok"	Growth rate sorted ranking

Not applicable -- Needs beyond TikTok top selling rankings:

Amazon product research or ABA keyword data
TikTok advertising / ad campaign management
TikTok content creation or video editing
Product reviews or listing copywriting
TikTok product keyword search (use linkfox-fastmoss-product-search instead)
Profit margin calculations or pricing strategy

Boundary judgment: When users say "product research" or "what's selling well", if the context clearly involves TikTok Shop or TikTok e-commerce rankings, this skill applies. If they are asking about Amazon, Shopify, or other platforms, it does not apply. If they want to search products by keyword rather than browse rankings, use linkfox-fastmoss-product-search instead.

适用场景——TikTok热销商品排名及趋势分析：

用户表述	场景
"TikTok上的热销商品有哪些"	热销排名查询
"本周TikTok爆款商品"、"TikTok Shop热门商品"	周/日维度排名查询
"TikTok GMV排名"、"TikTok上营收最高的商品"	基于GMV的排名查询
"TikTok类目热销商品"、"TikTok上热销的美妆产品"	特定类目排名查询
"TikTok选品周报"、"月度热销商品"	时间维度分析
"FastMoss热销排名"、"FastMoss排名数据"	直接引用数据源
"TikTok上哪些商品增长最快"	按增长率排序的排名查询

不适用场景——超出TikTok热销排名范围的需求：

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

边界判断：当用户提及“选品”或“什么卖得好”时，若上下文明确涉及TikTok Shop或TikTok电商排名，则适用本技能；若涉及Amazon、Shopify或其他平台，则不适用。若用户希望通过关键词搜索商品而非浏览排名，请使用linkfox-fastmoss-product-search。

积分消耗规则

消耗 11 积分。

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

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.

消耗11积分。

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

反馈机制：

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

本技能描述的功能或用途与实际行为不符
技能结果与用户意图不匹配
用户表达对本技能的不满或赞扬
任何你认为可以改进的内容

按照

references/api.md

中的指定方式调用反馈API，请勿中断用户流程。

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