LaunchKit · 2026
Back to Skills

apple-search-ads-skill

Manage Apple Search Ads campaigns, ad groups, keywords, and reports via the asa-cli tool.

2
469 downloads
by @trebuhs

Setup & Installation

openclaw skills install @trebuhs/apple-search-ads-skill

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install apple-search-ads-skill

What This Skill Does

Manage Apple Search Ads campaigns, ad groups, keywords, and reports through the asa-cli command-line tool. Covers the full Campaign Management API v5, including keyword bidding, negative keywords, and performance reports broken down by date, country, and device.

Handles Apple Search Ads API v5 authentication and pagination automatically, so you can manage campaigns without writing custom HTTP code.

When to use it

  • Pull last month's install and CPI report by country for a live campaign
  • Add negative keywords to an ad group to block irrelevant search terms
  • Adjust keyword bids across multiple ad groups before a seasonal push
  • Create a new campaign targeting specific countries for an app launch
  • Compare search term performance to find high-converting queries

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Get keyword performance for campaign 123456 for the past 30 days

AGENT
  1. 1Run asa-cli whoami -o json to confirm the org ID
  2. 2Run asa-cli reports keywords --campaign-id 123456 --start-date 2026-02-17 --end-date 2026-03-19 -o json
  3. 3Pipe the output through jq to extract keyword text, totalInstalls, tapInstallCPI, and totalInstallRate
  4. 4Sort results by tapInstallCPI to surface the most and least efficient keywords
OUTPUT

A ranked list of keywords with install counts, tap-through install rate, and cost per install for the 30-day window

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

Apple Search Ads accountApple Search Ads API credentials: client ID, team ID, key ID, and private key file (generated in the ASA console)asa-cli installed