安装指南

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

什么是

此 skill 可让 AI agent 使用店铺的 seller_id 查询 TikTok Shop 已记录的商品。适用于查找店铺销售的商品、查看竞争对手的商品列表，或检查店铺可能的畅销商品等请求。在 Openclaw Skills 中，它通过 qhkit MCP 提供一种专门访问 Qinghu Data 的 TikTok 卖家商品列表工具的方式。
此 skill 仅处理 tiktok_seller_product_list 查询；不会进行完整的商品、市场或竞争对手分析。调用需要付费，因此 agent 必须在会话中首次调用前检查当前费用估算并取得用户授权。结果和实际扣除的 credits 会在工具响应中报告。

应用场景

用户提供 TikTok Shop 的卖家 ID 时，查找该店铺已记录的商品。
查看竞争对手店铺的商品组合，或获取指定页面的商品列表。
在当前工具 schema 允许时，按支持的销量、GMV 或平均价格字段对商品列表排序。
将商品列表数据作为单独的选品或竞争对手分析工作流的输入。
无需配置单独的 host MCP server，即可获取 TikTok Shop 数据。

工作原理

将请求识别为 TikTok Shop 商品列表查询，并收集必需的 seller_id、页码和每页数量。若缺少必需值，应询问用户，不要猜测。
在会话中首次付费调用前，说明工具及其用途，运行 qhkit mcp estimate 获取当前基础 credits 估算，并取得用户同意。说明实际费用可能随结果数量而变化。
运行 qhkit mcp describe 获取最新的输入 schema。以此为参数名称和要求的依据；文档中的参数表只是一个快照。
使用用户提供的值调用 tiktok_seller_product_list。对于复杂或非 ASCII 参数，将请求 JSON 写入文件并以 @params.json 传入，以避免 shell 转义问题。
解析单行 JSON 响应。结果较小时使用 data；结果较大时，从返回的 file 读取完整 JSON，不要根据预览推断完整数据集。
首先给出关键发现。记录数达到 10 条或以上时，如果支持导出，应提供类似电子表格的文件和简洁预览。报告调用响应中的实际 credits 总数。

配置指南

安装 Node.js 18 或更高版本以及 qhkit CLI。此 skill 的 MCP 命令要求 qhkit 0.14.0 或更高版本。如果已安装 qhkit，请先检查其配置：
qhkit config show
如有需要，全局安装或升级 CLI：
npm i -g @iqinghu/qhkit
如果 npm registry 速度较慢或无法使用，请使用文档中提供的镜像：
npm i -g @iqinghu/qhkit --registry=https://registry.npmmirror.com
如果没有 token，请配置凭证。通过 Qinghu 工作台获取 API key，然后使用 qhkit 设置，或通过环境变量提供：
qhkit config set --token --env prod

或者，在环境变量中设置 QHKIT_TOKEN。

qhkit config show
调用商品列表工具前，请检查其当前 schema 和价格估算：
qhkit mcp describe '{"names":["tiktok_seller_product_list"]}'
qhkit mcp estimate '{"names":["tiktok_seller_product_list"]}'
使用 describe 返回的 schema 构建调用。将占位符替换为用户实际提供的值；不要直接提交未修改的示例值。例如，在确认当前 schema 并取得同意后：
qhkit mcp call '{"name":"tiktok_seller_product_list","params":{"seller_id":"","page_num":1,"page_size":"10"}}'
对于复杂参数，将完整请求对象保存到 params.json，并通过文件引用调用：
qhkit mcp call @params.json
如果 qhkit 报告未知 mcp 命令，或当前安装版本受到限制，请升级后重试原命令：
npm i -g @iqinghu/qhkit@latest
TikTok Shop 商品列表 | Qinghu AI 数据架构与分类体系
请求参数
参数 必填 类型 用途
seller_id 是 string 要查询的 TikTok Shop 卖家 ID。
page_num 是 integer 页码，从 1 开始；文档记载的最大值为 100000。
page_size 是 string 每页请求的记录数；文档记载的最大值为 10。
sort_type 否 integer 排序方向：0 为升序，1 为降序。
seller_product_sort_field 否 integer 排序字段：1 总销量，2 总销售额 GMV，3 SPU 平均价格，4 七日销量，或 5 七日销售额 GMV。使用 describe 确认当前选项。
响应和文件
CLI 成功输出为单行 JSON 对象，包含 ok、stage、name、credits 和 data。
出错时会返回 ok:false、stage 和 message；应准确转述该消息。validate 错误表示请求发送前本地验证失败。调用或 MCP 失败可能有不同的计费影响，因此应避免反复试错调用。
较小的响应包含在 data 中。较大的响应可能包含 large:true、含完整 JSON 的本地 file 路径、记录数、字段和预览。后续筛选、统计或导出时使用该文件；不要将预览视为完整数据集。
此 skill 未定义固定输出目录、持久化数据库或自定义元数据分类体系。响应较大时，完整结果文件路径由 CLI 提供。
实际用量由调用响应中的 credits 表示。不要将此费用与业务数据中类似积分的字段混淆。

高级特性

qhkit mcp
使用 Qinghu Data 的
tiktok_seller_product_list
工具，无需单独配置 host MCP server。
支持先检查 schema 再请求：
qhkit mcp describe
提供当前的
inputSchema
，
qhkit mcp estimate
则在付费调用前检查当前基础 credits 估算。
支持分页，并可根据总销量、GMV、SPU 平均价格和七日销售指标进行可选排序，具体取决于实时 schema。
通过本地完整结果 JSON 文件处理大型响应，并提供记录数、字段信息和预览元数据。
实施费用控制：首次付费调用前取得用户批准；每轮响应的付费调用不超过 10 次；超过该上限继续调用前须再次取得批准。
区分商品列表获取与更广泛的分析。对于选品决策、商品深入研究或市场发现，应转交给合适的配套 skill，而不要用无关工具或浏览器抓取来替代。

name: qinghu-tiktok-shop-products description: "青虎AI TikTok-店铺商品列表：按 seller_id 查询 TikTok 小店已收录的全部商品。当用户说「这个 TikTok 店铺都卖什么」「竞店的商品列表」「看看这家小店的爆款」或提出同类需求时必须触发。关键词：青虎AI、qhkit、青虎数据、TikTok、TikTok Shop、抖音国际版、店铺商品、小店、竞店、seller_id、店铺商品列表。" user-invocable: true
homepage: https://www.npmjs.com/package/@iqinghu/qhkit