核心用法
本技能为 OpenClaw 智能体提供 Amazon Advertising API v3 的原生集成能力，专注于 Sponsored Products（SP 商品推广）广告管理。用户通过配置 LWA（Login with Amazon）凭证即可在 CLI 环境中执行四大核心操作：列举广告主 Profile、查看全部 SP 推广活动、获取实时预算与效果摘要、导出结构化数据供进一步分析。
技能采用 JSON 凭证文件模式管理身份，支持北美（na）、欧洲（eu）、远东（fe）三大区域端点自动切换，无需手动处理域名差异。Token 采用按需刷新策略，降低 CLI 场景的运维复杂度，同时预留缓存扩展接口以满足高频调用需求。
显著优点
- 官方 API 直连：基于 Amazon Ads API v3，数据来源权威实时，避免第三方抓取的延迟与合规风险
- 多区域原生支持：内置 na/eu/fe 三端点映射，单一凭证配置即可覆盖全球主要电商市场
- 零持久化设计：Token 按需获取不缓存，减少敏感信息驻留风险，适合临时性运维操作
- CLI 友好输出：支持
--out参数导出 JSON，便于与 jq、Python 等工具链集成 - 与 SP-API 互补：与 skill-amazon-spapi 形成广告+运营的数据闭环
潜在缺点与局限性
- 功能范围窄：仅覆盖 Sponsored Products，不支持 SB（品牌推广）、SD（展示型推广）、DSP 等广告类型
- 无内置缓存：生产环境高频调用可能触发 API 限流，需自行实现 Token 与数据缓存层
- 凭证管理分散：Ads API 与 SP-API 使用独立的 LWA 应用，增加密钥轮换与审计成本
- 无沙箱环境：官方未提供完整功能沙箱，测试操作可能产生真实广告费用
- CLI 独占：缺乏 SDK 或 HTTP 服务封装形式，嵌入复杂业务系统需二次开发
适合人群
- 月广告花费 $5K-$500K 的亚马逊第三方卖家（3P Sellers）与品牌方（1P Vendors）
- 需将广告数据纳入内部 BI 系统的电商数据团队
- 开发内部广告优化工具的工程团队，需替代繁琐的 Seller Central 后台操作
- 已具备 Amazon SP-API 使用经验、希望扩展广告运营自动化能力的用户
常规风险
- 凭证泄露风险：
refreshToken长期有效，凭证文件需严格限制文件权限（建议 600），禁止提交至版本控制 - 误操作扣费风险：API 级别的预算调整、启停操作无二次确认，自动化脚本需内置校验逻辑
- 区域配置错误：region 字段误配可能导致请求路由至错误市场，引发数据权限异常或延迟
- Token 权限漂移：Amazon 定期调整 Ads API 权限范围，需关注官方变更日志避免调用失败
- 速率限制：默认配额较严格，批量操作需实现指数退避重试机制