前言¶

做 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