Skip to content
Skills Library
Marketing & content · Tool integration

apple-ads-cli

/apple-ads-cli

Use the ASA CLI for Apple Ads Platform API v1 and legacy Campaign Management API v5. Trigger when Codex needs exact CLI syntax for campaigns, ad groups, ads, creatives, keywords, negatives, budgets, accounts, apps, Apple Maps brands or locations, reports, impression share, search-term popularity, recommendations, suggestions, change history, v5 migration or fallback, or this repository's strategy audit, manual search-results, Maximize Conversions, campaign-structure, and optimization workflows. Also use when mapping an Apple SDK endpoint to its CLI wrapper or safely executing Apple Ads mutatio

Licence
MIT
Last repository change
19.09.2026

Assessment and security

95/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
99
Scripts
63
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 19.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 63 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: asa_cli/__init__.py, asa_cli/api.py, asa_cli/commands/__init__.py, asa_cli/commands/acl.py, asa_cli/commands/adgroups.py, asa_cli/commands/ads.py, asa_cli/commands/budget.py, asa_cli/commands/campaigns.py

What it does and when to use it

Use the ASA CLI for Apple Ads Platform API v1 and legacy Campaign Management API v5. Trigger when Codex needs exact CLI syntax for campaigns, ad groups, ads, creatives, keywords, negatives, budgets, accounts, apps, Apple Maps brands or locations, reports, impression share, search-term popularity, recommendations, suggestions, change history, v5 migration or fallback, or this repository's strategy audit, manual search-results, Maximize Conversions, campaign-structure, and optimization workflows. Also use when mapping an Apple SDK endpoint to its CLI wrapper or safely executing Apple Ads mutatio

Original author description

Use the ASA CLI for Apple Ads Platform API v1 and legacy Campaign Management API v5. Trigger when Codex needs exact CLI syntax for campaigns, ad groups, ads, creatives, keywords, negatives, budgets, accounts, apps, Apple Maps brands or locations, reports, impression share, search-term popularity, recommendations, suggestions, change history, v5 migration or fallback, or this repository's strategy audit, manual search-results, Maximize Conversions, campaign-structure, and optimization workflows. Also use when mapping an Apple SDK endpoint to its CLI wrapper or safely executing Apple Ads mutatio

How it works

  1. Start here
  2. Choose the command surface
  3. Select a strategy workflow
  4. Route to the smallest reference
  5. Execute safely
  6. Check catalog freshness
Original SKILL.md headings · 89 lines, 749 words
SKILL.md preview
---
name: apple-ads-cli
description: Use the ASA CLI for Apple Ads Platform API v1 and legacy Campaign Management API v5. Trigger when Codex needs exact CLI syntax for campaigns, ad groups, ads, creatives, keywords, negatives, budgets, accounts, apps, Apple Maps brands or locations, reports, impression share, search-term popularity, recommendations, suggestions, change history, v5 migration or fallback, or this repository's strategy audit, manual search-results, Maximize Conversions, campaign-structure, and optimization workflows. Also use when mapping an Apple SDK endpoint to its CLI wrapper or safely executing Apple Ads mutations.
---

# Apple Ads CLI

Use this skill to select an exact command from the generated catalog and run it with the required context and safety checks. Do not reconstruct command syntax from memory or probe live Apple endpoints to discover inputs.

## Start here

Work from the repository root. If `uv` is not on `PATH` in Cameron's environment, use `/Users/cameronehrlich/.local/bin/uv`.

1. Find the operation before loading detailed documentation:

   ```bash
   uv run python scripts/lookup_command.py "search term popularity"
   uv run python scripts/lookup_command.py --sdk-method search_term_popularity_query
   uv run python scripts/lookup_command.py --resource recommendations
   uv run python scripts/lookup_command.py --version v5 --command "asa v5 reports custom"
   ```

2. Read the complete reference named by the lookup result.
3. Read [configuration-and-context.md](references/configuration-and-context.md) when credentials, account scope, App Store versus Maps surface, or request bodies matter.
4. Read [safety-and-output-contracts.md](references/safety-and-output-contracts.md) before any mutation, unattended operation, report comparison, or machine-readable integration.
5. Execute only commands whose generated entry says `implemented`. Treat `inventory-only`, `planned`, `blocked`, and `unverified` as documentation, not runnable proof.

