Asc Apple Ads

Befehlsreferenz zur Steuerung von Apple Ads-Kampagnen, Keywords und Berichten über die asc CLI

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

Funktioniert mit Setup ★ 8.4/10

Asc Apple Ads — Befehlsreferenz zur Steuerung von Apple Ads-Kampagnen, Keywords und Berichten über die asc CLI

Was es kann

Gibt Claude die genaue `asc ads`-Befehlsoberfläche für Apple Ads: separate Ads-Authentifizierung, Org-Auflösung, Kampagnen- und Anzeigengruppen-Lesevorgänge, JSON-Datei-Payloads für Erstellungen und Aktualisierungen, Bulk-Keyword-Operationen, Reporting und rohe v5 API-Anfragen. Es erzwingt auch eine Read-First-, Paused-Resource-, Delete-With---Confirm-Prozedur für die Bearbeitung eines Live-Werbekontos. Wird ausgelöst, wenn eine Aufgabe Apple Ads, Search Ads-Kampagnen, Anzeigengruppen, Targeting-Keywords oder `asc ads` erwähnt.

Testbericht

skills/asc-apple-ads/SKILL.md (4841 Bytes, einzelne Datei, keine gebündelten Skripte) in ein temporäres HOME installiert; Frontmatter mit name+description geparst, keine fest codierten Maschinenpfade, und ein grep nach curl|sh / base64 / Exfiltration fand nur eine harmlose https-Referenz zu api.searchads.apple.com. Das `asc`-Binary ist auf dieser Maschine nicht vorhanden, und ich habe es nicht heruntergeladen oder ausgeführt, daher habe ich es validiert, indem ich die autoritative Endpunkttabelle der CLI (internal/appleads/endpoints.go, 84 Befehlspfade) und commands/ads.mdx aus rorkai/App-Store-Connect-CLI extrahiert habe. Ich schrieb zwei Pläne für dieselbe Aufgabe („Org auflösen, Kampagnen als JSON auflisten, eine pausierte Testkampagne + ein pausiertes EXACT-Keyword erstellen, aufräumen“) und überprüfte beide anhand dieser Tabelle: Die Baseline erzielte 2 von 9 gültigen Befehlspfaden (erfunden `asc ads orgs list`, `whoami`, `campaign create`, `adgroup create`, `keywords add/remove`) mit 16 ungültigen Flags (`--json`, `--page-size`, `--campaign-id`, `--bid`), während der Skill-konforme Plan 14 von 14 gültigen Pfaden mit 0 ungültigen Flags erzielte. Vier Skill-Behauptungen habe ich unabhängig in der Quelle bestätigt: nackte `asc ads campaigns`/`acls` sind wirklich Listen-Aliase (DefaultListAlias), DELETE und /delete/bulk geben wirklich „--confirm is required“ zurück, rohe API-Anfragen lehnen wirklich alles ab, was nicht v5/api.searchads.apple.com ist, und Ads-Auth ist wirklich getrennt von `asc auth login` – meine Baseline hatte alle vier falsch (sie verwendete v4 und `asc auth login`). Als „setup“ markiert, weil hier nichts ohne die Installation der Go CLI und das Prägen von Apple Ads API-Schlüsseln läuft, und weil die Skill sagt „never guess payload fields“, aber kein Payload-Schema oder Link liefert (das Upstream ads.mdx tut dies).

Getestet am: 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)

Befehle & Beispiel-Prompts

  • /asc-apple-adsBefehlsreferenz zur Steuerung von Apple Ads-Kampagnen, Keywords und Berichten über die asc CLI

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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