kutesmart-海外运营平台商品浏览搜索-商城首页商品列表、按名称或编码搜索商品、查询已上架品类、查询 C 端分类树

正式环境固定服务根地址：https://www.kutetailor.com/api/product

用于只读查询商城商品候选。这个 skill 不查看深度详情、不查库存、不写购物车，适合作为后续 platform-product-detail 和购物车下单链路的前置检索能力。

调用参数要求

调用本技能时，tool arguments 统一使用嵌套 params 对象：

{
  "params": {
    "action": "product_home",
    "accessToken": "<access_token>",
    "source": "C",
    "originSign": "<site-sign>",
    "type": 2,
    "pageNum": 1,
    "pageSize": 20
  }
}

重要约束：

最外层只能放 params。
正式环境地址固定在 frontmatter 的 base_url；执行器按 base_url + endpoint/动作表 URL 调用。
登录态接口带 Authorization: Bearer <accessToken>。
C 站公共浏览通常需要 Header/Query 上下文：source: C 和 originSign；部分列表场景可用 ctoken，但不能替代详情接口的 originSign。
这是只读 skill，不调用购物车、下单、后台维护、导入导出接口。
列表结果较大时可以本地截断展示，但后端 pageSize 建议保持 10-20。

触发场景

“看看商城商品”
“搜索衬衫/西服/某个商品编码”
“有哪些已上架品类”
“按分类找商品”
“给我一些可下单商品候选”

输入参数

| 参数 | 类型 | 必填 | 说明 | |---|---|---:|---| | frontmatter.base_url | string | 固定 | 正式环境服务根地址，调用时不由用户传入。 | | params.action | string | 是 | 见下方动作表。 | | params.accessToken | string | 条件 | 登录态搜索建议传；发送为 Bearer token。 | | params.source | string | C站建议 | 通常为 C。 | | params.originSign | string | C站条件 | C 站站点标识；品类和详情链路常用。 | | params.ctoken | string | 否 | 部分 C 站列表上下文可用。 | | params.pageNum | number | 分页必填 | 页码，默认建议 1。 | | params.pageSize | number | 分页必填 | 每页数量，默认建议 20。 | | params.type | number | product_home 必填 | 1 简定制，2 成品。首轮闭环优先 2。 | | params.sort | number | 否 | 排序方式，源码注释：1 升序，2 降序。 | | params.category | number | 否 | 产品品类。 | | params.labels | string | 否 | 标签，按后端口径传。 | | params.productCategory | number | 否 | 产品分类。 | | params.label | number | 否 | 单个标签。 | | params.code | string | 搜索条件 | 商品编码。 | | params.name | string | 搜索条件 | 商品名称。 | | params.currency | number | 否 | 币种 id。 | | params.userId | number/string | 分类树必填 | 网站所属用户。 |

动作表

| action | 请求 | URL | 参数 | 返回 | 用途 | |---|---|---|---|---|---| | product_home | GET | /product/product/public/selectProductHome | Query：pageNum、pageSize、type，可选 sort、category、labels、productCategory、label、userId | IPage<ProductHomeVO> | 商城首页、分类页和轻量过滤。 | | product_search | GET | /product/product/cProductPage | Query：pageNum、pageSize，可选 code、name、userId、currency | IPage<CProductListVO> | 登录态下按商品名称或编码搜索。 | | all_categories | GET | /product/product/selectAllCategory | Header/Query：C 站需 source、originSign | List<StyleFinishCategoryVO> | 获取已上架简定制/成品品类。 | | product_category_tree | GET | /product_category/public/{userId}/{type} | Path：userId、type | RS<List<ProductCategoryCVO>> | 查询 C 端分类树。 |

返回字段重点

| 字段 | 说明 | |---|---| | id | 商品 id，传给商品详情、库存、价格接口。 | | styleId | 款式 id，保存购物车时要用。 | | type | 1 简定制，2 成品。 | | name / code | 商品名称和编码。 | | price / retailPrice | 价格字段，以实际接口返回为准。 | | currencySymbol / currencyCode | 币种展示。 | | stock | 列表库存摘要；下单前仍需详情/库存接口确认。 | | records / total / current / size | IPage 分页字段。 |

安全边界

不提交订单、不保存购物车、不删除购物车项。
不调用后台 /admin/*、报表、同步、导入导出接口。
不把商品 id 当作 styleId 使用；只把两者作为候选字段交给详情 skill 核验。
没有查询到商品时，说明条件和后端返回，不编造商品。

来源

| 项目 | 路径 | |---|---| | 商品接口 | rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/controller/ProductController.java | | 分类接口 | rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/controller/ProductCategoryController.java | | 请求对象 | rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/request/ProductHomeRequest.java | | 请求对象 | rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/request/CProductListRequest.java | | 接口清单 | doc/interface-list.md |

kutesmart-海外运营平台商品浏览搜索-商城首页商品列表、按名称或编码搜索商品、查询已上架品类、查询 C 端分类树

kutesmart-海外运营平台商品浏览搜索-商城首页商品列表、按名称或编码搜索商品、查询已上架品类、查询 C 端分类树

调用参数要求

触发场景

输入参数

动作表

推荐流程

返回字段重点

安全边界

来源