← 返回 Skills 市场
linkfox-ai

FastMoss TikTok Product Search

作者 linkfox-ai · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
71
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install linkfox-fastmoss-product-search
功能描述
基于FastMoss数据搜索和筛选TikTok全球电商商品,支持关键词搜索、多维度筛选(类目、店铺类型、佣金率、销量、达人数等)和排序。当用户提到TikTok选品、TikTok商品搜索、TikTok产品数据、TikTok达人带货、TikTok佣金率、TikTok爆款追踪、TikTok GMV分析、TikTok p...
使用说明 (SKILL.md)

FastMoss - TikTok Product Search

This skill guides you on how to search and filter TikTok Shop product data using FastMoss, helping sellers and marketers discover product opportunities, evaluate sales performance, and identify influencer-driven products across 15 TikTok markets worldwide.

Core Concepts

FastMoss is a well-known TikTok e-commerce data platform that tracks product performance across multiple TikTok marketplaces. This tool provides keyword-based product search with rich filtering capabilities, returning detailed product data including multi-period sales (7-day/28-day/90-day/total), GMV (revenue), pricing, ratings, review counts, commission rates, influencer promotion statistics, and shop information.

Sales metrics: Products include multi-period sales data — 7-day, 28-day, 90-day, and total sales. The same granularity applies to GMV (Gross Merchandise Value) amounts.

Commission rate: Stored as a decimal (e.g., 0.10 means 10%). When displaying to the user, convert to percentage format.

Shop types: Products can be filtered by shop type — local shops (1) or cross-border shops (2). The isCrossBorder field (1=cross-border, 0=local) and isSShopText field (TikTok fully-managed shop) provide additional shop classification.

Parameter Guide

Search & Filtering

Parameter Type Required Description
keyword string No Search keyword (product title fuzzy match)
region string No Market region code. Supported: US, GB, MX, ES, DE, IT, FR, ID, VN, MY, TH, PH, BR, JP, SG
category string No Category name in English, matched to TikTok category ID. Non-English should be translated first
shopType integer No Shop type: 1=local shop, 2=cross-border shop

Boolean Filters

Parameter Type Required Description
isTopSelling boolean No Filter hot-selling products only
isNewListed boolean No Filter new products only
isSshop boolean No Filter TikTok fully-managed (S-shop) products only
isFreeShipping boolean No Filter free-shipping products only
isLocalWarehouse boolean No Filter local warehouse products only

Range Filters

Parameter Type Required Description
unitsSoldRange object No Sales volume range filter: {min, max}
commissionRateRange object No Commission rate range filter: {min, max}
creatorCountRange object No Creator/influencer count range filter: {min, max}

Sorting & Pagination

Parameter Type Required Description
orderField string No Sort field: day7_units_sold, day7_gmv, commission_rate, total_units_sold, total_gmv, creator_count. Default: descending
page integer No Page number, default 1
pageSize integer No Items per page, max 10, default 10

Supported Markets (15)

US (United States), GB (United Kingdom), MX (Mexico), ES (Spain), DE (Germany), IT (Italy), FR (France), ID (Indonesia), VN (Vietnam), MY (Malaysia), TH (Thailand), PH (Philippines), BR (Brazil), JP (Japan), SG (Singapore)

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_search.py directly to run queries.

Data Fields

Key fields returned for each product:

Field Description
title Product name
productId Unique product identifier
region Market region code
price, minPrice, maxPrice Product price and price range
currency Currency code
totalSaleCnt Total cumulative sales
totalSale1dCnt, totalSale7dCnt, totalSale28dCnt, totalSale90dCnt Sales by period
totalSaleGmvAmt, totalSaleGmv7dAmt, totalSaleGmv28dAmt GMV by period
totalVideoCnt, totalLiveCnt, totalIflCnt Video count, live count, influencer count
productCommissionRate Commission rate (decimal, 0.10 = 10%)
productRating, reviewCount Rating and review count
skuCount Number of SKUs
shopName, shopSellerId, shopTotalUnitsSold Shop information
isCrossBorder 1=cross-border, 0=local
isSShopText, freeShippingText Fully-managed shop flag, free shipping flag
salesTrendFlagText Sales trend label
categoryName Product category
tiktokUrl, fastmossUrl, imageUrl Links and image

Usage Examples

1. Basic Keyword Search — Find top-selling products

{
  "keyword": "phone case",
  "region": "US",
  "orderField": "total_units_sold",
  "pageSize": 10
}

2. High-Commission Product Discovery — Products with commission >= 10%

{
  "keyword": "beauty",
  "region": "US",
  "commissionRateRange": {"min": 0.10},
  "orderField": "commission_rate"
}

3. Cross-Border Shop Products — Filter by shop type

{
  "keyword": "gadget",
  "region": "US",
  "shopType": 2,
  "orderField": "day7_units_sold"
}

4. Influencer-Hot Products — Products promoted by many creators

{
  "keyword": "skincare",
  "region": "US",
  "creatorCountRange": {"min": 50},
  "orderField": "creator_count"
}

5. Hot-Selling New Products on TikTok

{
  "keyword": "fashion",
  "region": "GB",
  "isTopSelling": true,
  "isNewListed": true,
  "orderField": "day7_gmv"
}

