SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-fastmoss-product-rank-top-selling

linkfox-fastmoss-product-rank-top-selling

营销与增长

查看项目

更新于 10-15 09:29

技能介绍

FastMoss - TikTok Top Selling Rankings 是一个面向跨境电商卖家的数据查询技能，用于通过 FastMoss 数据源查询和分析 TikTok 全球电商市场的热销商品排行榜，帮助卖家按日、周、月或类目维度识别爆款商品，辅助选品与趋势分析。

【用途】 该技能用于查询 TikTok Shop 覆盖 15 个全球市场中的热销商品表现，展示在可配置时间窗口（日、周、月）内销量、GMV、增长率领先的商品，是 TikTok 电商选品、趋势分析和竞品情报的工具。

【主要能力】

  • 数据范围：覆盖 15 个 TikTok Shop 市场，支持日、周、月三种时间粒度，通过 dateInfo 参数指定。
  • 每条商品记录包含：商品标题、商品 ID、地区、价格（含最低价/最高价）、货币、总销量、按时间维度的销量（1 日/7 日/30 日）、总 GMV、按时间维度的 GMV、增长率、店铺名称、店铺总销量、店铺卖家 ID、类目名称、类目 ID 路径、佣金率、商品图片 URL、封面 URL 列表、店铺头像、来源工具、来源类型、下架状态等。
  • 支持按销量、GMV、增长率等字段排序，支持分页。
  • 支持按类目筛选（类目名称需为英文）。

【参数说明】

  • region（必填，字符串）：市场地区代码，可选 US、GB、MX、ES、DE、IT、FR、ID、VN、MY、TH、PH、BR、JP、SG。未指定时默认 US。
  • dateInfo（必填，对象）：日期规格，含 type（day/week/month）与 value，格式要求：type 为 day 时 value 形如 "2025-02-01"（YYYY-MM-DD）；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。

【使用方式】

  • 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 只输出摘要；加 --inline 可强制全量打印到 stdout（同样落盘）。
  • 读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

【认证与算力】 出现以下异常时按 references/onboarding.md 引导处理：未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 未配置）、响应 401 或 402 状态码、响应提示算力或余额不足（如"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"等）。 单次调用消耗 11 算力。用户会因算力消耗而支付费用，当需要高频调用或用户对算力消耗预期不足时，应提醒用户并由用户决定是否继续。

【适用场景】

  • TikTok 热销商品排行与趋势分析。
  • 按日/周/月查询热销榜、爆品排行。
  • 按 GMV 排序查询高营收商品。
  • 按类目查询热销商品（如美妆类）。
  • 用增长率排序查询增长最快的商品。
  • 直接引用 FastMoss 排行榜数据。

【限制】

  • dateInfo 为必填，type 与 value 均需按指定格式提供。
  • 不支持关键词搜索（应改用 linkfox-fastmoss-product-search）。
  • 每页最多 10 条，pageSize 不可超过 10。
  • 数据存在 T+1 统计延迟。
  • 不适用于 Amazon 选品、ABA 关键词数据、TikTok 广告投放管理、内容创作与视频剪辑、商品评论或 listing 文案、利润率计算与定价策略等。