核心功能
Amazon Ads Skill 是面向 OpenClaw 代理的 Amazon Advertising API v3 官方集成工具，专为 Sponsored Products（商品推广）广告自动化管理设计。核心能力覆盖：
- 多区域支持：北美（
na）、欧洲（eu）、远东（fe）三端点自适应切换 - 广告主档案管理：一键枚举所有广告档案（Profile），快速定位目标品牌/市场
- 广告活动运维：查询 SP 广告活动列表、激活状态、预算消耗
- 数据导出：支持 JSON 格式结构化输出，便于下游 BI 对接
显著优点
| 维度 | 优势 |
|------|------|
| **生态原生** | 直接调用 Amazon Advertising API，非爬虫方案，数据权威、更新实时 |
| **权限隔离** | 与 SP-API 分离的 LWA 应用体系，最小权限原则降低跨服务风险 |
| **零状态设计** | 每次请求刷新 Token，无持久化凭证残留，适合 CI/CD 场景 |
| **轻量集成** | 单 Node.js 脚本驱动，无需复杂 SDK 依赖 |
潜在局限
- 范围受限：当前仅支持 Sponsored Products，不含 Sponsored Brands/Display
- 无本地缓存：高频调用可能触发 API 限流；生产环境需自行实现 Token 缓存
- 凭证配置复杂：需手动维护
amazon-ads-api.json，多账户场景下配置管理成本较高 - 无内置重试：网络异常时需外层代理兜底
适合人群
- 亚马逊品牌卖家与广告代理商的技术运营团队
- 需将广告数据汇入内部数仓的电商数据工程师
- 构建自动化广告调价/预算预警系统的开发者
常规风险
| 风险项 | 说明 |
|--------|------|
| 凭证泄露 | JSON 凭证文件若误提交至仓库，可能导致广告账户被恶意操作 |
| 预算误操作 | 自动化脚本若逻辑缺陷，可能造成超预算投放或广告误停 |
| API 限流 | 未控制调用频率将触发 429 错误，影响业务连续性 |
| 区域配置错误 | `region` 字段填写错误将导致请求路由至错误端点，数据不可达 |
使用建议
1. 将凭证文件加入 .gitignore，并通过环境变量 AMAZON_ADS_PATH 外置配置
2. 生产部署前封装 Token 缓存层，减少 LWA 刷新频率
3. 关键操作（如预算修改）增加人工确认或熔断机制
4. 定期审计 profileId 与实际广告账户的归属关系，防止跨账户误操作