Asc Apple Ads

Riferimento comandi per gestire campagne, parole chiave e report di Apple Ads tramite la CLI asc.

di rorkai · rorkai/app-store-connect-cli-skills

Richiede configurazione ★ 8.4/10

Asc Apple Ads — Riferimento comandi per gestire campagne, parole chiave e report di Apple Ads tramite la CLI asc.

Cosa fa

Fornisce a Claude la superficie esatta dei comandi `asc ads` per Apple Ads: autenticazione Ads separata, risoluzione dell'organizzazione, letture di campagne e gruppi di annunci, payload di file JSON per creazioni e aggiornamenti, operazioni bulk su parole chiave, reporting e richieste API v5 raw. Applica anche una procedura di lettura-prima, risorsa-in-pausa, elimina-con---confirm per interagire con un account pubblicitario attivo. Si attiva quando un task menziona Apple Ads, campagne Search Ads, gruppi di annunci, parole chiave di targeting o `asc ads`.

Rapporto di test

Installato skills/asc-apple-ads/SKILL.md (4841 byte, file singolo, nessun script in bundle) in una HOME temporanea; frontmatter analizzato con name+description, nessun percorso macchina hardcoded, e un grep per curl|sh / base64 / esfiltrazione ha trovato solo un riferimento https benigno a api.searchads.apple.com. Il binario `asc` non è su questa macchina e non l'ho scaricato né eseguito, quindi ho validato estraendo la tabella degli endpoint autorevoli della CLI (internal/appleads/endpoints.go, 84 percorsi di comando) e commands/ads.mdx da rorkai/App-Store-Connect-CLI. Ho scritto due piani per lo stesso task ("risolvi org, elenca campagne come JSON, crea una campagna di test in pausa + una parola chiave EXACT in pausa, pulisci") e li ho controllati entrambi rispetto a quella tabella: la baseline ha ottenuto 2 su 9 percorsi di comando validi (inventato `asc ads orgs list`, `whoami`, `campaign create`, `adgroup create`, `keywords add/remove`) con 16 flag non validi (`--json`, `--page-size`, `--campaign-id`, `--bid`), mentre il piano che ha seguito la skill ha ottenuto 14 su 14 percorsi validi con 0 flag non validi. Quattro affermazioni della skill che ho confermato indipendentemente nella sorgente: bare `asc ads campaigns`/`acls` sono davvero alias di lista (DefaultListAlias), DELETE e /delete/bulk restituiscono davvero "--confirm is required", la richiesta API raw rifiuta davvero qualsiasi cosa non sia v5/api.searchads.apple.com, e l'autenticazione Ads è davvero separata da `asc auth login` — la mia baseline ha sbagliato tutti e quattro (ha usato v4 e `asc auth login`). Contrassegnato "setup" perché nulla qui funziona senza installare la CLI Go e creare chiavi API Apple Ads, e perché la skill dice "mai indovinare i campi del payload" eppure non fornisce schema o link del payload (il ads.mdx upstream lo fa).

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/rorkai/app-store-connect-cli-skills.git /tmp/asc-apple-ads-src
mkdir -p ~/.claude/skills
cp -R /tmp/asc-apple-ads-src/skills/asc-apple-ads ~/.claude/skills/asc-apple-ads
# Requires the `asc` CLI (Go): https://github.com/rorkai/App-Store-Connect-CLI — brew install rorkai/tap/asc
# Requires separate Apple Ads API credentials (ASC_ADS_CLIENT_ID / ASC_ADS_TEAM_ID / ASC_ADS_KEY_ID / private key)
#   created in the Apple Ads UI; `asc auth login` does NOT configure `asc ads`.
# Alternative installers from the repo README: `asc install-skills` or `npx skills add rorkai/app-store-connect-cli-skills`
# Whole-pack alternative: cp -R /tmp/asc-apple-ads-src/skills/* ~/.claude/skills/  (22 asc-* skills)

Comandi e prompt di esempio

/asc-apple-adsRiferimento comandi per gestire campagne, parole chiave e report di Apple Ads tramite la CLI asc.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

Create a new Apple Ads campaign for this app
List keyword performance for my ad group
Pull an Apple Ads report for last month

Rapporto completo →