前言¶

做 TikTok Shop 选品或竞品跟踪时，榜单数据往往散落在 ERP 后台或手工导出的表格里。你在对话里问「美国站 Beauty 类目昨天卖什么最好」，Agent 若没有对接 4seller 的销售排行接口，只能泛泛建议去后台点报表。下面介绍 SkillHub 上的 tiktok 热销榜（4seller）：把 4seller 热销榜能力封装成可被 Agent 调用的技能与 OpenClaw 插件，用统一参数查榜、标数据来源，并支持定时拉取摘要。

这是什么¶

tiktok 热销榜（4seller） 是 SkillHub 社区技能，坐标 @user_bd447e33/4seller-tk-sourcing，当前版本 1.0.0，分类 business-ops，发布者 user_bd447e33，来源 community。SkillHub 页面标注 requires_api_key=true（需配置 4seller API 密钥）。

技能包本质是 4seller TKSourcing Plugin（npm 包名 @4seller/openclaw-tiktok-plugin）：面向 TikTok 卖家，通过 4seller 销售排行榜接口获取热销商品数据，并在 Agent 侧提供查询说明与工具约定。

官方入口：

• API 地址：https://api.skillhub.cn/user_bd447e33/4seller-tk-sourcing
• SkillHub 页面：https://www.skillhub.cn/skills/user_bd447e33/4seller-tk-sourcing

（SkillHub 统计：评分 100000，下载 1429，安装 10。）

核心功能¶

技能包内包含两个子技能，能力以官方 SKILL.md 为准。

获取爆款商品（tiktok-hot-products）¶

在用户需要查看 TikTok 热销商品、销售排行榜、按市场或类目查榜时触发。Agent 通过工具 tiktok_hot_products 拉取排行榜；查询前可用 tiktok_l1_categories 按站点（如 US）获取一级类目列表，再填入 category。

主要查询维度：

1. 市场：region（必填，如 US）
2. 类目：category（可选，对应 ERP 的 pcname）
3. 周期：dateRange 为 day / 7d / 30d
4. 归属日期：dateValue，格式 YYYYMMDD；日榜有 T+2 延迟说明
5. 排序：sortBy 为 sales / revenue / growth
6. 条数：limit（默认 10）

成功返回会标准化商品列表（含排名、标题、店铺、销量、收入、增长率、商品链接等），并应尽量带上 callTime、source，回复用户时必须引用数据来源。

定时任务（tiktok-cron）¶

说明如何在 OpenClaw 上用 openclaw cron 定时发送消息，由 Agent 再调用 tiktok_hot_products。内置推荐任务名 tiktok-hot-products-daily（示例 cron：15 9 * * *，时区 Asia/Shanghai）。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

按 SkillHub 安装文档 检查或安装 CLI：

command -v skillhub && skillhub --version

未安装时可执行完整安装脚本（文档中的推荐方式）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安装本技能到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前客户端识别的 skills 路径，否则默认落在 ./skills/ 可能不会被加载。文档中的常见路径示例：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

搜索与安装命令（与 skillhub search 输出一致）：

skillhub search 4seller

skillhub install 4seller-tk-sourcing --namespace user_bd447e33 --dir ~/.cursor/skills/

也可把下面提示词发给 Agent，让其按官方安装说明处理：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_bd447e33/4seller-tk-sourcing`。

3. 在 OpenClaw 中配置插件与 API Key¶

实际 HTTP 请求由 OpenClaw 插件完成（peerDependencies 要求 openclaw >= 2026.3.23）。在 openclaw.json 的 plugins.entries 下启用 4seller-tk-sourcing，并填写密钥与接口地址：

{
  "plugins": {
    "entries": {
      "4seller-tk-sourcing": {
        "enabled": true,
        "config": {
          "apiKey": "your-api-key",
          "apiBaseUrl": "https://beta.4seller.com/api/listing/tiktok/sale-rank-by-tk-api",
          "requestTimeoutMs": 10000
        }
      }
    }
  }
}

配置项含义：

• apiKey：4seller API 密钥，请求头 X-Api-Key
• apiBaseUrl：销售排行接口基础地址；文档亦提到可配置为 https://4seller.com 对应接口
• requestTimeoutMs：超时毫秒数，默认 10000

未配置有效 apiKey 时，工具可能返回类似「认证失败，请检查 API key 是否正确」的错误。

典型用法¶

先查类目，再查热销榜¶

第一步，获取美国站一级类目：

{
  "tool_calls": [
    {
      "name": "tiktok_l1_categories",
      "arguments": {
        "site": "US"
      }
    }
  ]
}

第二步，按市场、类目、日榜查询前 10 条（按销量排序）：

{
  "tool_calls": [
    {
      "name": "tiktok_hot_products",
      "arguments": {
        "region": "US",
        "category": "Beauty",
        "dateRange": "day",
        "dateValue": 20260415,
        "limit": 10,
        "sortBy": "sales"
      }
    }
  ]
}

用户未指定类目时，技能要求同时提醒：可通过 tiktok_l1_categories 获取完整类目后再筛选。

自然语言触发示例¶

在已安装技能且 OpenClaw 插件配置完成后，可直接用口语需求，例如：

• 「查一下 US 市场 Automotive & Motorcycle 类目日榜热销前 20，按销售额排序。」
• 「用 7d 周期看 Beauty 类目增长最快的商品。」

回复中应注明数据来源，例如：US Beauty，2026-04-16 10:30，来自于 TikTok 热销品接口（以接口返回的 callTime、source 为准）。

每日定时摘要（OpenClaw）¶

配置好插件后，可参考技能内推荐命令添加 cron（消息内容可按市场、类目改写）：

openclaw cron add \
  --name "tiktok-hot-products-daily" \
  --cron "15 9 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "请调用 tiktok_hot_products，查询 US 市场 Beauty 类目 day 热销品，返回前10条摘要，并注明 callTime 和 source。"

cron 只负责定时发消息；查询逻辑仍由 tiktok_hot_products 执行。安装前建议先手动跑通一次参数。

适用场景与注意¶

适合谁

• 已使用或计划使用 4seller ERP、并持有销售排行相关 API Key 的 TikTok Shop 运营、选品、数据分析角色
• 已在 OpenClaw（或兼容其插件体系的 Agent 运行时）中工作，希望把「问榜单」变成对话或定时任务

限制与注意

1. 依赖外部接口：需自行申请 4seller API key；空列表不算错误，但需区分「无数据」与「认证失败」。
2. 数据延迟：日榜等存在 T+2 等延迟说明，定时任务默认日期应按文档理解，避免把「今天」误解为最新可查日。
3. 运行环境：技能文档与 package.json 均围绕 OpenClaw 插件；仅用 SkillHub 把 Markdown 装进 Cursor/Codex 目录，若不加载对应插件，Agent 只有操作说明、无法真正调用 tiktok_hot_products。
4. 接口字段：插件按 sale-rank 真实响应处理 code === 0、data.records 等；展示时 total 为查询条件下总记录数，不一定等于本次 items 条数。

结尾¶

tiktok 热销榜（4seller） 把 4seller TikTok 销售排行榜接到 Agent 工具链：参数化的 tiktok_hot_products、类目辅助查询，以及可选的 OpenClaw 定时摘要。选品讨论若需要可核对的榜单与明确数据来源，可按上文完成 SkillHub 安装、OpenClaw 插件配置与 API Key 申请。

官方地址：https://api.skillhub.cn/user_bd447e33/4seller-tk-sourcing
SkillHub 页面：https://www.skillhub.cn/skills/user_bd447e33/4seller-tk-sourcing