酷特海外商城商品浏览搜索

要解决什么问题

在海外运营场景里，Agent 往往需要在不写购物车、不下单的前提下，先拿到「能继续查详情、对库存」的商品候选：首页浏览、按名称或编码检索、看清已上架品类，以及 C 端分类树导航。若把详情、库存、后台维护混在同一套工具里，调用边界容易模糊，也容易误触写操作接口。

本技能面向酷特海外商城（正式环境根地址固定为 https://www.kutetailor.com/api/product），只做只读商品候选查询，适合作为 platform-product-detail 与购物车/下单链路的前置检索。

核心能力与调用方式

调用时 tool arguments 最外层只能放 params；执行器按 frontmatter 中的 base_url 与动作表拼 URL。C 站公共浏览通常需要 Header/Query 上下文：source: C、originSign；部分列表可用 ctoken，但不能替代详情链路的 originSign。登录态搜索建议传 accessToken（Authorization: Bearer）。

| 动作 | 用途 |
|------|------|
| product_home | 商城首页/分类页轻量过滤（type：1 简定制，2 成品；首轮闭环建议优先 type=2） |
| product_search | 登录态下按 name 或 code 分页搜索 |
| all_categories | 已上架简定制/成品品类列表 |
| product_category_tree | C 端分类树（需 userId、type） |

推荐流程：无 token 时先走 platform-session-auth；无明确关键词时优先 product_home；有商品名/编码且已登录时用 product_search；问「有哪些分类」先 all_categories，需要树形导航再 product_category_tree。返回候选时应保留 id、styleId、type、name、code 及价格/币种字段，供后续接口核验。

边界与注意点

• 不查深度详情、不查库存确认、不写购物车；列表里的 stock 仅为摘要，下单前仍需详情/库存 skill。
• 不调用后台 /admin/*、报表、同步、导入导出；不把 id 当作 styleId 使用。
• 分页建议 pageSize 10–20；结果过大可本地截断展示，但勿编造未返回的商品。
• 查无结果时，应说明检索条件与后端响应，而不是虚构 SKU。