Asc Apple Ads

Référence de commandes pour piloter les campagnes, mots-clés et rapports Apple Ads via le CLI asc.

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

Fonctionne avec configuration ★ 8.4/10

Asc Apple Ads — Référence de commandes pour piloter les campagnes, mots-clés et rapports Apple Ads via le CLI asc.

Ce que fait

Fournit à Claude la surface de commande `asc ads` exacte pour Apple Ads : authentification Ads séparée, résolution d'organisation, lectures de campagnes et de groupes d'annonces, payloads de fichiers JSON pour les créations et mises à jour, opérations de mots-clés en masse, rapports, et requêtes API v5 brutes. Il impose également une procédure de lecture d'abord, ressource en pause, suppression avec --confirm pour toucher un compte publicitaire en direct. Se déclenche lorsqu'une tâche mentionne Apple Ads, les campagnes Search Ads, les groupes d'annonces, les mots-clés de ciblage, ou `asc ads`.

Rapport de test

Installé skills/asc-apple-ads/SKILL.md (4841 octets, fichier unique, pas de scripts groupés) dans un HOME temporaire ; frontmatter analysé avec name+description, pas de chemins machine codés en dur, et un grep pour curl|sh / base64 / exfiltration n'a trouvé qu'une seule référence https bénigne à api.searchads.apple.com. Le binaire `asc` n'est pas sur cette machine et je ne l'ai pas téléchargé ni exécuté, j'ai donc validé en extrayant le tableau des endpoints autoritaires du CLI (internal/appleads/endpoints.go, 84 chemins de commande) et commands/ads.mdx de rorkai/App-Store-Connect-CLI. J'ai écrit deux plans pour la même tâche ("résoudre l'organisation, lister les campagnes en JSON, créer une campagne de test en pause + un mot-clé EXACT en pause, nettoyer") et vérifié les deux par rapport à ce tableau : la référence a obtenu 2 chemins de commande valides sur 9 (a inventé `asc ads orgs list`, `whoami`, `campaign create`, `adgroup create`, `keywords add/remove`) avec 16 drapeaux invalides (`--json`, `--page-size`, `--campaign-id`, `--bid`), tandis que le plan suivant la compétence a obtenu 14 chemins valides sur 14 avec 0 drapeaux invalides. Quatre affirmations de la compétence que j'ai confirmées indépendamment dans la source : `asc ads campaigns`/`acls` sont réellement des alias de liste (DefaultListAlias), DELETE et /delete/bulk retournent vraiment "--confirm is required", la requête API brute rejette vraiment tout ce qui n'est pas v5/api.searchads.apple.com, et l'authentification Ads est vraiment séparée de `asc auth login` — ma référence a eu les quatre torts (elle utilisait v4 et `asc auth login`). Marqué "setup" car rien ici ne fonctionne sans installer le CLI Go et générer des clés API Apple Ads, et parce que la compétence dit "never guess payload fields" mais ne fournit aucun schéma de payload ou lien (le ads.mdx upstream le fait).

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

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)

Commandes et exemples de prompts

  • /asc-apple-adsRéférence de commandes pour piloter les campagnes, mots-clés et rapports Apple Ads via le CLI asc.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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