← 返回 Skills 市场
linkfox-ai

FastMoss TikTok Top Selling

作者 linkfox-ai · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
71
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install linkfox-fastmoss-top-selling
功能描述
通过FastMoss数据查询TikTok全球电商市场的热销商品排行榜,支持按日/周/月维度和类目维度分析。当用户提到TikTok热销榜、TikTok爆品排行、TikTok销量排行、TikTok GMV排名、TikTok类目热销、TikTok选品周报、TikTok top-selling rankings, Tik...
使用说明 (SKILL.md)

FastMoss - TikTok Top Selling Rankings

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.

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.

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

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.

API Usage

This tool calls the LinkFox tool gateway API. See references/api.md for calling conventions, request parameters, and response structure. You can also execute scripts/fastmoss_product_rank_top_selling.py directly to run queries.

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"

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)

Display Rules

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

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

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.

Feedback:

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

  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. 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.

安全使用建议
This skill appears to do what it says (query FastMoss/LinkFox for TikTok top-selling products), but it requires an API key (LINKFOXAGENT_API_KEY) that is not declared in the registry metadata. Before installing or enabling it: (1) confirm you trust the endpoints tool-gateway.linkfox.com and skill-api.linkfox.com; (2) do not provide your API key unless you understand where it is used and stored—this script reads it from the environment and sends it in the Authorization header; (3) ask the skill author/registry to update metadata to declare LINKFOXAGENT_API_KEY as a required credential and to document any retention or telemetry; (4) if in doubt, test in an isolated environment or with a limited/rotatable API key. If you expect automated feedback submission, request explicit opt-in and a clear privacy statement.
功能分析
Type: OpenClaw Skill Name: linkfox-fastmoss-top-selling Version: 1.0.0 The skill bundle is designed to query TikTok top-selling product data via the FastMoss API. The Python script (fastmoss_product_rank_top_selling.py) uses standard libraries to make authorized POST requests to a legitimate tool gateway, and the instructions in SKILL.md are consistent with the stated purpose of e-commerce data analysis.
能力标签
requires-sensitive-credentials
能力评估
Purpose & Capability
The skill's code and SKILL.md consistently describe calling LinkFox/FastMoss endpoints to fetch TikTok top-selling rankings, which is coherent with the skill name and description. However, the skill actually requires an API key (LINKFOXAGENT_API_KEY) to call the tool-gateway, but the registry metadata lists no required environment variables or primary credential. That mismatch is unexpected and incoherent.
Instruction Scope
Runtime instructions and the included script remain within the stated scope: they validate dateInfo, build a JSON request, and POST to https://tool-gateway.linkfox.com/fastmoss/productRankTopSelling. The API reference also documents a separate feedback endpoint (https://skill-api.linkfox.com/api/v1/public/feedback); the docs contain example feedback payloads but do not automatically exfiltrate user data. Still, any path that sends user-provided content to an external feedback endpoint should be noted and reviewed by the user.
Install Mechanism
This is an instruction-only skill with a small helper script; there is no install specification and nothing is downloaded or written to disk by an installer. Risk from install mechanism is low.
Credentials
The script and api.md clearly require LINKFOXAGENT_API_KEY in the environment for Authorization, but the skill's declared requirements list no environment variables or primary credential. Asking for a single API key is proportionate to the described network calls, but the omission from metadata is an important inconsistency: users may not realize they must provide this credential nor understand how it will be used or stored.
Persistence & Privilege
The skill does not request permanent 'always' inclusion, does not modify other skills or system settings, and contains no installer that persists components. Agent autonomous invocation is allowed (platform default) but not by itself a red flag here.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install linkfox-fastmoss-top-selling
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /linkfox-fastmoss-top-selling 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release
元数据
Slug linkfox-fastmoss-top-selling
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

FastMoss TikTok Top Selling 是什么?

通过FastMoss数据查询TikTok全球电商市场的热销商品排行榜,支持按日/周/月维度和类目维度分析。当用户提到TikTok热销榜、TikTok爆品排行、TikTok销量排行、TikTok GMV排名、TikTok类目热销、TikTok选品周报、TikTok top-selling rankings, Tik... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 71 次。

如何安装 FastMoss TikTok Top Selling?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install linkfox-fastmoss-top-selling」即可一键安装,无需额外配置。

FastMoss TikTok Top Selling 是免费的吗?

是的,FastMoss TikTok Top Selling 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

FastMoss TikTok Top Selling 支持哪些平台?

FastMoss TikTok Top Selling 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 FastMoss TikTok Top Selling?

由 linkfox-ai(@linkfox-ai)开发并维护,当前版本 v1.0.0。

💬 留言讨论