kutesmart 海外运营平台 ready to buy 首页数据

要解决的问题

海外运营平台里的 ready to buy 首页数据看起来只是一个列表接口，实际调用时却容易踩几个坑：正式环境地址是否被覆盖、登录态如何放进请求头、路径参数与查询参数怎么区分、接口报错后是否原样传递给上层 Agent。把这些细节固化成一个最小颗粒度 skill，可以减少编排时的重复判断。

技能如何工作

本技能只负责一个原子动作：读取 ready to buy 首页数据。执行时固定调用 GET https://www.kutetailor.com/api/style/style-info/readyHome，不从用户输入覆盖 base_url。

参数统一放在嵌套的 params 对象中：

• 登录态通过 params.accessToken 生成 Authorization: Bearer；如果传入值已包含 Bearer，不重复拼接。
• 路径变量写入 params.path，查询参数写入 params.query，JSON Body 写入 params.body，额外请求头写入 params.headers。
• 当前接口是查询或计算类接口，仍需遵守登录态、租户和用户权限约束。
• 返回结果以接口响应为事实来源，成功时透传 List；认证、权限、参数或业务错误也把原始错误码和错误信息交给上层 Agent。

适用边界与注意点

它不是完整业务链路，只完成 ready_home 这一个平台接口动作。如果用户需要跨多个接口的完整流程，应由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill，并负责把本接口的关键字段交给后续步骤。

另外，不要根据首页数据自行补造库存、价格、订单号、优惠金额或物流状态；这些信息只有接口返回时才有效。