apple-search-ads

Automate Apple Search Ads campaign management via CLI with JWT authentication.

18|7|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/cameronehrlich/apple-search-ads-cli --skill apple-search-ads-cameronehrlich
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-search-ads
Source: https://github.com/cameronehrlich/apple-search-ads-cli/tree/main
Command: npx skills add https://github.com/cameronehrlich/apple-search-ads-cli --skill apple-search-ads-cameronehrlich

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple Search Ads campaign management often requires manual credential handling, setup, and monitoring across multiple campaigns. This Skill streamlines those tasks by providing a CLI to configure API credentials, initialize the recommended 4-campaign structure, route keywords automatically, and generate performance reports.

Core Features & Use Cases

  • End-to-end campaign management following Apple's 4-campaign structure (Brand, Category, Competitor, Discovery) for consistent ad spend and optimization.
  • Automatic keyword routing, negative keywords, promotions from Discovery to exact campaigns, and comprehensive reporting at campaign, ad group, and keyword levels.
  • Multi-app support with easy app switching and robust error handling (including token refresh and retries).

Quick Start

Configure your ASA credentials and app settings, then run asa campaigns setup to create the 4-campaign structure and start managing campaigns.

Frequently Asked Questions about apple-search-ads

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Apple Search Ads campaign management across multiple apps?

Automate Apple Search Ads campaign management by using a CLI to configure API credentials, initialize a 4-campaign structure, route keywords, and generate performance reports across single or multi-app setups. The process relies on JWT-based authentication with automatic token refresh.

What is Apple's four-campaign structure for Apple Search Ads?

The Apple Search Ads four-campaign structure consists of Brand, Category, Competitor, and Discovery campaigns. It organizes ad spend and optimization consistently, allowing automatic keyword routing and promotions from Discovery to exact campaigns.

How do I set up Apple Search Ads API credentials for a CLI workflow?

Set up Apple Search Ads API credentials by configuring JWT-based authentication within the CLI environment. The system implements robust error handling, automatic token refresh, pagination, and retry logic to ensure reliable API interactions.

Can I generate performance reports for Apple Search Ads campaigns and ad groups?

Generate comprehensive performance reports for Apple Search Ads at the campaign, ad group, and keyword levels. The CLI automates data retrieval across the four-campaign structure to monitor ad spend and optimization.

How do I handle Apple Search Ads API token expiration and pagination errors?

Handle Apple Search Ads API token expiration and pagination errors through built-in robust error handling. The CLI automatically manages token refresh, pagination, and retry logic to maintain reliable API interactions.

How do I route keywords and set up negative keywords in Apple Search Ads?

Route keywords and set up negative keywords in Apple Search Ads automatically via the CLI. It promotes keywords from Discovery to exact campaigns and manages routing across the Brand, Category, Competitor, and Discovery campaign structure.