Amazon Ads API Skill
Manage Amazon Sponsored Products campaigns from your OpenClaw agent — list profiles, view campaigns, check budgets, and pull performance data.
Setup
1. Create credentials file
{
"lwaClientId": "amzn1.application-oa2-client.YOUR_CLIENT_ID",
"lwaClientSecret": "YOUR_CLIENT_SECRET",
"refreshToken": "Atzr|YOUR_REFRESH_TOKEN",
"profileId": "YOUR_ADS_PROFILE_ID",
"region": "eu"
}
Save as
amazon-ads-api.json. Set
AMAZON_ADS_PATH env var to point to it (default:
./amazon-ads-api.json).
Regions & endpoints:
- -
na → INLINECODE4 - INLINECODE5 → INLINECODE6
- INLINECODE7 → INLINECODE8
2. Get your Profile ID
node scripts/ads.js --profiles
Copy the
profileId for your brand/marketplace and add it to the credentials file.
Scripts
ads.js — Campaigns & Summary
node scripts/ads.js --profiles # list all advertiser profiles
node scripts/ads.js --campaigns # list all SP campaigns
node scripts/ads.js --summary # active campaigns + budgets summary
node scripts/ads.js --campaigns --out c.json # save to file
Credentials Schema
| Field | Description |
|---|
| INLINECODE11 | Ads app client ID (separate from SP-API) |
| INLINECODE12 |
Ads app client secret |
|
refreshToken | LWA refresh token |
|
profileId | Advertising profile ID (from
--profiles) |
|
region |
na,
eu, or
fe |
Notes
- - Ads API uses a separate LWA app from SP-API — different client ID/secret
- Profile ID is required for all campaign operations
- Tokens are fetched fresh per request (no caching overhead for CLI use)
- For production/high-frequency use, add token caching
Related
Amazon Ads API 技能
通过您的 OpenClaw 代理管理亚马逊赞助商品广告活动 — 列出档案、查看广告活动、检查预算并拉取表现数据。
设置
1. 创建凭证文件
json
{
lwaClientId: amzn1.application-oa2-client.YOUR
CLIENTID,
lwaClientSecret: YOUR
CLIENTSECRET,
refreshToken: Atzr|YOUR
REFRESHTOKEN,
profileId: YOUR
ADSPROFILE_ID,
region: eu
}
保存为 amazon-ads-api.json。设置 AMAZONADSPATH 环境变量指向该文件（默认：./amazon-ads-api.json）。
区域与端点：
- - na → advertising-api.amazon.com
- eu → advertising-api-eu.amazon.com
- fe → advertising-api-fe.amazon.com
2. 获取您的档案 ID
bash
node scripts/ads.js --profiles
复制您品牌/市场的 profileId 并添加到凭证文件中。
脚本
ads.js — 广告活动与摘要
bash
node scripts/ads.js --profiles # 列出所有广告主档案
node scripts/ads.js --campaigns # 列出所有赞助商品广告活动
node scripts/ads.js --summary # 活跃广告活动 + 预算摘要
node scripts/ads.js --campaigns --out c.json # 保存到文件
凭证架构
| 字段 | 描述 |
|---|
| lwaClientId | 广告应用客户端 ID（与 SP-API 分开） |
| lwaClientSecret |
广告应用客户端密钥 |
| refreshToken | LWA 刷新令牌 |
| profileId | 广告档案 ID（来自 --profiles） |
| region | na、eu 或 fe |
备注
- - 广告 API 使用与 SP-API 不同的 LWA 应用 — 不同的客户端 ID/密钥
- 所有广告活动操作都需要档案 ID
- 令牌按请求新鲜获取（CLI 使用无缓存开销）
- 对于生产/高频使用，请添加令牌缓存
相关
