TikTok Shop 商品评论 | Qinghu AI

安装指南

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

什么是

TikTok Shop 商品评论是一项 Openclaw Skills 集成，可使用 TikTok Shop 商品 ID 获取 Qinghu Data 收集的商品评论。它通过 qhkit CLI 调用 tiktok_product_comment 工具，因此无需在主机环境中查找或配置单独的 MCP 服务器。
可使用它查看买家反馈或检查某款商品收集到的评论。该 skill 会验证必需的输入、检查当前工具架构和预估费用，并妥善处理少量或大量结果。它仅获取评论；更广泛的商品研究和多步骤分析应交由其他工具或 skills 完成。

应用场景

用户要求查看某个 TikTok Shop 商品的评论。
用户想了解买家如何评价某款特定商品。
用户要求检查差评或客户投诉。
用户提供商品 ID，并要求查看特定页码或数量的评论。
用户需要收集的评论数据用于后续分析，但须遵守工具的范围和结果限制。

工作原理

确认商品 ID 以及任何指定的分页详情。缺少必需输入时应询问，不要猜测。
在对话中首次调用工具之前，说明工具及其用途，使用 qhkit mcp describe 检查当前输入架构，并使用 qhkit mcp estimate 检查基础价格。
说明预估积分费用，并在进行付费调用前获得用户授权。对于大型请求，说明费用取决于返回的数据量。
使用 qhkit mcp call 调用 tiktok_product_comment，并传入 product_id、page_num 和 page_size，采用 describe 返回的最新架构。
解析单行 JSON 响应。先简要呈现主要发现；对于大型结果，使用返回的本地文件进行后续处理，不要根据预览推断完整数据集。
报告调用响应中的实际积分。如果付费调用失败，转述返回的消息，并避免反复进行推测性重试。

配置指南

要求：Node.js 18 或更高版本、@iqinghu/qhkit 软件包、支持 mcp 命令的 qhkit 0.14.0 或更高版本，以及 Qinghu API token。
npm i -g @iqinghu/qhkit
qhkit config set --token --env prod
qhkit config show
登录 Qinghu 并在控制面板中创建 API key，即可获取 token。也可以配置 QHKIT_TOKEN 环境变量。如果全局安装因权限问题失败，请使用完整软件包名称运行 npx @iqinghu/qhkit。如果 npm 官方 registry 速度较慢或不可用，可通过 --registry=https://registry.npmmirror.com 指定文档中列出的 npm 镜像。
使用此 skill 前，请通过 qhkit config show 确认 CLI 版本和配置。使用以下命令升级过时的安装：
npm i -g @iqinghu/qhkit@latest
工具发现和费用估算免费；获取评论属于付费操作。每次对话首次付费调用前，必须获得用户授权。
TikTok Shop 商品评论 | Qinghu AI 数据架构与分类体系
请求参数
参数 类型 必填 说明
product_id string 是 TikTok Shop 商品 ID。
page_num integer 是 页码，从 1 开始；文档所述最大值为 100,000。
page_size integer 是 每页请求的记录数；文档所述最大值为 10。
qhkit mcp describe 返回的实时 inputSchema 优先于此参数快照。对于复杂值或对 shell 敏感的字符，请将请求 JSON 放入文件，再调用 qhkit mcp call @params.json。
响应和文件
成功调用会返回包含 ok、stage、name、credits 和 data 字段的 JSON 信封。
错误会返回 ok: false、stage 和 message；验证失败发生在发送请求之前，而服务或 MCP 失败的计费影响可能不同。
少量结果会包含在 data 中。大量结果可能会返回 large: true、包含完整 JSON 的本地 file 路径、记录数、字段和预览。筛选、统计或导出时请使用该文件；不要将预览视为完整数据集。
如果有 10 条或更多记录，且可使用 qinghu-excel-export skill，请将数据作为电子表格提供。聊天回复应保持简洁，不要粘贴大型数据集。
工具会根据返回的结果扣除 Qinghu 积分。使用 qhkit mcp estimate 获取当前基础费用估算，并通过响应中的 credits 值查看实际用量。

高级特性

qhkit mcp describe
获取最新的工具输入架构，并在获取数据前使用
qhkit mcp estimate
检查当前基础价格。
支持按商品 ID 分页查询，并要求提供页码和每页数量参数。
通过本地 JSON 文件以及记录数、字段和预览等元数据处理大型响应，无需将所有记录复制到聊天中即可进行后续处理。
支持使用
qhkit mcp call @params.json
从文件读取请求参数，以避免 shell 转义问题。
实施明确的授权和支出保护措施：付费调用前说明预期费用、报告实际积分，并在单轮回复中超过 10 次付费调用前再次征求批准。
专注于 TikTok 商品评论；对于不受支持的数据请求，不会以浏览器抓取或无关工具替代。

name: qinghu-tiktok-product-reviews description: "青虎AI TikTok-商品评论：按 product_id 获取 TikTok Shop 已采集的商品评论列表。当用户说「看看这个 TikTok 商品的评论」「买家怎么评价这款」「商品差评」或提出同类需求时必须触发。关键词：青虎AI、qhkit、青虎数据、TikTok、TikTok Shop、抖音国际版、商品评论、买家评价、差评、商品评论列表。" user-invocable: true
homepage: https://www.npmjs.com/package/@iqinghu/qhkit