## Choose the command surface

- Prefer `asa <resource> <action>` for Platform API v1 endpoint wrappers.
- Use `asa v5 ...` only when the user explicitly requests v5 or the required v1 operation is not implemented and the generated migration reference identifies a supported fallback.
- Use `asa workflows ...` for higher-level local logic. Read [opinionated-workflows.md](references/opinionated-workflows.md) and the generated [workflow-command-index.md](references/workflow-command-index.md) first.
- Do not count workflows or v5 compatibility commands as v1 SDK endpoint coverage.

## Select a strategy workflow

- Use `asa workflows campaigns audit --strategy auto` for read-only strategy classification and applicable checks. It distinguishes `manual-search-results`, `maximize-conversions`, and `non-search-or-unsupported` from API evidence and skips cross-strategy failures.
- Use `asa workflows campaigns plan-four-structure` only for manual App Store search-results themes. Brand, Category, Competitor, and Discovery may be separate campaigns or themed ad groups; they are not universal requirements.
- Use `asa workflows campaigns plan-maximize-conversions` for a no-write target-CPA plan with eligibility, source/confidence, approximate five-conversions-per-day budget capacity, Search Match automation, and the two-week learning guard.
- Treat Search tab, Today tab, product pages, and Apple Maps as placement-specific. Read [placement-strategy-decision.md](references/placement-strategy-decision.md); do not route them through either search-results planner.

Temporary preview namespaces do not redefine the canonical interface. If an entry documents both a preview path and an eventual canonical path, use only the path marked implemented by the manifest.

## Route to the smallest reference

Read [command-index.md](references/command-index.md) only for broad inventory questions. For a concrete task, load one generated domain reference:

- Accounts, organizations, advertiser resources, ACLs: [v1-accounts-and-access.md](references/v1-accounts-and-access.md)
- Campaigns: [v1-campaigns.md](references/v1-campaigns.md)
- Ad groups: [v1-ad-groups.md](references/v1-ad-groups.md)
- Ads and creatives: [v1-ads-and-creatives.md](references/v1-ads-and-creatives.md)
- Targeting keywords: [v1-keywords.md](references/v1-keywords.md)
- Negative keywords: [v1-negative-keywords.md](references/v1-negative-keywords.md)
- Shared budgets: [v1-shared-budgets.md](references/v1-shared-budgets.md)
- Apps, product pages, eligibility, rejection reasons: [v1-apps-and-product-pages.md](references/v1-apps-and-product-pages.md)
- Maps brands and categories: [v1-maps-brands-and-categories.md](references/v1-maps-brands-and-categories.md)
- Maps locations, location groups, and geo: [v1-maps-locations-and-geo.md](references/v1-maps-locations-and-geo.md)
- Assets: [v1-assets.md](references/v1-assets.md)
- App and Maps reports: [v1-reports.md](references/v1-reports.md)
- Impression share and search-term popularity: [v1-insights.md](references/v1-insights.md)
- Recommendations and suggestions: [v1-recommendations-and-suggestions.md](references/v1-recommendations-and-suggestions.md)
- Audit summaries and change details: [v1-change-history.md](references/v1-change-history.md)
- Any newly introduced family awaiting explicit routing: [v1-other.md](references/v1-other.md)
- Legacy fallback: [v5-fallback.md](references/v5-fallback.md)
- Endpoint migration: [migration-map.md](references/migration-map.md)

## Execute safely

- Begin with read-only preflight and exact account selection.
- For report comparisons, align inclusive dates and time zones, inspect pagination and `coverage`, and use `source_totals` rather than filtered or limited row totals.
- For v1 mutation JSON, include only intended fields; campaign search-results targeting requires APPSTORE plus APPSTORE_SEARCH_RESULTS, and ad-group creation requires `startTime`.
- Show the user the exact targets and proposed values before a mutation unless that exact action was already authorized.
- Use the command's documented preview or confirmation gate. Never invent `--apply`, `--yes`, or other flags.
- After a mutation, read back the affected resource by ID and compare the intended fields. A successful request without matching readback is unverified.
- Do not automatically retry an ambiguous mutation failure.
- Keep credentials, private keys, client secrets, access tokens, and signed payloads out of output and logs.

