Asc Apple Ads

Referenční příkazy pro řízení kampaní, klíčových slov a reportů Apple Ads přes asc CLI

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

Funguje s nastavením ★ 8.4/10

Asc Apple Ads — Referenční příkazy pro řízení kampaní, klíčových slov a reportů Apple Ads přes asc CLI

Co umí

Poskytuje Claude přesné rozhraní příkazů `asc ads` pro Apple Ads: samostatnou autentizaci Ads, řešení organizace, čtení kampaní a reklamních skupin, JSON-souborové payloady pro vytváření a aktualizace, hromadné operace s klíčovými slovy, reportování a surové požadavky v5 API. Také vynucuje postup čtení-nejprve, pozastaveného zdroje, mazání s ---confirm pro dotyk živého reklamního účtu. Spouští se, když úkol zmiňuje Apple Ads, kampaně Search Ads, reklamní skupiny, cílová klíčová slova nebo `asc ads`.

Testovací report

Nainstaloval jsem skills/asc-apple-ads/SKILL.md (4841 bajtů, jeden soubor, žádné balené skripty) do dočasného HOME; frontmatter parsován s name+description, žádné pevně zakódované cesty stroje a grep na curl|sh / base64 / exfiltraci našel pouze jeden benigní https odkaz na api.searchads.apple.com. Binární soubor `asc` není na tomto stroji a nestáhl jsem ho ani nespustil, takže jsem ověřil extrakcí autoritativní tabulky endpointů CLI (internal/appleads/endpoints.go, 84 cest příkazů) a commands/ads.mdx z rorkai/App-Store-Connect-CLI. Napsal jsem dva plány pro stejný úkol („vyřešit org, vypsat kampaně jako JSON, vytvořit pozastavenou testovací kampaň + jedno pozastavené PŘESNÉ klíčové slovo, vyčistit“) a zkontroloval oba proti této tabulce: základní test získal 2 z 9 platných cest příkazů (vymyslel `asc ads orgs list`, `whoami`, `campaign create`, `adgroup create`, `keywords add/remove`) s 16 neplatnými příznaky (`--json`, `--page-size`, `--campaign-id`, `--bid`), zatímco plán podle dovednosti získal 14 ze 14 platných cest s 0 neplatnými příznaky. Čtyři tvrzení dovednosti jsem nezávisle potvrdil ve zdroji: holé `asc ads campaigns`/`acls` jsou skutečně aliasy seznamu (DefaultListAlias), DELETE a /delete/bulk skutečně vrací „--confirm is required“, surový požadavek API skutečně odmítá cokoli, co není v5/api.searchads.apple.com, a autentizace Ads je skutečně oddělená od `asc auth login` — můj základní test se ve všech čtyřech mýlil (použil v4 a `asc auth login`). Označeno jako „setup“, protože nic zde neběží bez instalace Go CLI a vytvoření Apple Ads API klíčů, a protože dovednost říká „nikdy nehádejte pole payloadu“, přesto nedodává žádné schéma payloadu ani odkaz (upstream ads.mdx to dělá).

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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)

Příkazy a ukázkové prompty

  • /asc-apple-adsReferenční příkazy pro řízení kampaní, klíčových slov a reportů Apple Ads přes asc CLI

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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