skill-amazon-ads-optimizer
OpenClaw Agent Skill -- Amazon Ads API v3 integration. List profiles, manage Sponsored Products campaigns, monitor budgets and performance -- all from your AI agent.
What It Does
| Script | What it does |
|---|---|
ads.js |
List profiles, view all campaigns, get budget summary |
Automate your daily advertising operations:
- Pull live campaign status and budgets
- Identify active vs paused campaigns
- Export campaign data for analysis
- Feed into bid optimization workflows
Quick Start
# 1. Create credentials file: amazon-ads-api.json
{
"lwaClientId": "amzn1.application-oa2-client.YOUR_ADS_CLIENT_ID",
"lwaClientSecret": "YOUR_ADS_SECRET",
"refreshToken": "Atzr|YOUR_TOKEN",
"profileId": "YOUR_ADS_PROFILE_ID",
"region": "eu"
}
# 2. Get your profile ID
node scripts/ads.js --profiles
# 3. View all campaigns
node scripts/ads.js --campaigns
# 4. Get budget summary
node scripts/ads.js --summary
{
"lwaClientId": "amzn1.application-oa2-client.YOUR_ADS_CLIENT_ID",
"lwaClientSecret": "YOUR_ADS_SECRET",
"refreshToken": "Atzr|YOUR_TOKEN",
"profileId": "YOUR_ADS_PROFILE_ID",
"region": "eu"
}
# 2. Get your profile ID
node scripts/ads.js --profiles
# 3. View all campaigns
node scripts/ads.js --campaigns
# 4. Get budget summary
node scripts/ads.js --summary
Usage Examples
# List all advertiser profiles (run first to get your profileId)
node scripts/ads.js --profiles
# List all Sponsored Products campaigns
node scripts/ads.js --campaigns
node scripts/ads.js --campaigns --out campaigns.json
# Summary: active campaigns + total daily budget
node scripts/ads.js --summary
node scripts/ads.js --profiles
# List all Sponsored Products campaigns
node scripts/ads.js --campaigns
node scripts/ads.js --campaigns --out campaigns.json
# Summary: active campaigns + total daily budget
node scripts/ads.js --summary
Example output:
Amazon Ads Summary
Active campaigns : 3
Paused campaigns : 1
Total daily budget: 15.00
[ENABLED] Manual | Exact | Product A -- 5/day (MANUAL)
[ENABLED] Manual | Phrase | Product B -- 5/day (MANUAL)
[ENABLED] Auto | Launch -- 5/day (AUTO)
[PAUSED] Old Campaign -- 0/day (MANUAL)
API Endpoints by Region
| Region | Endpoint |
|---|---|
| North America | advertising-api.amazon.com |
| Europe / Middle East | advertising-api-eu.amazon.com |
| Far East | advertising-api-fe.amazon.com |
Important Notes
- The Ads API uses a separate LWA app from SP-API -- different Client ID/Secret
- You must set
profileIdin credentials (run--profilesto find yours) - Tokens are fetched fresh per run -- no stale token issues
- Requires
Advertisingpermission scope on your LWA app
Part of the Zero2AI Skill Library
Built and battle-tested in production. Part of a growing open-source library of AI agent skills for e-commerce automation.
- skill-amazon-spapi -- Orders, inventory & listings
- skill-amazon-listing-optimizer -- Image audit & fix