## Check catalog freshness

The generated references are release-pinned and reconciled to the public v1, v5, and workflow Typer trees. Before claiming complete coverage after any SDK or command registration update, run:

```bash
uv run python scripts/generate_skill_references.py --check
```

If the installed SDK, manifest provenance, generated references, and runtime command registration disagree, stop and report the mismatch. Do not guess or test against the live API.

The manifest also inventories every SDK response model. If a live read fails
deserialization, preserve the nonzero failure and consult
`references/safety-and-output-contracts.md`; do not coerce the response, retry a
mutation, or generalize an existing compatibility case without a sanitized
fixture and sibling/near-miss tests.
Files in this package (99)
  • .gitignore 1 KB
  • CONTRIBUTING.md 4 KB
  • LICENSE 1 KB
  • MANIFEST.in 1 KB
  • README.md 14 KB
  • RELEASING.md 4 KB
  • SKILL.md 7 KB
  • pyproject.toml 2 KB
  • asa_cli/__init__.py 1 KB
  • asa_cli/api.py 1 KB
  • asa_cli/config.py 15 KB
  • asa_cli/experiments.py 2 KB
  • asa_cli/main.py 3 KB
  • asa_cli/reporting.py 10 KB
  • asa_cli/commands/__init__.py 1 KB
  • asa_cli/commands/acl.py 7 KB
  • asa_cli/commands/adgroups.py 10 KB
  • asa_cli/commands/ads.py 16 KB
  • asa_cli/commands/budget.py 9 KB
  • asa_cli/commands/campaigns.py 30 KB
  • asa_cli/commands/config.py 10 KB
  • asa_cli/commands/geo.py 5 KB
  • asa_cli/commands/keywords.py 46 KB
  • asa_cli/commands/optimize.py 24 KB
  • asa_cli/commands/reports.py 65 KB
  • asa_cli/platform/__init__.py 1 KB
  • asa_cli/platform/cli.py 3 KB
  • asa_cli/platform/client.py 9 KB
  • asa_cli/platform/command_factory.py 10 KB
  • asa_cli/platform/config_cli.py 1 KB
  • asa_cli/platform/generate_manifest.py 2 KB
  • asa_cli/platform/manifest_discovery.py 28 KB
  • asa_cli/platform/manifest_specs.py 6 KB
  • asa_cli/platform/runtime.py 9 KB
  • asa_cli/platform/manifest/apple_ads_platform_manifest.schema.json 9 KB
  • asa_cli/platform/manifest/apple_ads_platform_v1_109_0.json 454 KB
  • asa_cli/platform/resources/__init__.py 1 KB
  • asa_cli/platform/resources/access.py 1 KB
  • asa_cli/platform/resources/ad_accounts.py 1 KB
  • asa_cli/platform/resources/ad_groups.py 1 KB
  • asa_cli/platform/resources/ads.py 1 KB
  • asa_cli/platform/resources/apps.py 1 KB
  • asa_cli/platform/resources/assets.py 2 KB
  • asa_cli/platform/resources/business_brands.py 1 KB
  • asa_cli/platform/resources/business_categories.py 1 KB
  • asa_cli/platform/resources/campaigns.py 1 KB
  • asa_cli/platform/resources/change_history.py 1 KB
  • asa_cli/platform/resources/creatives.py 1 KB
  • asa_cli/platform/resources/geos.py 1 KB
  • asa_cli/platform/resources/insights.py 1 KB
  • asa_cli/platform/resources/keywords.py 1 KB
  • asa_cli/platform/resources/location_groups.py 1 KB
  • asa_cli/platform/resources/locations.py 1 KB
  • asa_cli/platform/resources/negative_keywords.py 1 KB
  • asa_cli/platform/resources/product_pages.py 1 KB
  • asa_cli/platform/resources/recommendations.py 1 KB
  • asa_cli/platform/resources/rejection_reasons.py 1 KB
  • asa_cli/platform/resources/reports_apps.py 1 KB
  • asa_cli/platform/resources/reports_business_brands.py 1 KB
  • asa_cli/platform/resources/shared_budgets.py 1 KB
  • asa_cli/platform/resources/suggestions.py 1 KB
  • asa_cli/v5/__init__.py 1 KB
  • asa_cli/v5/api.py 86 KB
  • asa_cli/v5/cli.py 1 KB
  • asa_cli/workflows/__init__.py 1 KB
  • asa_cli/workflows/campaigns.py 33 KB
  • asa_cli/workflows/cli.py 1 KB
  • asa_cli/workflows/strategy.py 6 KB
  • asa_cli/workflows/strategy_contract_v1.json 3 KB
  • references/command-index.md 14 KB
  • references/configuration-and-context.md 3 KB
  • references/migration-map.md 8 KB
  • references/opinionated-workflows.md 7 KB
  • references/placement-strategy-decision.md 4 KB
  • references/safety-and-output-contracts.md 6 KB
  • references/sdk-response-drift-audit.md 4 KB
  • references/v1-accounts-and-access.md 8 KB
  • references/v1-ad-groups.md 15 KB
  • references/v1-ads-and-creatives.md 27 KB
  • references/v1-apps-and-product-pages.md 21 KB
  • references/v1-assets.md 7 KB
  • references/v1-campaigns.md 18 KB
  • references/v1-change-history.md 6 KB
  • references/v1-insights.md 8 KB
  • references/v1-keywords.md 17 KB
  • references/v1-maps-brands-and-categories.md 9 KB
  • references/v1-maps-locations-and-geo.md 21 KB
  • references/v1-negative-keywords.md 16 KB
  • references/v1-other.md 1 KB
  • references/v1-recommendations-and-suggestions.md 38 KB
  • references/v1-reports.md 54 KB
  • references/v1-shared-budgets.md 11 KB
  • references/v5-fallback.md 43 KB
  • references/workflow-command-index.md 3 KB
  • scripts/_command_catalog.py 30 KB
  • scripts/_runtime_catalog.py 7 KB
  • scripts/check_release.py 4 KB
  • scripts/generate_skill_references.py 2 KB
  • scripts/lookup_command.py 7 KB