Display Rules

  1. Present data only: Show query results in organized tables with key columns — product name, price, total sales, 7-day sales, GMV, rating, commission rate, and number of promoting influencers. Do not make subjective business advice
  2. Commission formatting: Commission rate is a decimal (0.10 = 10%) — always display as percentage for readability
  3. Cross-border awareness: isCrossBorder: 1 = cross-border shop, 0 = local shop. Display clearly
  4. Currency awareness: Include the currency field from the response when displaying prices and GMV
  5. Trend labels: Display salesTrendFlagText directly as the trend indicator
  6. Shop flags: Display freeShippingText and isSShopText directly (values are readable text)
  7. Error handling: When a query fails, explain the reason based on the response and suggest adjusting parameters

Important Limitations

  • No required parameters (all optional), but at minimum provide keyword or category for meaningful results
  • Max 10 items per page

Applicable Scenarios

User Says Scenario
"Find trending products on TikTok" Keyword search sorted by sales
"TikTok products with high commission" Filter by commission rate range
"What's selling well on TikTok Shop US" Regional product search by sales
"Search TikTok cross-border shop products" Filter by shopType=2
"Which products have many influencers promoting them" Filter by creator count range
"TikTok fully-managed shop products" Filter with isSshop=true
"TikTok product research for Southeast Asia" Search specific SE Asian regions
"New hot-selling products on TikTok" Use isTopSelling + isNewListed flags
"FastMoss product data" Direct platform reference

Not Applicable Scenarios

  • TikTok influencer/creator analytics (follower counts, engagement rates of creators)
  • TikTok video performance analytics (views, likes, shares on specific videos)
  • TikTok advertising / ad campaign management
  • Amazon, Shopee, or other non-TikTok platform product data
  • TikTok Shop store-level analytics
  • Product listing creation or optimization advice
  • Logistics, fulfillment, or shipping analysis

Boundary judgment: When users say "product research" or "what should I sell on TikTok", if it involves searching and filtering products by sales data, pricing, or commission rates on TikTok Shop, then this skill applies. If they're asking about content strategy, video creation, or influencer outreach, it does not apply.

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.

安全使用建议
Key points to check before installing: (1) This package expects a LINKFOXAGENT_API_KEY (used in the included script and API docs) but the skill metadata does not declare it — ask the publisher to declare required env vars and explain the key's scope. (2) The skill posts queries to https://tool-gateway.linkfox.com/fastmoss/productSearch and may optionally post feedback to https://skill-api.linkfox.com; verify you trust those domains and the vendor (there is no homepage or verified owner). (3) Prefer issuing an API key scoped to this skill (or a temporary/test key) rather than reusing broad or production credentials. (4) Inspect and run the bundled script locally to confirm behavior; it exits if the key is missing and only sends requests to the documented endpoints. (5) If provenance is unclear (unknown source/owner), consider not providing real credentials or running inside a restricted environment until you can verify the publisher and privacy terms.
功能分析
Type: OpenClaw Skill Name: linkfox-fastmoss-product-search Version: 1.0.0 The skill bundle is a legitimate tool for searching TikTok product data via the FastMoss platform. The Python script (fastmoss_product_search.py) and documentation (SKILL.md, api.md) describe a standard API integration that uses environment variables for authentication and communicates with a dedicated gateway (tool-gateway.linkfox.com). No evidence of malicious behavior, data exfiltration, or harmful instructions was found.
能力标签
requires-sensitive-credentials
能力评估
Purpose & Capability
The name/description (TikTok product search via FastMoss) matches the code and API docs: the skill calls https://tool-gateway.linkfox.com/fastmoss/productSearch and returns product data. However, the skill metadata declares no required environment variables or primary credential while the included documentation and script require an API key (LINKFOXAGENT_API_KEY). This omission is an inconsistency that should be clarified.
Instruction Scope
SKILL.md and references/api.md limit runtime actions to building a JSON request and POSTing it to the LinkFox tool-gateway API (and optionally a separate feedback endpoint). The instructions do not ask the agent to read unrelated system files or exfiltrate arbitrary data. They do instruct running the bundled Python script or performing curl requests.
Install Mechanism
There is no install spec (instruction-only with a small helper script). Nothing is downloaded or installed automatically, which reduces risk. The included Python script is simple and calls an external HTTPS API.
Credentials
The skill requires an API key at runtime (LINKFOXAGENT_API_KEY) according to both references/api.md and scripts/fastmoss_product_search.py, but the skill metadata lists no required env vars or primary credential. Requiring an API key for the LinkFox gateway is reasonable for this purpose, but the missing declaration is a problematic mismatch and prevents proper permission review. Also note that the API key grants the skill the ability to query the external service — users should confirm what that key can do and avoid supplying broader credentials.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide settings, and does not attempt to persist credentials on its own. Autonomous invocation is allowed (platform default) but not combined with other high privileges.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install linkfox-fastmoss-product-search
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /linkfox-fastmoss-product-search 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release
元数据
Slug linkfox-fastmoss-product-search
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

FastMoss TikTok Product Search 是什么?

基于FastMoss数据搜索和筛选TikTok全球电商商品,支持关键词搜索、多维度筛选(类目、店铺类型、佣金率、销量、达人数等)和排序。当用户提到TikTok选品、TikTok商品搜索、TikTok产品数据、TikTok达人带货、TikTok佣金率、TikTok爆款追踪、TikTok GMV分析、TikTok p... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 71 次。

如何安装 FastMoss TikTok Product Search?

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

FastMoss TikTok Product Search 是免费的吗?

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

FastMoss TikTok Product Search 支持哪些平台?

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

谁开发了 FastMoss TikTok Product Search?

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

💬 留言讨论