TikTok 商品视频 | Qinghu AI

安装指南

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

什么是

TikTok 商品视频是一项 Openclaw Skills 集成，可通过 Qinghu Data 的 tiktok_product_video_list 工具检索与 TikTok 商品关联的视频列表。提供商品 ID，即可查找创作者如何展示该商品、浏览推广视频，或寻找与商品研究相关的示例。
此技能使用 qhkit mcp 命令，无需在宿主环境中查找或配置 MCP 服务器。它支持分页、可选筛选条件和排序，同时确保付费调用须经用户授权，并报告实际消耗的积分。

应用场景

查找推广特定 TikTok Shop 商品的视频。

简介

研究热门或可能表现出色的商品视频示例。
根据已知商品 ID，检索与该商品关联的视频的指定页面。

工作原理

将请求识别为查找与 TikTok 商品关联的视频，并获取必需的商品 ID。若缺少必需信息，应请用户补充，而不是自行猜测。
在会话中首次调用前，使用 qhkit mcp describe 获取当前输入架构，并使用 qhkit mcp estimate 查看当前基础价格。
告知用户将调用哪个工具、工具的用途以及预估积分费用；在进行付费调用前获得用户授权。
使用用户提供的商品 ID，以及当前架构允许的有效参数，调用 tiktok_product_video_list。使用分页控制返回记录数。
读取单行 JSON 响应。结果较少时直接展示；结果较多时，后续筛选或分析应以返回的文件为依据，而不是根据预览推断。
清晰总结发现；在可用时标明相关平台、站点、时间段和样本量，并报告各次调用返回的实际消耗积分总数。

配置指南

安装 Node.js 18 或更高版本以及 qhkit CLI。软件包为 @iqinghu/qhkit；MCP 子命令要求版本为 0.14.0 或更高。
npm i -g @iqinghu/qhkit
qhkit config show
如果缺少 CLI，但已安装 Node.js 和 npm，请全局安装。如果 npm registry 响应缓慢或无法访问，可以使用文档中列出的镜像：
npm i -g @iqinghu/qhkit --registry=https://registry.npmmirror.com
如有需要，请配置凭据。从 Qinghu 账户和 API 密钥页面获取 Qinghu API 密钥，然后在本地设置，或通过 QHKIT_TOKEN 环境变量提供：
qhkit config set --token --env prod
qhkit config show
查询前，请检查实时工具架构并估算费用：
qhkit mcp describe '{"names":["tiktok_product_video_list"]}'
qhkit mcp estimate '{"names":["tiktok_product_video_list"]}'
调用工具前，请先获得用户对付费查询的授权。对于复杂参数或可能导致 shell 转义问题的值，请将请求 JSON 写入文件，并使用 qhkit mcp call @params.json 传入。使用 npm i -g @iqinghu/qhkit@latest 升级过时的 CLI。
TikTok 商品视频 | Qinghu AI 数据架构与分类体系
此技能使用商品 ID 查询 tiktok_product_video_list 工具。务必使用 qhkit mcp describe 返回的当前 inputSchema；以下字段是已记录的参数快照：
参数 必填 类型 用途
product_id 是 string 要查询的 TikTok 商品标识符。
page_num 是 integer 页码，从 1 开始；文档记载的最大值为 100000。
page_size 是 integer 每页结果数；最大值为 10。
sort_type 否 integer 排序顺序：0 表示升序，1 表示降序。
成功调用会返回包含 ok、stage、name、credits 和 data 的 JSON。结果较少时会包含在 data 中。结果较多时，可能会包含 large: true、包含完整 JSON 的本地 file 路径、records、fields 和 preview。后续分析请使用该文件；不要将预览视为完整数据集。CLI 的 credits 字段报告实际消耗的 Qinghu 积分。此技能不定义单独的持久化数据库，也不规定固定的输出文件命名方式。

高级特性

qhkit mcp describe
实时发现架构，有助于确保参数符合工具的当前要求。
qhkit mcp estimate
估算费用，有助于在付费查询前作出知情授权；实际费用可能随结果数量而变化。
分页以及可选的时间和排序参数支持有针对性的检索，但须遵循当前工具架构和文档记载的每页数量上限。
基于文件的请求输入（
qhkit mcp call @params.json
）可避免复杂或非 ASCII 参数引发的 shell 转义问题。
大结果处理会提供文件路径、记录数、字段列表和预览，以便后续筛选或导出。
此技能专用于与 TikTok 商品关联的视频。如需进行更广泛的商品分析或获取其他类型的数据，请使用适当的 Qinghu 工作流程，而不要用不相关的工具代替。
付费调用须经用户授权；应报告实际消耗的积分，避免反复重试，并在单个响应轮次中超过 10 次付费调用前请求进一步授权。

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