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
- Author
- cameronehrlich ↗
- Repository
- apple-search-ads-cli ↗
- Licence
- MIT
- Last repository change
- 19.09.2026
Assessment and security
- Files in this package
- 99
- Scripts
- 63
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 19.09.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 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
- Start here
- Choose the command surface
- Select a strategy workflow
- Route to the smallest reference
- Execute safely
- Check catalog freshness
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.