技能介绍

要解决什么问题

在酷特海外运营 / C 端商城场景里，Agent 往往需要在不写购物车、不下单的前提下，先拿到「能继续查详情、对库存」的商品候选。手工拼 https://www.kutetailor.com/api/product 下的 Query、Header 和分页字段，还要区分登录态搜索与公开首页列表，容易漏传 source、originSign 或把 id 当成 styleId。

本技能把商品侧的只读浏览与检索收成统一 params 调用，对接首页列表、名称/编码搜索、已上架品类和 C 端分类树四类动作，返回结果里保留后续链路需要的标识与价格字段。

核心能力与调用方式

product_home：GET /product/product/public/selectProductHome，用于商城首页、分类页轻量过滤；type 必填（1 简定制，2 成品），首轮闭环通常优先 type=2。
product_search：GET /product/product/cProductPage，登录态下按 name 或 code 搜索；建议传 accessToken（Bearer）。
all_categories：GET /product/product/selectAllCategory，拉取已上架简定制/成品品类；C 站需 source、originSign。
product_category_tree：GET /product_category/public/{userId}/{type}，按站点用户与商品类型查 C 端分类树。

调用约定：tool arguments 最外层只能是 params；正式环境根地址固定在 frontmatter 的 base_url，由执行器拼 endpoint。分页建议 pageNum 从 1 起、pageSize 10–20；列表过大可在本地截断展示，但不要改后端分页语义。

推荐流程：无 token 时先走 platform-session-auth；无明确关键词时优先 product_home；有商品名/编码且已登录时用 product_search；问「有哪些分类」先 all_categories，需要树形导航再 product_category_tree。

边界与注意点

只读：不查深度详情、不查库存、不写购物车；不调用 /admin/*、报表、同步、导入导出。
C 站公共浏览上下文：source: C、originSign；部分列表可用 ctoken，不能替代详情链路的 originSign。
返回候选务必保留 id、styleId、type、name、code 及价格/币种；列表里的 stock 仅为摘要，下单前仍须详情或库存接口确认。
查无结果时如实说明条件与后端响应，不编造商品。