用途
本技能面向 OpenClaw 智能体，提供 Amazon Ads API v3 的对接能力，用于从智能体中管理亚马逊 Sponsored Products 广告，包括列出广告主档案、查看广告活动、检查预算以及拉取广告表现数据。
主要能力
- 列出所有广告主档案（profiles）
- 列出所有 Sponsored Products 广告活动（campaigns）
- 汇总活跃广告活动与预算（summary）
- 将广告活动数据保存到文件
使用方式
1. 创建凭证文件
创建 credentials 文件，内容如下：
{
"lwaClientId": "amzn1.application-oa2-client.YOUR_CLIENT_ID",
"lwaClientSecret": "YOUR_CLIENT_SECRET",
"refreshToken": "Atzr|YOUR_REFRESH_TOKEN",
"profileId": "YOUR_ADS_PROFILE_ID",
"region": "eu"
}
保存为 amazon-ads-api.json。设置环境变量 AMAZON_ADS_PATH 指向该文件（默认：./amazon-ads-api.json）。
区域与端点：
- na → advertising-api.amazon.com
- eu → advertising-api-eu.amazon.com
- fe → advertising-api-fe.amazon.com
2. 获取 Profile ID
运行：
node scripts/ads.js --profiles
复制对应品牌/市场的 profileId，并添加到凭证文件中。
3. 脚本命令
广告活动与汇总（ads.js）：
node scripts/ads.js --profiles # 列出所有广告主档案
node scripts/ads.js --campaigns # 列出所有 SP 广告活动
node scripts/ads.js --summary # 活跃广告活动 + 预算汇总
node scripts/ads.js --campaigns --out c.json # 保存到文件
凭证字段说明
- lwaClientId：Ads 应用客户端 ID（独立于 SP-API）
- lwaClientSecret：Ads 应用客户端密钥
- refreshToken：LWA 刷新令牌
- profileId：广告档案 ID（通过 --profiles 获取）
- region：na、eu 或 fe
适用场景
适用于通过 OpenClaw 智能体管理亚马逊 Sponsored Products 广告的广告主，包括查看广告主档案、广告活动、预算与表现数据等操作。
限制与注意事项
- Ads API 使用独立于 SP-API 的 LWA 应用，客户端 ID/密钥不同
- 所有广告活动操作都需要 Profile ID
- 令牌按每次请求获取（CLI 使用无缓存开销）
- 生产或高频使用场景，建议添加令牌缓存
相关技能：skill-amazon-spapi — 订单、库存与商品列表。