Claude Ads — навык для Claude Code по работе с рекламой в 12 платформах

Claude Ads — это навык для Claude Code, который превращает агента в оператора платной рекламы. Вы даёте ему выгрузку из рекламного кабинета, а он разбирает её и отвечает на главный вопрос: что работает, что сломано и что чинить первым. Навык поддерживает двенадцать платформ: Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Advertising, Apple Ads, Amazon Ads, Reddit Ads, Pinterest Ads, Snapchat Ads и X Ads.

Проект сделан для агентств, консультантов и маркетинговых команд внутри компаний. Лицензия MIT, код открытый, подписка не нужна.

Главное правило: сначала читает, потом меняет

По умолчанию навык ничего не меняет в аккаунте. Он читает данные и пишет отчёт. Любое изменение — это отдельная операция, для которой нужны сразу шесть условий:

1. Для точной операции есть проверенная и включённая возможность (capability).
2. Указаны конкретные идентификаторы аккаунта и объекта.
3. Показан diff «до и после» в понятном человеку виде, вместе с зоной влияния.
4. Владелец аккаунта одобрил изменение в пределах заданных лимитов.
5. У операции есть ключ идемпотентности, журнал аудита, откат и окно проверки.
6. Проверено, что удалённое состояние всё ещё совпадает с ожидаемым.

Если хотя бы одно условие не выполнено, запись в аккаунт не происходит. Без заданных лимитов изменять ничего нельзя. Удаление данных в версии 2 не поддерживается вообще.

Учётные данные живут в переменных окружения, в системном хранилище ключей или в утверждённом менеджере секретов. В репозитории, в профилях, в отчётах и в логах им не место.

Быстрый старт

Установка через нативный механизм плагинов Claude Code:

/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

После установки набор команд начинается с /ads. В режиме плагина Claude Code команды получают префикс пространства имён и вызываются как /claude-ads:ads.

Дальше пять шагов:

1. Запустите /ads setup и ответьте на несколько вопросов: модель бизнеса, цель, главная конверсия, месячный бюджет, активные платформы и кто согласовывает изменения. Ключи API и токены в ответы не вставляйте.
2. Дайте данные: выгрузку аккаунта в CSV или JSON, скриншоты или сводку с указанием диапазона дат, валюты и часового пояса.
3. Выполните /ads audit google или /ads audit all. На выходе — отчёт: что прошло проверку, что провалилось, а чего не хватает.
4. Посмотрите прошлый запуск через /ads report.
5. Узнайте главный текущий блокер через /ads next.

Команды

Есть и короткие сокращения: /ads google, /ads meta, /ads amazon, /ads reddit сразу запускают аудит по нужной платформе.

Что означают результаты проверок

Каждая проверка заканчивается одним из четырёх ответов: pass, fail, unknown или not_applicable. Ответ unknown — это честный результат, а не ошибка. Он означает, что данных не хватило, и навык ничего не додумывает.

Отдельно считаются: здоровье аккаунта, покрытие данными, регуляторные риски и найденные возможности. Неизвестные проверки снижают покрытие данными, но не меняют известное здоровье. Покрытие от 80 процентов считается засчитанным, от 60 до 79 — предварительным, ниже 60 — недостаточным. Недоступные, бета- и платные функции не оцениваются вовсе. Если платформа не прошла проверку, она выпадает из общей оценки, а запуск помечается как частичный. Подробное описание — в справке по системе оценок и в коде claude_ads_core/scoring.py.

Как устроен репозиторий

Навык — это не один большой промпт, а набор связанных частей:

ads/                  основной навык и общие справочные материалы
skills/               навыки под платформы и под этапы работы
agents/               работники для платформ, исследований и проверки
claude_ads_core/      типизированные контракты, адаптеры, валидация и оценки
control-plane/        возможности, правила безопасности, зрелость и условия релиза
scripts/              браузер, креативы, отчёты и вспомогательные скрипты
evals/                проверки маршрутизации и поведения
tests/                тесты, детерминированность, безопасность и адаптеры

У каждой платформы есть свой навык, свой работник аудита и свой справочник. Авторитетный список того, что можно читать и менять прямо в аккаунте, лежит в манифесте возможностей.

Архитектура простая. Один управляющий элемент отвечает за область работы, правила, сборку и итоговые файлы. Работники анализируют ограниченные куски и возвращают находки в строгом формате. Если обязательный работник не отработал, запуск считается частичным и никогда не выдаётся за полный аудит. Готовый результат хранится как версионированный JSON, а Markdown, HTML и PDF — это просто разные отображения одного и того же файла.

Cockpit: локальный рабочий стол

Cockpit — необязательный отдельный модуль версии 0.1.0 с плагином ads-cockpit. Команда /ads-cockpit открывает локальный рабочий стол, где можно посмотреть готовый аудит: его статус, доказательства, недостающие входные данные, сравнение с прошлым запуском и подтверждения отчётов. Внутри есть демонстрация на синтетических данных, чтобы попробовать всё без своего аккаунта. Модуль включается отдельно и не входит в основную установку навыка. Подробности — в руководстве Cockpit и в описании совместимости и ограничений приёмки.

Статус проекта

Проект сам честно называет себя кандидатом в релиз. Все двенадцать профилей оценки здоровья отключены, поэтому итоговой оценки аккаунта он не выдаёт. Вместо неё показываются находки, неизвестные места и покрытие данными. Изменения в аккаунте остаются черновиками, пока не пройдены все условия. Полный список требований к релизу лежит в control-plane/RELEASE_REQUIREMENTS.md.

Другие среды и установка из репозитория

Официально проверена только работа в Claude Code. Codex, Gemini, Cursor, Windsurf и Goose ставят те же файлы навыка, но их собственные соглашения о размещении файлов могут отличаться, поэтому результат нужно проверить у себя. Установщик умеет работать с локальной копией:

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local

Можно указать другую среду явно: bash install.sh --target=codex --source=local. Для установки из git есть опция --ref, чтобы зафиксировать тег или коммит; она работает только с --source=git. Готовые релизы публикуются вместе с файлом SHA256SUMS, и архив стоит проверить командой sha256sum -c SHA256SUMS до распаковки. Установщик требует Python 3.11 или 3.12 для управляемых зависимостей; список внешних требований к среде лежит в манифесте внешних зависимостей.

Кому это пригодится

Маркетологу навык даёт второй взгляд на свой же аккаунт: регулярный аудит с опорой на выгрузку, а не на ощущения. Разработчику — готовый пример того, как устроен навык с большим числом платформ, строгими контрактами, журналом изменений и проверками качества. Агентству — способ вести много клиентских аккаунтов по одному и тому же протоколу и получать отчёты одинакового формата.

Лицензия MIT, подробности — в LICENSE. Список внешних источников и сторонние условия — в THIRD_PARTY_NOTICES.md, правила публикации релизов — в политике публикации. Как подключиться к разработке, написано в CONTRIBUTING.md.