A powerful read-only command-line interface for querying Apple Search Ads Campaign Management API data and performance reports.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install apple-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 apple-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 Apple Ads CLI?
The Apple Ads CLI skill provides a specialized interface for interacting with the Apple Search Ads Campaign Management API (v5). Designed for developers and growth marketers using Openclaw Skills, it allows for seamless, read-only access to campaign structures, keyword performance, and budget orders. By integrating this skill into your workflow, you can programmatically inspect ad groups, keywords, and account-level permissions without navigating the web UI.
This integration for Openclaw Skills is particularly valuable for users who need to automate data extraction or perform complex analysis on App Store advertising metrics. It simplifies the process of generating performance snapshots, auditing campaign setups, and verifying app metadata through a standardized technical interface.
Apple Ads CLI Use Cases
- Tracking real-time Apple Search Ads campaign performance and ad spend metrics.
- Auditing keyword match types and negative keyword lists across multiple ad groups.
- Generating granular reports segmented by device class, age range, gender, or geographic region.
- Verifying iOS app eligibility for promotion using Adam IDs.
- Monitoring budget orders and organization-level access controls.
How Apple Ads CLI Works
- The user configures authentication using an OAuth2 access token and a numeric Organization ID.
- Openclaw Skills utilizes the
apple-ads-clito fetch authenticated user details and accessible organizations via themeandaclcommands. - Upon user request, the skill queries the Apple Search Ads hierarchy, moving from campaigns down to specific ads or keywords.
- For reporting, the skill sends POST requests to the API with user-defined date ranges, granularity (HOURLY, DAILY, etc.), and grouping parameters.
- The CLI returns structured JSON data which Openclaw Skills processes to provide actionable insights or summaries.
Apple Ads CLI Setup
To enable this skill within your Openclaw Skills environment, first install the CLI globally:
npm install -g apple-ads-cli
Next, set up your credentials. You can use environment variables or a configuration file located at ~/.config/apple-ads-cli/credentials.json:
{
"access_token": "your_oauth_token",
"org_id": "your_org_id"
}
Verify your setup by running apple-ads-cli me to confirm connectivity with the Apple Search Ads API.
Apple Ads CLI Data Schema & Taxonomy
The skill interacts with the Apple Search Ads v5 schema, organizing data into the following hierarchy available to Openclaw Skills:
| Entity | Key Fields | Description |
|---|---|---|
| Organization | orgId, parentOrgId |
The top-level account identifier. |
| Campaign | id, name, budget |
High-level container for advertising goals. |
| Ad Group | campaignId, id |
Contains ads and targeting keywords. |
| Keywords | text, matchType |
Targeting and negative keywords for search queries. |
| Metrics | amount, currency |
Monetary values returned as distinct currency objects. |
Apple Ads CLI Advanced Features
- Support for complex multi-dimensional reporting using the
--group-byflag for country, device, and demographics. - Automated app discovery using the
search-appscommand to find Adam IDs for any developer. - Flexible data granularity options ranging from HOURLY to MONTHLY for trend analysis.
- Comprehensive budget order tracking to manage financial allocations across the organization.
- Read-only safety, ensuring that performance analysis within Openclaw Skills never accidentally modifies live campaign settings.
SKILL.md
Loading
Related Openclaw Skills
Deep Writer
Deep Writer is an adaptive workflow skill designed to transform messy notes, transcripts, or topics into high-quality, structured long-form content through a staged editorial process.
ShareOne Skill
A streamlined skill for AI agents to host and share generated documents via persistent public URLs with optional security features.
V.A.R. Protocol
A professional safety and versioning protocol for AI agents to manage non-destructive updates and reliable asset recovery.
Hotspot Radar
A cross-platform hot search aggregator and trend analysis tool for real-time social media monitoring.
Weekly Report Generator
An AI-driven automation tool for Openclaw Skills that aggregates GitHub activity, calendar events, and task lists into polished weekly reports.
Amazon Ads Open CLI
A professional read-only CLI interface for the Amazon Advertising API to audit campaigns, track DSP orders, and generate performance reports.
Featured*
