Евгений Дубаков
AI

Подключаем Claude к Яндекс Директу: свой ИИ-агент за 15 минут

Пошаговая инструкция: приложение в Яндекс OAuth, заявка на доступ к API, токен и первая команда. Дальше задачи ставятся обычным текстом.

Подключаем Claude к Яндекс Директу: свой ИИ-агент за 15 минут

Я не знаю, почему об этом молчат инфобизнесмены и другие директологи. За 15 минут вы можете подключить свой Яндекс Директ к Claude и получить ИИ-агента для Яндекс Директа, который умеет:

  • проводить анализ поисковых запросов;
  • разбирать площадки РСЯ;
  • анализировать креативы;
  • разбирать объявления — тексты, заголовки, эффективность, уточнения, быстрые ссылки;
  • готовить сложные отчёты за один промт и пару минут;
  • работать как собственный биддер;
  • управлять рекламными кампаниями;
  • присылать отчёты по расписанию.

Цифры при этом берутся прямо из кабинета через API, а не переносятся руками, — значит, нет ошибок ручного переноса. А команды ставятся обычным человеческим языком: так же, как вы объяснили бы задачу своему маркетологу.

Связка Claude + API Директа даёт больше контроля, чем встроенные автоматические инструменты: вы видите и данные, и правила, по которым принимается решение, а не только готовый результат.

Дальше — сама инструкция. Бонус для тех, кто дочитает, — в конце.

Подключаемся к Яндекс Директу по API

Шаг 1. Зарегистрируйте приложение в Яндекс OAuth

Любой ИИ-помощник для Директа работает с рекламным кабинетом через API, поэтому начинать нужно с приложения.

  1. Войдите в тот аккаунт Яндекса, в котором есть рекламные кампании. Для агентства нужен аккаунт представителя.
  2. Откройте oauth.yandex.ru/client/new — откроется форма «Создание приложения».
  3. Нажмите «Создать приложение» и выберите «Для доступа к API».
  4. Заполните форму:Название вашего сервиса — любое, например «Claude Direct».Почта для связи — ваша почта или почта компании. На неё Яндекс присылает уведомления об изменениях во внешней авторизации.Доступ к данным — нажмите на поле «Название доступа» и выберите в списке «Использование API Яндекс.Директа» (direct:api). Больше ничего отмечать не нужно: права на Яндекс Диск для работы с Директом не требуются. Если оставить поле пустым, форма покажет ошибку «Выберите хотя бы одно право доступа».Redirect URI для веб-сервисов — уже заполнен (https://oauth.yandex.ru/verification_code), менять его не нужно.
  5. Нажмите «Создать приложение».
  6. Скопируйте ClientID со страницы приложения.

Шаг 2. Подайте заявку на доступ к API в Директе

Пока Директ не одобрит доступ, ИИ-помощник не сможет работать с кампаниями.

  1. Откройте раздел заявок на доступ к API в интерфейсе Директа. Если вы заходите туда впервые, примите условия использования API.
  2. Нажмите «Получить доступ к API», примите соглашение, введите контактные данные и сохраните их.
  3. Перейдите на вкладку «Мои заявки» и нажмите «Новая заявка».
  4. Выберите ClientID вашего приложения, укажите почту, опишите задачу и отправьте заявку. Пример описания: «Управление собственными кампаниями и выгрузка статистики через скрипты».
  5. Дождитесь ответа. У меня рассмотрение занимало заметно меньше недели.

Шаг 3. Получите OAuth-токен

  1. Откройте ссылку, подставив ClientID вашего приложения: https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID
  2. Войдите в аккаунт Яндекса, в котором находятся рекламные кампании, и нажмите «Разрешить».
  3. Скопируйте токен — он появится на странице или в адресной строке после #access_token=.

Токен живёт год. Никому его не передавайте: с ним можно управлять вашими кампаниями. Пока заявка на доступ не одобрена, токен выпускается, но запросы к API не проходят.

Шаг 4. Сохраните токен на компьютере

Не вставляйте токен в чат. Сохраните его в файл, доступный только вам: выполните в терминале команду, подставив свой токен вместо ВАШ_ТОКЕН.

mkdir -p ~/.config/yandex-direct && echo "ВАШ_ТОКЕН" > ~/.config/yandex-direct/token && chmod 600 ~/.config/yandex-direct/token

Шаг 5. Подключите Claude к Директу

Откройте Claude Code и напишите:

Подключись к API Яндекс Директа. Токен лежит в файле ~/.config/yandex-direct/token.Проверь подключение и покажи список моих кампаний.

Если Claude вывел ваши кампании — подключение работает. Дальше задачи ставятся обычным текстом:

  • «Покажи статистику по кампаниям за 7 дней»;
  • «Выгрузи поисковые запросы и предложи минус-слова»;
  • «Какие объявления тратят бюджет без конверсий?».

Что можно сделать дальше

Если хотите повторить описанный в статье сценарий, можно начать с готового скилла для Claude. Он помогает работать с данными Яндекс Директа через обычные запросы: разбирать кампании, находить отклонения в показателях, формулировать гипотезы и готовить следующие шаги для проверки.

Скилл доступен в моём Telegram-боте: Открыть бота

На сайте я публикую материалы о performance-маркетинге, рекламе, аналитике, AI-инструментах и автоматизации. Там же можно посмотреть информацию о направлениях, с которыми я работаю: аудит рекламных кампаний, настройка рекламы и подключение коннекторов к маркетинговым системам.

Если решите внедрять такой сценарий в своём кабинете, лучше начать с одного направления, ограниченного периода или небольшой группы кампаний. Сначала сверьте выводы Claude с данными Директа, Метрики и CRM, а затем масштабируйте подход на весь рекламный аккаунт.