Asc Apple Ads

Referencja poleceń do zarządzania kampaniami, słowami kluczowymi i raportami Apple Ads za pomocą asc CLI

Autor: rorkai · rorkai/app-store-connect-cli-skills

Działa po konfiguracji ★ 8.4/10

Asc Apple Ads — Referencja poleceń do zarządzania kampaniami, słowami kluczowymi i raportami Apple Ads za pomocą asc CLI

Co robi ten skill

Daje Claude'owi dokładną powierzchnię poleceń `asc ads` dla Apple Ads: oddzielne uwierzytelnianie Ads, rozwiązywanie organizacji, odczyty kampanii i grup reklam, ładunki plików JSON dla tworzenia i aktualizacji, masowe operacje na słowach kluczowych, raportowanie i surowe żądania API v5. Wymusza również procedurę read-first, paused-resource, delete-with---confirm dla dotykania aktywnego konta reklamowego. Uruchamia się, gdy zadanie wspomina Apple Ads, kampanie Search Ads, grupy reklam, słowa kluczowe do targetowania lub `asc ads`.

Raport z testu

Zainstalowano skills/asc-apple-ads/SKILL.md (4841 bajtów, pojedynczy plik, bez dołączonych skryptów) w tymczasowym HOME; frontmatter sparsowany z name+description, brak hardcoded machine paths, a grep dla curl|sh / base64 / exfiltration znalazł tylko jedno nieszkodliwe odwołanie https do api.searchads.apple.com. Binarka `asc` nie znajduje się na tej maszynie i nie pobrałem jej ani nie uruchomiłem, więc zweryfikowałem, wyodrębniając autorytatywną tabelę endpointów CLI (internal/appleads/endpoints.go, 84 ścieżki poleceń) i commands/ads.mdx z rorkai/App-Store-Connect-CLI. Napisałem dwa plany dla tego samego zadania („resolve org, list campaigns as JSON, create a paused test campaign + one paused EXACT keyword, clean up”) i sprawdziłem oba względem tej tabeli: bazowy uzyskał 2 z 9 prawidłowych ścieżek poleceń (wymyslone `asc ads orgs list`, `whoami`, `campaign create`, `adgroup create`, `keywords add/remove`) z 16 nieprawidłowymi flagami (`--json`, `--page-size`, `--campaign-id`, `--bid`), podczas gdy plan zgodny z umiejętnością uzyskał 14 z 14 prawidłowych ścieżek z 0 nieprawidłowymi flagami. Cztery twierdzenia umiejętności, które niezależnie potwierdziłem w źródle: nagie `asc ads campaigns`/`acls` naprawdę są aliasami listy (DefaultListAlias), DELETE i /delete/bulk naprawdę zwracają „--confirm is required”, surowe żądanie API naprawdę odrzuca wszystko, co nie jest v5/api.searchads.apple.com, a uwierzytelnianie Ads naprawdę jest oddzielne od `asc auth login` — mój bazowy plan pomylił wszystkie cztery (używał v4 i `asc auth login`). Oznaczono jako „setup”, ponieważ nic tutaj nie działa bez zainstalowania Go CLI i wygenerowania kluczy Apple Ads API, oraz ponieważ umiejętność mówi „never guess payload fields”, a jednak nie dostarcza schematu ładunku ani linku (robi to ads.mdx upstream).

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

Instalacja

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)

Komendy i przykładowe prompty

  • /asc-apple-adsReferencja poleceń do zarządzania kampaniami, słowami kluczowymi i raportami Apple Ads za pomocą asc CLI

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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