A read-only CLI tool for the Spotify Ads API (v3) that enables deep reporting, audience estimation, and campaign analysis.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install spotify-ads-cli
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 spotify-ads-cli 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 Spotify Ads CLI?
The Spotify Ads CLI is a robust technical tool designed to interface with the Spotify Ads API v3, allowing developers and marketers to extract granular performance data directly from the terminal. As a powerful addition to the Openclaw Skills library, it simplifies the process of querying business accounts, tracking ad spend, and analyzing campaign hierarchies. The skill provides a read-only gateway to critical advertising metrics, ensuring secure data exploration without accidental modification of live campaigns.
By integrating this tool into your Openclaw Skills workflow, you can programmatically access everything from aggregate performance snapshots to complex demographic insight reports. It handles the nuances of the Spotify API, such as micros-to-currency conversion and async CSV report generation, making it an essential utility for data-driven advertising strategies.
Spotify Ads CLI Use Cases
- Monitoring daily Spotify ad spend and performance metrics across multiple ad accounts.
- Extracting demographic insights based on age, gender, and platform for audience optimization.
- Performing pre-campaign planning by estimating audience reach and bid ranges for specific targeting criteria.
- Auditing creative assets and ads status to ensure campaign health.
- Automating the generation and retrieval of large-scale CSV reports for external data visualization.
How Spotify Ads CLI Works
- The user provides a Spotify OAuth access token via environment variables or a local configuration file to authenticate with the Spotify Ads API.
- The skill identifies accessible businesses and their associated ad accounts using discovery commands.
- Based on user queries, the CLI requests specific data points such as aggregate reports, targeting options, or asset metadata.
- For reporting, the skill handles pagination via continuation tokens or initiates asynchronous CSV generation requests.
- All retrieved data is output as pretty-printed or compact JSON, ready for analysis or further processing within Openclaw Skills.
Spotify Ads CLI Setup
To utilize this skill, first install the CLI globally using npm:
npm install -g spotify-ads-cli
Authentication requires a Spotify Developer App with Ads API access. You can configure the skill by setting an environment variable:
export SPOTIFY_ADS_ACCESS_TOKEN='your_access_token'
Alternatively, create a credentials file at ~/.config/spotify-ads-cli/credentials.json with the following structure:
{
"access_token": "your_access_token"
}
Spotify Ads CLI Data Schema & Taxonomy
The skill organizes data following the Spotify Ads entity hierarchy. All outputs default to JSON format.
| Level | Data Included |
|---|---|
| Business | ID, Name, and associated Ad Account links. |
| Ad Account | Status, currency, and high-level configuration. |
| Campaign / Ad Set | Budget (converted from micros), schedule, and targeting specs. |
| Reporting | Impressions, clicks, reach, and spend in standard units. |
| Targeting | JSON-based specification for geo, age, and interest filters. |
Spotify Ads CLI Advanced Features
- Support for asynchronous CSV report generation with automated polling for status updates.
- Audience and bid range estimation tools for precise budget planning.
- Detailed diagnostic reporting for measurement pixels and datasets.
- Pagination management for large campaigns using offset and limit parameters.
- Seamless integration with other Openclaw Skills for automated marketing reporting pipelines.
SKILL.md
Loading
Related Openclaw Skills
Feishu Notifier Core
A lightweight, secure bridge for sending automated notifications to Feishu (Lark) through Openclaw Skills.
Quantum Agent Memory
A quantum-optimized memory framework that uses QAOA to solve clustering, compaction, and synergy-based recall problems for AI agents.
X Ads CLI
A read-only command-line interface for querying X Ads API v12 to analyze campaign performance and account structure.
Executive Chief of Staff
An AI-powered chief of staff designed to optimize executive decision-making through automated briefings, meeting prep, and strategic information gathering.
Snapchat Ads CLI
A comprehensive read-only command-line interface for querying the Snapchat Marketing API to analyze ad performance and account structure.
Bid Monitor V2.0
An automated business intelligence radar that crawls, filters, and pushes construction and EPC bidding opportunities directly to enterprise communication platforms.
Featured*
