TikTok 商品排行榜 | Qinghu AI

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install qinghu-tiktok-product-rank
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 qinghu-tiktok-product-rank。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

TikTok Product Rankings 是一款 Openclaw Skills 工具，可按市场、类别和日期获取 TikTok Shop 畅销商品和热门商品列表。它通过 qhkit mcp 调用 Qinghu Data 的 tiktok_product_ranklist 工具，返回每日、每周或每月的排行榜数据，以及所选周期内的增长情况。
可使用它回答商品发现类问题，例如某个 TikTok Shop 市场中哪些商品销量最好，或某个类别中哪些商品正在走红。该技能负责处理排行榜参数和数据获取，但在付费调用前需要用户授权。无需在宿主环境中另行查找或配置 MCP 服务器。

应用场景

查找指定市场和日期、周或月份内 TikTok Shop 的畅销商品。
获取某个地区或商品类别的热门商品排行榜。
使用分页请求排行榜列表，例如前 100 名商品。
在明确指定市场、报告周期和样本量的情况下比较商品表现。
使用相关的
tiktok_search_items
工具根据类别名称查找类别 ID，而不是猜测 ID。

工作原理

确认用户要求的地区、排行榜周期、日期、排行榜类型和任何类别筛选条件。缺少必要信息时请用户补充；不要猜测。
如果用户提供了类别名称但没有 ID，请将搜索词翻译成目标市场的语言，并使用 tiktok_search_items 获取类别数据和匹配的 ID。
使用 qhkit mcp describe 检查最新工具架构和输入要求。使用 qhkit mcp estimate 检查当前基础积分估算。
在会话中首次进行付费工具调用前，说明将使用哪个工具、工具的用途以及预估积分。仅在用户同意后调用。
将排行榜日期设为 yyyy-MM-dd 格式。对于“最新”“今天”或“本周”等请求，使用最近一个已完成且可用的报告周期：每日排行榜使用昨天，每周排行榜使用上一周的星期一，每月排行榜使用上个月的第一天。
使用已确认的参数调用 tiktok_product_ranklist。排行榜字段 1 表示按总销量计的畅销商品；2 表示按达人总数计的热门商品。排行榜类型 1 为每日，2 为每周，3 为每月。
解读 JSON 结果。先总结结论，为数据标明平台、地区、周期和样本量；结果集较大时提供文件，而不是在聊天中复述完整数据集。

配置指南

此技能使用 qhkit CLI，并要求 Node.js 18 或更高版本。mcp 命令要求 qhkit 0.14.0 或更高版本。无需单独配置宿主环境中的 MCP 服务器。
检查是否已安装并配置 qhkit：
qhkit config show
如果缺少 qhkit，请全局安装：
npm i -g @iqinghu/qhkit
如果 npm 注册表速度较慢或不可用，请使用文档中的镜像重试：
npm i -g @iqinghu/qhkit --registry=https://registry.npmmirror.com
如有需要，配置 API token。通过 Qinghu 账户和 API 密钥页面获取 token，然后在本地设置：
qhkit config set --token --env prod
也可以设置 QHKIT_TOKEN 环境变量。再次运行 qhkit config show，确认脱敏后的配置。
查询前，检查当前架构并估算费用：
qhkit mcp describe '{"names":["tiktok_product_ranklist"]}'
qhkit mcp estimate '{"names":["tiktok_product_ranklist"]}'
使用用户确认且符合最新 inputSchema 的值调用工具。不要原样提交文档中的示例占位值。对于复杂或非 ASCII 参数，请将 JSON 请求放入文件，并使用 qhkit mcp call @params.json 调用。
如果 qhkit 已过时，请升级后重试：
npm i -g @iqinghu/qhkit@latest
TikTok 商品排行榜 | Qinghu AI 数据架构与分类体系
此技能向 tiktok_product_ranklist 工具发送请求。由 qhkit mcp describe 返回的最新 inputSchema 具有权威性；以下参数说明仅为摘要。
参数 必填 类型 含义
date 是 string yyyy-MM-dd 格式的排行榜日期。
region 是 string TikTok Shop 市场代码，例如 US。
product_rank_field 是 integer 1 = 畅销商品（total_sale_cnt）；2 = 热门商品（total_ifl_cnt）。
rank_type 是 integer 1 = 每日；2 = 每周；3 = 每月。
page_num 是 integer 从 1 开始的页码；最大值为 100000。
page_size 是 integer 每页记录数；最大值为 10。
category_id 否 string 一级商品类别 ID。
category_l2_id 否 string 二级商品类别 ID。
category_l3_id 否 string 三级商品类别 ID。
排行榜数值表示所选报告周期内的增长。每周排行榜对应星期一的报告日期；每月排行榜对应该月的第一天。用户要求当前或最新数据时，请使用最近一个已完成且可用的周期。
响应处理：成功调用会返回一行 JSON 对象，其中包含 ok、stage、name、credits 和 data。失败时会返回 ok: false、stage 和 message；请准确转达错误信息。少量结果包含在 data 中。大量结果可能包含 large: true、包含完整 JSON 的本地 file 路径、记录数、字段和预览。后续筛选、分析或导出时请使用该文件，不要根据预览推断完整数据集。如果有 10 条或更多记录，且 qinghu-excel-export 技能可用，请提供电子表格。
成功调用中的 credits 值是以 Qinghu 积分计费的金额；不要进行换算。费用可能随结果大小变化，因此请使用实时估算，并报告调用响应中的实际总额。

高级特性

支持每日、每周和每月排行榜，并可自动将“最新”等相对请求解析为最近一个可用的已完成周期。
支持畅销和热门排行榜、市场筛选、类别 ID 以及分页获取结果。
tiktok_search_items
根据类别名称查找类别 ID；不会编造类别标识符。
执行前检查当前工具架构和积分估算，并要求用户在会话中的首次付费调用前批准。
通过本地 JSON 文件处理大型响应，并提供预览和记录元数据，以便高效开展后续分析。
每个响应轮次最多进行 10 次付费调用；如需额外获取数据，必须说明原因并征得同意。
区分不收费的本地验证失败与可能产生费用的服务端失败；避免盲目重复重试。
仅处理 TikTok Shop 商品排行榜相关内容；其他更广泛的商品研究或数据需求会转交给适当的 Qinghu 相关工具或技能。

name: qinghu-tiktok-product-rank description: "青虎AI TikTok-商品榜单：按站点、类目查询 TikTok Shop 商品热销榜 / 热推榜（日 / 周 / 月榜，返回周期增量）。当用户说「TikTok 美国站这周卖得最好的商品」「××类目的热销榜」「热推榜前 100」或提出同类需求时必须触发。关键词：青虎AI、qhkit、青虎数据、TikTok、TikTok Shop、抖音国际版、商品榜、热销榜、热推榜、爆品、商品榜单列表。" user-invocable: true
homepage: https://www.npmjs.com/package/@iqinghu/qhkit