COMMERCE 扩展包

商品搜索、详情与评价

用基于 SKU 的明确调用研究小红书商品。

启用商品研究

为你的 Key 启用 Commerce，MCP 连接加上 packs=commerce。每个工具支持小红书，每次发起一个付费请求；不会购买商品，也不会自动抓取更多页面。

用 platform=xiaohongshu 和 query 调用 product_search。把条目的 id 复制到 product，用于 product_detail 和 product_reviews。商品 ID 是 24 位小写十六进制的 SKU 标识；不接受链接或猜测的 SPU 标识。

翻页时带上 page.cursor，并保持原始 query 或 product 及筛选不变。每一页都单独计价。结果限定为一个原生页，最多 20 个商品或评价，最多 250 页。

请求模板

{
  "platform": "xiaohongshu",
  "query": "phone case"
}

搜索的 native_price 已是主币单位。详情的 native_price 由源端的分为单位金额除以 100 得到，并保留原始金额。源端没有明确原生币种。经过核实的地区 display_price 有自己的币种，不能当作原生金额。

价格为 0 或缺失表示报价不可得，不是免费商品。库存是源端快照，不保证能下单。详情里的规格由源端选择，每个规格 SKU 都需要单独发起详情请求，不保证覆盖整个 SPU。

product_reviews 接受 sort=general|latest 和 photo_filter=all|photos，默认 general 和 all。只有图片没有文字的评价会保留为“Product review”。API 不返回买家身份、媒体链接、订单详情，也不会自动获取追评。

相对日期保留在 source_date_text 中，不会补全省略的年份。评价是源端选取的样本，不代表全部购买的核实结果。没有独立 SKU 回显的响应会显式绑定到请求元数据。有效的空页计费；失败或无效页免费。

请求模板

{
  "platform": "xiaohongshu",
  "product": "PASTE_RETURNED_SKU_ID",
  "sort": "latest",
  "photo_filter": "photos"
}

价格版本：standard-2026-09-08-12ebeeeacfa39f97。HTTP 调用请使用 Idempotency-Key；相同请求重放会保留原始结果和扣费。