Asc Apple Ads

Referencia de comandos para gestionar campañas, palabras clave e informes de Apple Ads a través del CLI asc

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

Funciona con configuración ★ 8.4/10

Asc Apple Ads — Referencia de comandos para gestionar campañas, palabras clave e informes de Apple Ads a través del CLI asc

Qué hace

Proporciona a Claude la superficie de comandos `asc ads` exacta para Apple Ads: autenticación de Ads separada, resolución de organizaciones, lecturas de campañas y grupos de anuncios, payloads de archivos JSON para creaciones y actualizaciones, operaciones masivas de palabras clave, informes y solicitudes de API v5 sin procesar. También impone un procedimiento de lectura primero, recurso pausado, eliminación con ---confirm para interactuar con una cuenta de anuncios activa. Se activa cuando una tarea menciona Apple Ads, campañas de Search Ads, grupos de anuncios, palabras clave de segmentación o `asc ads`.

Informe de la prueba

Instalé skills/asc-apple-ads/SKILL.md (4841 bytes, archivo único, sin scripts incluidos) en un HOME temporal; el frontmatter se analizó con name+description, sin rutas de máquina codificadas, y un grep para curl|sh / base64 / exfiltración encontró solo una referencia https benigna a api.searchads.apple.com. El binario `asc` no está en esta máquina y no lo descargué ni lo ejecuté, así que lo validé extrayendo la tabla de endpoints autorizada del CLI (internal/appleads/endpoints.go, 84 rutas de comando) y commands/ads.mdx de rorkai/App-Store-Connect-CLI. Escribí dos planes para la misma tarea ("resolver organización, listar campañas como JSON, crear una campaña de prueba pausada + una palabra clave EXACTA pausada, limpiar") y verifiqué ambos contra esa tabla: la línea base obtuvo 2 de 9 rutas de comando válidas (inventó `asc ads orgs list`, `whoami`, `campaign create`, `adgroup create`, `keywords add/remove`) con 16 banderas inválidas (`--json`, `--page-size`, `--campaign-id`, `--bid`), mientras que el plan seguido por la habilidad obtuvo 14 de 14 rutas válidas con 0 banderas inválidas. Cuatro afirmaciones de la habilidad que confirmé independientemente en la fuente: `asc ads campaigns`/`acls` realmente son alias de lista (DefaultListAlias), DELETE y /delete/bulk realmente devuelven "--confirm is required", la solicitud de API sin procesar realmente rechaza cualquier cosa que no sea v5/api.searchads.apple.com, y la autenticación de Ads realmente es separada de `asc auth login` — mi línea base se equivocó en las cuatro (usó v4 y `asc auth login`). Marcado como "setup" porque nada de esto se ejecuta sin instalar el CLI de Go y generar claves de API de Apple Ads, y porque la habilidad dice "never guess payload fields" pero no envía ningún esquema de payload o enlace (el ads.mdx upstream sí lo hace).

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

Instalación

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)

Comandos y prompts de ejemplo

  • /asc-apple-adsReferencia de comandos para gestionar campañas, palabras clave e informes de Apple Ads a través del CLI asc

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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