Shopee 商品详情 | Qinghu AI

安装指南

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

什么是

Shopee Product Details 是一款 Openclaw Skills 工具，通过 Qinghu Data 的 queryshopeeitemdetailbatch 服务和 qhkit mcp CLI 批量获取商品统计数据。卖家和研究人员无需在主机环境中单独设置 MCP 服务器，即可查看 Shopee 支持市场中的累计销量、销售额、商品类型和店铺类型。
当你已有 Shopee 商品 ID，并需要商品级数据进行快速比较或后续分析时，可使用此工具。该技能需要提供市场站点、单个查询日期和一个或多个商品 ID；它不会臆造缺失的输入，也不能替代更全面的商品研究与选品流程。

应用场景

查询单个 Shopee 商品的累计销量和营收，或比较多个商品。
获取商品和店铺类型，以评估刊登信息或卖家特征。
查看以下支持站点的商品：台湾（
tw
）、马来西亚（
my
）、印度尼西亚（
id
）、泰国（
th
）、菲律宾（
ph
）、新加坡（
sg
）、越南（
vn
）和巴西（
br
）。
补充从 Shopee 排名或店铺商品列表工具获取的商品 ID 信息。
将商品详情数据作为更大型市场分析流程中的一个步骤。

工作原理

判断请求属于 Shopee 商品详情查询，并收集所需的市场站点、查询日期和商品 ID。如缺少必需输入，应请用户补充说明，而不是猜测。
使用 qhkit mcp describe 和 qhkit mcp estimate 检查当前工具架构和价格。在会话中首次进行付费调用前，说明工具、用途和预估额度，并征得用户同意。
根据当前 inputSchema 为 queryshopeeitemdetailbatch 构建请求。商品 ID 应以逗号分隔的字符串形式提供；每次请求最多支持 10 个 ID。
使用 qhkit mcp call 调用工具。对于复杂参数或包含引号、非 ASCII 文本的值，将 JSON 请求写入文件，再使用 qhkit mcp call @params.json 调用。
读取 JSON 响应，准确报告结果；如果进行了付费调用，应说明实际消耗的额度。对于大型结果，应使用返回的文件进行筛选、分析或导出，不要将预览视为完整数据集。

配置指南

安装 Node.js 18 或更高版本以及 @iqinghu/qhkit 软件包。mcp 子命令要求 qhkit 版本为 0.14.0 或更高。此技能通过 qhkit 调用 Qinghu Data；无需单独配置主机 MCP 服务器。
npm i -g @iqinghu/qhkit
qhkit config set --token --env prod
qhkit config show
登录 Qinghu 工作台并创建 API 密钥即可获取令牌。请妥善保密令牌；也可以配置 QHKIT_TOKEN 环境变量。如果尚未安装 Node.js，请使用操作系统的软件包管理器或官方安装程序安装 Node.js 18 或更高版本，然后安装 qhkit。如果 CLI 提示版本过旧或无法识别 mcp 命令，请使用 npm i -g @iqinghu/qhkit@latest 升级。
查询前，请检查实时架构和预估价格：
qhkit mcp describe '{"names":["queryshopeeitemdetailbatch"]}'
qhkit mcp estimate '{"names":["queryshopeeitemdetailbatch"]}'
用户批准付费调用后，请发送符合实时架构的参数。以下数值仅为示例占位符；请替换为用户的实际请求：
qhkit mcp call '{"name":"queryshopeeitemdetailbatch","params":{"itemIds":"1234567890,1234567891","site":"tw","timest":"2026-05-26"}}'
Shopee 商品详情 | Qinghu AI 数据架构与分类体系
查询输入
字段 必填 格式与限制
site 是 市场代码：tw、my、id、th、ph、sg、vn 或 br。
timest 是 yyyy-MM-dd 格式的查询日期；选择一天。
itemIds 是 以逗号分隔的 Shopee 商品 ID 字符串；每次调用最多 10 个 ID。
如果当前参数与此参考内容不同，请以 qhkit mcp describe 返回的 inputSchema 为准。
响应与文件
成功调用会返回单行 JSON 响应，其中包含 ok: true、stage: "done"、工具 name、实际 credits 和 data。
错误会返回 ok: false、一个 stage 和一条 message。应准确转述该消息；验证阶段的错误表示调用尚未启动，也不会收费。
小型结果会在 data 中返回。大型结果可能包含 large: true、包含完整 JSON 的本地 file 路径、records 或 fields 元数据，以及 preview。请使用该文件进行完整的后续处理；不要根据预览推断完整数据集。
返回的商品统计数据包括销量、营收、商品类型和店铺类型。具体响应字段由服务响应决定。
对于包含 10 条或更多记录的结果，如果有合适的导出技能可用，请提供类似电子表格的文件。聊天摘要应简洁；展示数据时应区分市场站点、日期和样本量。

高级特性

批量获取：
每次调用最多查询 10 个商品 ID；更长的 ID 列表应拆分为多个批次。
架构感知请求：
调用前描述当前工具定义，并遵循其
inputSchema
，不要仅依赖参数快照。
费用与授权控制：
付费查询前预估额度；在会话中首次付费调用前征得用户同意，并报告响应中的实际额度。除非用户批准后续批次，否则每轮助手回复中的付费调用不超过 10 次。
更安全的参数处理：
qhkit mcp call @params.json
通过请求文件传递复杂 JSON 或含引号的 JSON，避免 shell 转义错误。
大型结果处理：
使用返回的本地 JSON 文件进行完整分析、筛选和导出，不要从预览中复制记录。
相关流程：
商品排名、店铺商品列表以及每日或长期商品趋势，可通过相应的 Qinghu 工具提供背景信息或商品 ID。若要进行更广泛的选品研究，或查询其他平台和数据类型，请使用相关的 Qinghu 技能，不要以无关工具或浏览器抓取代替。

name: qinghu-shopee-product-detail description: "青虎AI Shopee-商品详情：按商品 ID 批量查询 Shopee 商品的销量、销售额、商品类型、店铺类型（单次最多 10 个）。当用户说「查一下这几个 Shopee 商品的数据」「这个商品累计卖了多少」或提出同类需求时必须触发。关键词：青虎AI、qhkit、青虎数据、Shopee、虾皮、商品详情、商品数据、item_id、查商品详情。" user-invocable: true
homepage: https://www.npmjs.com/package/@iqinghu/qhkit