# asc-apple-ads

Скилл учит агента работать с Apple Ads через CLI asc: кампании, таргетинг, отчёты и рекомендации. Пригодится, если реклама в App Store уже идёт.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3000 установок · ★ 1101
- Автор: rorkai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/rorkai/app-store-connect-cli-skills/tree/HEAD/skills/asc-apple-ads/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/asc-apple-ads

## Что делает

Скилл описывает работу с Apple Ads через `asc ads`. Учётные данные Apple Ads отдельные: `asc auth login` их не настраивает, поэтому логин делается командой `asc ads auth login` с client-id, team-id, key-id и приватным ключом. Для CI есть переменные `ASC_ADS_*` и обход системного хранилища ключей через `ASC_ADS_BYPASS_KEYCHAIN=1`.

Внутри два API, и их легко перепутать. Прямые команды `asc ads <resource>` идут в Platform API v1 и требуют ad account ID. Устаревшие команды лежат под `asc ads v5 ...` и работают с organization ID; Apple отключает v5 26 января 2027 года. Подставить org ID вместо ad account ID нельзя — CLI держит их раздельно. Перед сборкой тела запроса стоит прогнать точную leaf-команду с `--help`: форматы v1 и v5 различаются, и CLI их не переводит.

Ресурсные, отчётные и raw-команды отдают JSON без потерь, проекции удобнее делать через `jq`. У `campaigns find` нет флага `--paginate` — листать нужно через `pagination.offset` и `pageSize` в файле запроса. Фильтры v1 используют единственное число `value`; поля v5 вроде `conditions` или `values` текущий `asc` отклоняет ещё до авторизации. Мутации вроде применения рекомендаций меняют расход и требуют `--confirm`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-apple-ads -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/asc-apple-ads/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/asc-apple-ads/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-apple-ads -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/asc-apple-ads/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-apple-ads -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/asc-apple-ads/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rorkai/app-store-connect-cli-skills asc-apple-ads
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/asc-apple-ads/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-apple-ads -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/rorkai/app-store-connect-cli-skills --path skills/asc-apple-ads
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/asc-apple-ads/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-apple-ads -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/rorkai/app-store-connect-cli-skills/tree/HEAD/skills/asc-apple-ads/SKILL.md

## Когда брать
- завести отдельный профиль авторизации для Apple Ads
- найти ad account ID и роли через `GET /v1/acls`
- выгрузить отчёт по кампаниям с разбивкой по странам
- посмотреть историю изменений и рекомендации по бюджету
- перевести старые вызовы Campaign Management API v5 на Platform API v1

## Примеры запросов агенту
- покажи мои ad accounts: `asc ads auth discover --ads-profile "Marketing" --output json`
- найди кампании по campaignId и выведи JSON
- собери отчёт по приложениям за период с группировкой по стране

## Похожие
- [ads-apple](https://affpapa.org/nevibecode/skills/ads-apple.md) — скилл · 3700 установок
- [apple-search-ads](https://affpapa.org/nevibecode/skills/apple-search-ads.md) — скилл · 2900 установок
- [apple-aso](https://affpapa.org/nevibecode/skills/apple-aso.md) — скилл · 471 установка
- [apple-appstore-reviewer](https://affpapa.org/nevibecode/skills/apple-appstore-reviewer.md) — скилл · 11295 установок
- [thought-leadership-ads](https://affpapa.org/nevibecode/skills/thought-leadership-ads.md) — скилл · 19900 установок
- [creator-ugc-marketing](https://affpapa.org/nevibecode/skills/creator-ugc-marketing.md) — скилл · 1900 установок

Из того же набора: [rorkai/app-store-connect-cli-skills](https://affpapa.org/nevibecode/by/rorkai/app-store-connect-cli-skills.md) — 24 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md