Asc Apple Ads

Kommandoreferens för att styra Apple Ads-kampanjer, nyckelord och rapporter via asc CLI

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

Fungerar med konfiguration ★ 8.4/10

Asc Apple Ads — Kommandoreferens för att styra Apple Ads-kampanjer, nyckelord och rapporter via asc CLI

Vad den gör

Ger Claude den exakta `asc ads`-kommandoytan för Apple Ads: separat Ads-autentisering, org-upplösning, kampanj- och annonsgruppsavläsningar, JSON-fil-nyttolaster för skapande och uppdateringar, bulk-nyckelordsoperationer, rapportering och råa v5 API-förfrågningar. Den tillämpar också en läs-först, pausad-resurs, delete-with---confirm-procedur för att röra ett live-annonskonto. Utlöses när en uppgift nämner Apple Ads, Search Ads-kampanjer, annonsgrupper, riktade nyckelord, eller `asc ads`.

Testrapport

Installeras skills/asc-apple-ads/SKILL.md (4841 byte, en fil, inga medföljande skript) i en temporär HOME; frontmatter parsades med name+description, inga hårdkodade maskinsökvägar, och en grep efter curl|sh / base64 / exfiltration hittade endast en godartad https-referens till api.searchads.apple.com. `asc`-binären finns inte på denna maskin och jag laddade inte ner eller körde den, så jag validerade genom att extrahera CLI:s auktoritativa endpoint-tabell (internal/appleads/endpoints.go, 84 kommandosökvägar) och commands/ads.mdx från rorkai/App-Store-Connect-CLI. Jag skrev två planer för samma uppgift ("resolve org, list campaigns as JSON, create a paused test campaign + one paused EXACT keyword, clean up") och kontrollerade båda mot den tabellen: baslinjen fick 2 av 9 giltiga kommandosökvägar (uppfann `asc ads orgs list`, `whoami`, `campaign create`, `adgroup create`, `keywords add/remove`) med 16 ogiltiga flaggor (`--json`, `--page-size`, `--campaign-id`, `--bid`), medan den färdighetsföljda planen fick 14 av 14 giltiga sökvägar med 0 ogiltiga flaggor. Fyra färdighetspåståenden jag oberoende bekräftade i källan: bara `asc ads campaigns`/`acls` är verkligen listalias (DefaultListAlias), DELETE och /delete/bulk returnerar verkligen "--confirm is required", rått api-anrop avvisar verkligen allt som inte är v5/api.searchads.apple.com, och Ads-autentisering är verkligen separat från `asc auth login` — min baslinje fick alla fyra fel (den använde v4 och `asc auth login`). Märkt "setup" eftersom inget här körs utan att installera Go CLI och skapa Apple Ads API-nycklar, och eftersom färdigheten säger "never guess payload fields" men ändå inte levererar något payload-schema eller länk (den uppströms ads.mdx gör det).

Testad: 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)

Kommandon och exempelprompter

  • /asc-apple-adsKommandoreferens för att styra Apple Ads-kampanjer, nyckelord och rapporter via asc CLI

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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