KuteSmart商品名称编码搜索

解决什么问题

在海外运营平台的日常工作中，商品检索是一个高频且关键的操作。当业务人员需要在登录状态下根据商品名称或编码快速定位商品时，直接对接接口往往会面临几个痛点：认证令牌的处理逻辑分散、查询参数的组装规则不一致、以及不同接口的返回格式差异。这些细节消耗了大量开发时间，且容易出错。

技能如何工作

这个技能将商品搜索的接口调用封装为单一动作 product_search，核心是调用 GET /api/product/product/product/cProductPage。使用时，所有参数通过嵌套的 params 对象传递，而不是分散的点号 key。认证方面，它自动处理 params.accessToken 并生成 Authorization: Bearer 头，如果传入值已包含 Bearer 则不会重复拼接。

查询参数如 pageNum、pageSize 放在 params.query 中，而路径参数则放在 params.path。这种设计保持了与网关契约的一致性，同时避免了参数错乱。

适用边界

需要注意的是，这个技能只负责单个接口调用，不具备完整的业务流程编排能力。当需要多步骤的商品管理时，需要由上层 agent 组合多个原子技能。此外，它强制使用固定地址，不接受用户输入覆盖 base_url。返回结果严格以接口响应为准，不会补造任何业务字段。