An Amazon Advertising API wrapper enabling live PPC campaign monitoring, automated keyword bid adjustment, and budget waste reduction.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install amazon-ads-manager
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install amazon-ads-manager using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Amazon Ads Manager?
The Amazon Ads Manager skill is a professional integration designed for sellers, agencies, and developers wanting to manage Amazon Advertising campaigns programmatically or via AI. This tool bridges the gap between raw advertising metrics and actionable optimizations, allowing you to fetch live campaign, keyword, and search term performance data on demand. By leveraging Openclaw Skills, developers and merchant operators can build advanced flows to automate routine optimizations, isolate wasted budget, and restructure target bids.
With this tool, you gain direct access to calculated metrics such as CTR%, CPC, ACOS%, and ROAS. Rather than spending hours manually filtering spreadsheets in Seller Central, the skill empowers AI agents to scan performance reports, adjust keyword bids, pause underperforming targets, and dynamically add negative matching terms to maximize the profitability of your sponsored ads.
Amazon Ads Manager Use Cases
- PPC Performance Audits: Instantly run campaign-level or keyword-level checks to isolate high-ACOS campaigns and identify targets consuming ad spend without generating conversions.
- Dynamic Bid Optimization: Automatically adjust keyword bids up or down using strict margin rules and target ACOS benchmarks.
- Negative Keyword Harvesting: Analyze actual buyer search term reports to identify irrelevant, low-converting queries and immediately add them as campaign-level negative exact or phrase targets.
- Inventory & Budget Control: Enable, pause, or archive keywords and campaigns programmatically based on real-time performance calculations.
How Amazon Ads Manager Works
- Authenticate and Retrieve Profiles: The skill reads your Amazon Ads API credentials from a local configuration, automatically listing all linked ad profiles to target specific regional marketplaces.
- Generate Asynchronous Reports: Requests and compiles campaign, keyword, or search term performance data directly from the official Amazon Advertising API.
- Perform Advanced Calculations: Enriches the raw API response by calculating key metrics including click-through rates (CTR%), cost-per-click (CPC), ACOS%, and return on ad spend (ROAS).
- Apply Rule-Based Audits: Filters and flags items based on performance rules (such as identifying pure spend waste or recommending bid reductions).
- Execute Direct Updates: Pushes structural changes back to the Amazon Advertising platform, modifying bids, altering states, or applying negative matches with explicit guardrails.
Amazon Ads Manager Setup
To get started with Amazon Ads Manager, set up your credentials by creating a .env file in the skill's root directory:
AMAZON_ADS_CLIENT_ID=amzn1.application-oa2-client.xxx
AMAZON_ADS_CLIENT_SECRET=xxx
AMAZON_ADS_REFRESH_TOKEN=Atzr|xxx
AMAZON_ADS_PROFILE_ID= # Find this via scripts/ads.py profiles
AMAZON_ADS_REGION=NA # NA | EU | FE
Executing Commands
1. Retrieve and Link Marketplace Profile IDs
uv run <skill-dir>/scripts/ads.py profiles
2. Check Active Campaigns
uv run <skill-dir>/scripts/ads.py campaigns
3. Run Search Term Harvesting Reports (30 days)
uv run <skill-dir>/scripts/ads.py report searchterms --days 30
4. Apply a Negative Keyword to a Campaign
uv run <skill-dir>/scripts/ads.py add-negative <campaign_id> "irrelevant search query" --match exact
Amazon Ads Manager Data Schema & Taxonomy
The Amazon Ads Manager skill structures reports by aggregating raw advertising performance statistics and generating advanced calculated fields. Results are systematically sorted by total ad spend in descending order.
Report Output Schema
| Attribute | Format | Description |
|---|---|---|
impressions |
Integer | Total number of ad impressions served |
clicks |
Integer | Total click count accumulated by the target |
cost |
Float | Total accumulated click cost (Spend) |
attributedSales7d |
Float | Calculated sales revenue generated within 7 days of click |
attributedUnitsOrdered7d |
Integer | Total units ordered within a 7-day conversion window |
acos_pct |
Float | Advertising Cost of Sales percentage (Cost / Sales * 100) |
roas |
Float | Return on Ad Spend (Sales / Cost) |
ctr_pct |
Float | Click-Through Rate (Clicks / Impressions * 100) |
cpc |
Float | Average Cost-Per-Click |
Recommended Performance Benchmark Rules
- Sponsored Products Manual: Target ACOS 25–35%
- Sponsored Products Auto: Target ACOS 35–45%
- Sponsored Brands: Target ACOS 40–55%
Amazon Ads Manager Advanced Features
- Asynchronous API Fetching: Built-in async report handlers prevent command-line timeouts when fetching heavy keyword and search term datasets from Amazon.
- Dynamic Rules Engine: Supports logical decision matrixing (e.g., automatically reducing bids by 20% if current ACOS exceeds target metrics by more than 1.5x).
- Dual-State State Modification: Supports direct status alterations allowing you to dynamically pause, enable, or archive keywords and entire campaigns.
- Safe Execution Guardrails: Employs mandatory confirmation prompts before running writing tasks (
set-bid,set-state,add-negative) to prevent unintended adjustments.
SKILL.md
Loading
Related Openclaw Skills
kite-slim
An advanced AI fitness and diet companion that dynamically calculates daily step goals based on yesterday's calorie surplus, driving consistent health habits through structured closed-loop coaching.
Agent Routing Waste Audit
An intelligent, read-only audit tool for AI agent workflows designed to detect cost inefficiencies, overpowered model routing, and retry loop waste.
IP Character Design to 3D Print Pipeline
An automated end-to-end AI pipeline that converts character prompts into production-ready, manifold STL files for 3D printing.
Recruitment Fullstack V4
Recruitment Fullstack V4 is an advanced, committee-level AI hiring framework that automates and structures the entire interview lifecycle from intake checking to calibration and final decision-making.
China Travel Group Bus Query
A cross-border bus schedule and ticket status querying agent skill tailored for the China Travel Group (hkctgbus) network.
PlayCanvas
A comprehensive developer guide enabling AI coding assistants to construct, optimize, and launch high-performance 3D web applications and games using the PlayCanvas engine and editor environment.
Featured*
