skill-amazon-ads

用途

该技能为 OpenClaw 智能体提供操作 Amazon Ads API v3 的能力，主要用于管理亚马逊 Sponsored Products 广告。借助它，智能体可以列出广告账户的 profiles、查看 SP 广告活动、检查预算，并拉取广告表现数据。适合需要在智能体流程中查询或监控亚马逊广告基础信息的场景。

主要能力

列出所有广告主 profile（使用 --profiles）。
列出所有 SP 广告活动（使用 --campaigns）。
输出活跃广告活动与预算摘要（使用 --summary）。
将广告活动数据保存到文件，例如：node scripts/ads.js --campaigns --out c.json。

使用方式

1. 创建凭据文件

需要创建一个 Amazon Ads API 凭据文件，内容示例如下：

{
  "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）。

2. 区域与端点

na → advertising-api.amazon.com
eu → advertising-api-eu.amazon.com
fe → advertising-api-fe.amazon.com

3. 获取 Profile ID

运行以下命令列出 profile：

node scripts/ads.js --profiles

复制对应品牌/站点的 profileId，并加入凭据文件。

4. 脚本命令

ads.js — 广告活动与摘要：

node scripts/ads.js --profiles                # 列出所有广告主 profile
node scripts/ads.js --campaigns               # 列出所有 SP 广告活动
node scripts/ads.js --summary                 # 活跃广告活动 + 预算摘要
node scripts/ads.js --campaigns --out c.json  # 保存到文件

凭据字段说明

字段	说明
lwaClientId	广告应用 client ID（与 SP-API 分开）
lwaClientSecret	广告应用 client secret
refreshToken	LWA refresh token
profileId	广告 profile ID（来自 `--profiles`）
region	`na`、`eu` 或 `fe`

限制与注意事项

Ads API 使用与 SP-API 不同的 LWA 应用，因此 client ID/secret 也不同。
所有广告活动操作都需要 Profile ID。
每次请求都会重新获取 token（对 CLI 使用没有缓存开销）。
若用于生产环境或高频使用，需要自行添加 token 缓存。

技能介绍

用途