TikTok 商品直播 | Qinghu AI

安装指南

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

什么是

此技能通过 Qinghu Data 的 tiktok_product_live_list 工具，检索与特定商品 ID 关联的 TikTok Shop 直播记录。它帮助卖家和研究人员查找展示特定商品的直播，并可选择日期筛选、排序和分页。
作为 Openclaw Skills 的一部分，它使用 qhkit mcp CLI 描述、估算并调用数据工具；无需在宿主环境中查找或配置单独的 MCP 服务器。此技能专注于此项查询，不用于全面的商品分析或其他平台的数据。

应用场景

查找展示过特定商品的 TikTok 直播。
在规划活动前查看某商品的直播销售记录。
在工具 schema 支持时，按观看量、销量或 GMV 对相关直播排序。
获取指定商品 ID 的特定页记录。
将任务转交给合适的 Qinghu 技能，开始更广泛的商品或创作者分析。

工作原理

确定商品 ID 及任何指定的日期范围、排序方式或每页数量。缺少必需信息时，请用户澄清，不要猜测。
在会话中首次付费调用前，说明工具及其用途，运行 qhkit mcp estimate，并告知用户预计的积分费用。调用前须获得授权；不得进行未经批准的调用。
运行 qhkit mcp describe 查看当前输入 schema，并以此作为参数的权威依据。
使用已确认的商品 ID 和所需选项调用 tiktok_product_live_list。对于复杂或非 ASCII 参数，将 JSON 请求放入文件，并使用 qhkit mcp call @params.json 调用。
解读返回记录，报告结果及此次调用实际消耗的积分；结果较多时，应提供文件和简短预览，而不是把每一行都复制到聊天中。

配置指南

此技能需要 Node.js 18 或更高版本，以及来自 @iqinghu/qhkit 的 qhkit CLI。mcp 子命令需要 qhkit 0.14.0 或更高版本。无需单独配置宿主 MCP 服务器。
全局安装 qhkit 并检查配置：
npm i -g @iqinghu/qhkit
qhkit config show
如果尚未安装 Node.js，请先安装 Node.js 18+。在 macOS 上使用 brew install node；在 Windows 上使用 winget 或官方安装程序。如果权限阻止全局安装，文档提供的替代方式是 npx @iqinghu/qhkit ...。
如有需要，配置 Qinghu API 密钥，然后确认已就绪：
qhkit config set --token --env prod
qhkit config show
也可以通过 QHKIT_TOKEN 环境变量提供令牌。更新旧版 CLI：
npm i -g @iqinghu/qhkit@latest
首次工具调用为付费调用。调用前运行 qhkit mcp describe '{"names":["tiktok_product_live_list"]}' 和 qhkit mcp estimate '{"names":["tiktok_product_live_list"]}'，说明预计费用并取得用户批准。
TikTok 商品直播 | Qinghu AI 数据架构与分类体系
查询参数
参数 必填 类型 用途
product_id 是 string 请求其相关直播记录的商品标识符。
page_num 是 integer 页码，从 1 开始；文档所述最大值为 100000。
page_size 是 integer 每页记录数；文档快照规定最大值为 10。
product_live_sort_field 否 integer 排序字段：1 = 最高观看量，2 = 商品总数，3 = 总销量，4 = 总销售额 GMV，5 = 总观看量。
sort_type 否 integer 排序方向：0 = 升序，1 = 降序。
如果与此参考不同，请使用 qhkit mcp describe 返回的当前 inputSchema。该工具返回单行 JSON 响应：成功调用包含 ok、stage、name、credits 和 data；失败则包含 ok、stage 和 message。少量结果会在 data 中返回。大量结果可能包含 large: true、保存完整 JSON 的本地 file 路径、记录和字段详情以及预览。后续筛选或分析时请使用该文件，不要根据预览推断完整数据集。

高级特性

在实时工具 schema 支持的范围内，可按直播观看量、商品数量、销量、销售额 GMV 或总观看量排序。
付费数据调用前提供免费的 schema 描述和价格估算；实际费用会在调用的
credits
字段中报告。
会话中首次付费调用前必须取得用户明确授权。调用费用按返回的数据量计算，执行较大的请求前应向用户说明。
通过本地 JSON 文件处理大型响应，并提供快速查看用的预览。对于 10 条或更多记录，如果有合适的导出技能，应提供文件或电子表格。
区分本地验证失败和服务错误。验证失败表示尚未发起调用；服务失败时应报告返回的消息，避免盲目重复重试。
范围仅限与 TikTok 商品关联的直播记录。更广泛的商品筛选、创作者分析或跨平台研究，请使用相关 Qinghu 工具或专业技能。

name: qinghu-tiktok-product-lives description: "青虎AI TikTok-商品带货直播：按 product_id 查询该商品关联的带货直播列表。当用户说「这个商品有哪些直播在卖」「看看这款的直播带货记录」或提出同类需求时必须触发。关键词：青虎AI、qhkit、青虎数据、TikTok、TikTok Shop、抖音国际版、直播带货、商品直播、直播间、商品关联直播列表。" user-invocable: true
homepage: https://www.npmjs.com/package/@iqinghu/qhkit