酷特海外平台·上架品类查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-product-browse-all-categories。
技能介绍
要解决什么问题
在海外运营平台做商品浏览、搜索或选品时,下游接口往往要求先知道当前已上架的简定制与成品品类树。手工在后台翻菜单既慢,也不适合 agent 按步骤编排。本技能只做一件事:调用正式环境 GET /product/product/selectAllCategory,把平台返回的品类列表交给上层,用于类目筛选、联动查询或写入计划中的下一步 skill。
技能如何工作
这是 platform-product-browse 聚合链路里的原子接口 skill,对应 action all_categories。执行器固定使用 frontmatter 中的正式环境 base_url(https://www.kutetailor.com/api/product/product/product/selectAllCategory),不接受用户输入覆盖地址。
调用约定与其它酷特平台 skill 一致:tool 参数最外层只放 params。登录态通过 params.accessToken 生成 Authorization: Bearer(值里已带 Bearer 则不再拼接)。C 站场景需在 Header/Query 中携带 source、originSign 等平台要求字段;Path 写在 params.path,Query 写在 params.query,额外头写在 params.headers。
返回以接口响应为准,类型为 List;不要在本层补造库存、价格或订单类字段。若出现认证、权限、参数或业务错误,应把原始错误码与信息向上传递,由上层 agent 决定重试或换路。
适用边界
- 仅覆盖「获取已上架简定制/成品品类」这一接口;多步业务流程需组合其它原子 skill 或聚合 skill 文档编排。
- 仍为查询类接口,受当前登录态、租户与用户权限约束;无权限时不会「推断」出品类数据。
使用场景
- 海外站商品搜索 agent 在调用搜索接口前,需要先拉取当前已上架的简定制与成品品类,用于构造类目筛选条件。
- 编排 platform-product-browse 链路时,把本 skill 作为第一步,用返回的 List 驱动后续按类目浏览或详情查询。
- 对接 kutetailor 正式环境时,运营工具需要从 selectAllCategory 同步类目树,避免手工维护与后台不一致。
- C 站网关要求 source、originSign 时,在已登录态下查询上架品类,供前台类目导航或选品向导使用。
适合人员
- 负责酷特海外运营平台 API 对接的后端工程师,需要在 agent 里稳定调用 selectAllCategory 并传递 Bearer 登录态。
- 管理海外站上架与类目结构的运营人员,希望自动化获取「已上架」简定制/成品品类而非逐页导出后台。
- 正在拆分或组装 platform-product-browse 聚合 skill 的 agent 开发者,需要最小粒度的 all_categories 原子能力。
- 维护多租户、多站点选品逻辑的产品/实施同学,要把品类列表作为下游搜索与浏览接口的前置输入。