Versions

The database has no other skills named apple-ads-cli.

Database snapshot: 13.11.2026 · package version bcd94ea7cd8b (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100apple-search-ads
    Run Apple Search Ads (Apple Ads, ASA) campaigns through the Campaign Management API v5 with a bundled read-only CLI - campaign status and serving reasons, impressions / taps / installs / spend, CPT and CPI, per-country and per-day reports, keyword and search-term reports,…
  • 100apple-ads-playbook
    Operating playbook for running Apple Ads (Apple Search Ads, ASA) for an app — account setup, campaign structure, keywords and match types, bids and breakeven, negatives, brand defense, custom product pages, placements, reading results, incrementality, scaling, and audits. Use…
  • 90Apple Search Ads
    Plans, launches, and optimizes Apple Search Ads (Apple Ads, ASA) campaigns for iOS apps: bids, keywords, budgets, CPA, attribution. Use for paid iOS user acquisition and App Store ads — launching or restructuring campaigns, mining search-term reports, graduating keywords,…
  • 95asc-apple-ads
    Use when managing Apple Ads with asc, including OAuth profiles, ad-account discovery, Platform API v1 campaigns and targeting, reports, assets, recommendations, guarded mutations, raw requests, and Campaign Management API v5 migration.
  • 100apple-search-ads
    When the user wants to set up, optimize, or scale Apple Search Ads (ASA) campaigns — including keyword bidding, match types, campaign structure, Creative Product Sets, CPP routing, and ROAS optimization. Use when the user mentions "Apple Search Ads", "ASA", "Search Ads", "Search…
  • 100google-ads
    Query Google Ads campaigns, ad groups, keywords and spend via the Google Ads API (GAQL searchStream). Use when the user mentions Google Ads, ad campaigns, ad spend / cost, impressions / clicks / conversions on ads, or campaign performance.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.