# 商品搜索、详情与评价

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

规范地址: https://socialtoai.com/zh/docs/commerce/

## 启用商品研究

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

## 搜索、选定 SKU、读取评价

用 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"
}
```

## API 调用价格

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

| 平台 | 操作 | Credits | 可用性 |
|---|---|---|---|
| 小红书 | product_search | 1.5 | 可用 |
| 小红书 | product_detail | 1.5 | 可用 |
| 小红书 | product_reviews | 1.5 | 可用 |

[完整输入 schema →](https://socialtoai.com/openapi.json)