ecommerce.tiktok-top-selling-products

用途

本技能用于查询和分析 TikTok 全球电商市场的畅销商品排行榜，数据来源于 FastMoss，帮助跨境卖家和运营人员在 TikTok Shop 各市场中识别热销商品，开展选品、趋势分析和竞品情报工作。

多市场覆盖：共 15 个 TikTok Shop 市场，包括美国（US）、英国（GB）、墨西哥（MX）、西班牙（ES）、德国（DE）、意大利（IT）、法国（FR）、印尼（ID）、越南（VN）、马来西亚（MY）、泰国（TH）、菲律宾（PH）、巴西（BR）、日本（JP）、新加坡（SG）；未指定市场时默认美国。
三种时间粒度：通过 dateInfo 参数指定日、周、月。格式要求：日 {"type":"day","value":"2025-02-01"}；周 {"type":"week","value":"2025-18"}；月 {"type":"month","value":"2025-02"}。
类目筛选：category 参数接收英文类目名并匹配 TikTok 类目 ID，非英文需先翻译。
排序：orderby 支持按 units_sold、gmv、total_units_sold、total_gmv、growth_rate 排序，方向为 desc/asc，默认 desc。
分页：page 从 1 开始，pageSize 最大 10，默认 10。
返回字段：商品标题、商品 ID、区域、价格/最低价/最高价、币种、总销量、对应时间窗口销量（1 日/7 日/30 日）、总 GMV 及对应窗口 GMV、增长率、店铺名、店铺总销量、店铺卖家 ID、类目名、佣金率（基点，1000=10%）、图片 URL、下架状态。

API 端点：POST /fastmoss/productRankTopSelling。
Python 脚本：python scripts/tiktok_top_selling_products.py '<JSON 参数>' [--inline]。
鉴权：需设置环境变量 NEXSCOPE_API_KEY，可在 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 管理积分。
输出策略：完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-fastmoss-product-rank-top-selling-<timestamp>.json；响应不超过 8 KB 时打印完整 JSON，超过 8 KB 时仅输出摘要；加 --inline 可强制完整输出。<session> 取自 SESSION_ID 环境变量；当前目录不可写时报错。
成本约束：工具消耗积分，同一会话中相同参数组合默认只调用一次，脚本内本地缓存 24 小时；失败或空结果时不会自动更换关键词、翻页或筛选条件重试，需要额外查询前应先告知用户。

查询 TikTok 畅销榜、日/周/月热销商品、GMV 排名、类目热销商品、按增长率排序的上升商品，以及生成周度或月度商品报告。当语境明确涉及 TikTok Shop 或 TikTok 电商排行榜时适用；涉及 Amazon、Shopify 等其他平台则不适用。