A specialized read-only tool for fetching Amazon Advertising entities like campaigns, ad groups, and keywords with automated pagination.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install linkfox-amazon-ads-entity
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 linkfox-amazon-ads-entity 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 Entity Query?
This skill serves as a robust read-only interface for interacting with the Amazon Ads API, specifically focusing on Sponsored Products (SP) and Sponsored Brands (SB). It eliminates the complexity of manual token management and multi-page data retrieval by automating the pagination process. By utilizing Openclaw Skills for your advertising operations, you can ensure consistent data formatting even when dealing with inconsistent API filter requirements across different Amazon endpoints.
Designed for developers and analysts, it focuses strictly on metadata retrieval—such as IDs, names, and states—rather than performance metrics. This specialized focus makes it an ideal component for building high-performance advertising dashboards or automated auditing tools when combined with reporting extensions.
Amazon Ads Entity Query Use Cases
- Auditing active Sponsored Products campaigns and ad groups across multiple regions.
- Exporting comprehensive keyword and negative keyword lists for account health checks.
- Mapping ASINs to specific product ads to verify catalog coverage.
- Retrieving entity IDs to join with performance data from other Openclaw Skills reporting tools.
- Monitoring campaign states and targeting types across global Amazon storefronts.
How Amazon Ads Entity Query Works
- The process begins by resolving a valid profileId and region through the mandatory authentication dependency.
- The skill selects the appropriate API version (SP v3 or SB v4) based on the target entity requested.
- Input filters are automatically normalized to meet Amazon's strict object or array formatting requirements.
- The skill executes the request and automatically follows pagination tokens until all data is fetched or the safety limit is reached.
- The final output is returned as a structured JSON object containing the full entity list and metadata about the fetch operation.
Amazon Ads Entity Query Setup
This skill requires the linkfox-amazon-ads-auth skill to be installed and configured. Before running queries, you must use the auth skill to retrieve a valid profileId.
To list active campaigns, use the following CLI command:
python scripts/sp/list_campaigns.py '{"profileId": 123456789, "region": "NA", "stateFilter": {"include": ["ENABLED"]}}'
Amazon Ads Entity Query Data Schema & Taxonomy
The skill returns a standardized response object. Depending on the script used, the primary data key will vary:
| Script Entity | Response Key | Description |
|---|---|---|
| Campaigns | campaigns | List of campaign metadata objects |
| Ad Groups | adGroups | List of ad group configurations |
| Keywords | keywords | Keywords and match types (SP only) |
| Product Ads | productAds | ASIN/SKU specific ad data (SP only) |
| Targets | targetingClauses | Product targeting metadata (SP only) |
| Ads | ads | Creative and ad metadata (SB only) |
All responses include total, pagesFetched, and truncated fields to indicate the volume of data returned by these Openclaw Skills.
Amazon Ads Entity Query Advanced Features
- Intelligent Auto-Pagination: Fetches up to 5,000 records (50 pages) automatically using the fetchAll parameter.
- Filter Normalization: Corrects common input errors for matchTypeFilter and expressionTypeFilter automatically.
- Client-Side Filtering: Enables filtering by ASIN and SKU for Sponsored Products ads even where the native API lacks support.
- Extended Data Support: Option to include enriched metadata fields via the includeExtendedDataFields parameter.
- Multi-Account Safety: Built-in logic to prevent ambiguous profile calls in multi-authorized account environments.
SKILL.md
Loading
Related Openclaw Skills
PreFlyte
PreFlyte provides an evidence-based financial intelligence layer that allows AI agents to analyze DeFi market data and risk before executing capital deployment.
Test Engineer
A specialized AI agent skill for designing comprehensive testing strategies and automating high-quality test suites across the entire software development lifecycle.
Meituan Errands Assistant
An automated assistant for managing Meituan Errands, supporting document delivery, item pickup, and purchasing tasks through direct API integration.
Cooler Master
A specialized skill for analyzing Cooler Master's impact on PC aesthetics, cooling technology evolution, and the global DIY gaming hardware market.
Terraform Engineer
An expert AI agent skill for designing, implementing, and managing enterprise-grade infrastructure as code using Terraform across multi-cloud environments.
Test Automator
A senior test automation expert focused on building scalable frameworks, CI/CD integration, and high-coverage automated testing solutions.
Featured*
