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。

触发场景

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

输入参数

动作表

推荐流程

1. 没有 token 时先调用 platform-session-auth；如果是公开 C 站浏览，至少准备 source 和 originSign。
2. 用户没有明确关键词时，优先 product_home，type=2 先找成品商品候选。
3. 用户给出商品名、款式名、编码时，登录态优先 product_search；无登录上下文时用 product_home 配合分类/标签过滤。
4. 用户说“有哪些分类/品类”时，先 all_categories，需要 C 端树形导航再 product_category_tree。
5. 返回候选时，必须保留后续链路需要的 id、styleId、type、name、code、价格和币种字段。

返回字段重点

安全边界

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

来源