---
title: "Настройка Яндекс Директа через ИИ: аудит, ставки, отчёты | LidFly"
description: "Подключите Яндекс Директ и Метрику к Claude, ChatGPT или Codex через MCP LidFly: настройка кампаний, аудит, ставки, отчёты и цели Метрики. 7 дней бесплатно."
canonical: "https://lidfly.ru/docs/yandex-direct"
language: "ru"
updated: "2026-11-04"
---

[Документация](https://lidfly.ru/docs/) / Яндекс Директ и Метрика

MCP-сервер Яндекс Директа и Метрики для Claude, ChatGPT и Codex

# Яндекс Директ и Метрика через ИИ: настройка, аудит, ставки и отчёты

Подключите рекламный кабинет к своему ИИ через LidFly: он соберёт кампанию по брифу, найдёт, куда уходит бюджет, подготовит отчёт и цели Метрики. ИИ готовит изменения — кабинет меняется только после вашего «да».

- Без привязки карты
- Несколько кабинетов и агентские клиенты
- Все изменения — после подтверждения

Обновлено 4 ноября 2026

**Пример ответа ИИ-клиента (данные условные)**

Проверь кампании за последние 30 дней: где расход без конверсий, какие поисковые запросы съедают бюджет. Подготовь план правок, ничего не меняй без меня.

- `get_campaign_stats` — расход, клики и конверсии по кампаниям
- `get_search_queries` — запросы, по которым показывались объявления
- `diagnose_ad_delivery` — почему у части групп нет показов

- **Расход**: 84 300 ₽ · за 30 дней
- **Конверсии**: 117 · цель «Заявка»
- **CPA**: 720 ₽ · +18% к прошлому месяцу
- **Без конверсий**: 23% · расхода — 9 фраз

Предлагаю четыре правки:

1. Минус-фразы «бесплатно», «своими руками», «вакансии» в 3 кампании (Минус-фразы)
2. Снизить ставки на 4 фразы с CPA выше 1 500 ₽ (Ставки)
3. Остановить 2 объявления с CTR ниже 0,5% (Объявления)
4. Корректировка −30% на мобильные в РСЯ (Корректировки)

Делай пункты 1 и 2.

Применено · Минус-фразы и ставки изменены — ИИ перечитал кампании и показал итог.

## Что ИИ делает с Яндекс Директом и Метрикой

Три задачи, ради которых подключают кабинет. Каждая ниже разобрана с готовым запросом и примером результата.

- **Настройка**: Кампании, ЕПК, группы, объявления, фразы, быстрые ссылки и уточнения по вашему брифу.
- **Аудит и оптимизация**: Почему нет показов, куда уходит бюджет, ставки, стратегии, минус-фразы и автотаргетинг.
- **Отчёты и Метрика**: Статистика по кампаниям и запросам, цели и отчёты Метрики, выгрузки по расписанию.

## Настройка Яндекс Директа через ИИ: кампании, группы и объявления

Опишите продукт, регион, бюджет и цель — ИИ соберёт структуру: кампанию или ЕПК, группы по смыслу, ключевые фразы с минус-словами, объявления, быстрые ссылки и уточнения. Перед созданием он покажет план целиком и создаст объекты только после вашего подтверждения.

- Текстово-графические кампании и единые перфоманс-кампании (ЕПК) — `add_unified_campaign`
- Группы объявлений с регионами и минус-фразами — `add_adgroups`
- Комбинаторные и текстовые объявления — `add_responsive_ad`
- Ключевые фразы и автотаргетинг — `add_keywords`
- Быстрые ссылки, уточнения, изображения и визитки — `sitelinks`
- Остановка, запуск и архив кампаний и объявлений — `manage_campaigns`

### Семантика из Вордстата в том же подключении

Попросите ИИ проверить частотность фраз в Яндекс Вордстате и наличие трафика до того, как добавлять их в группу, — так нулевые и нецелевые фразы не попадут в кампанию.

Готовый запрос — вставьте в Claude, ChatGPT или Codex

Собери поисковую кампанию для услуги «ремонт стиральных машин» в Казани с бюджетом 30 000 ₽ в месяц: группы по типам поломок, фразы с частотностью из Вордстата, минус-слова и по два объявления в группе. Покажи план целиком и ничего не создавай без моего подтверждения.

Пошаговая настройка с нуля — [«Как настроить Яндекс Директ с нуля»](https://lidfly.ru/articles/kak-nastroit-yandex-direct-s-nulya)

## Аудит Яндекс Директа: почему нет показов и куда уходит бюджет

ИИ проходит кабинет как директолог: статусы и модерация, поисковые запросы, площадки, минус-фразы, обучение стратегии и расход без конверсий. Подтверждённые препятствия он отделяет от наблюдений и не выдаёт неполную выборку за пустой кабинет.

| Проверка | Находка | Что предлагает ИИ |
| --- | --- | --- |
| Поисковые запросы | 9 нецелевых, 18% расхода | Минус-фразы на кампанию |
| Площадки РСЯ | 3 площадки без конверсий | Исключить площадки |
| Стратегия | Обучение остановлено | Сменить цель или поднять лимит |
| Объявления | 2 отклонены модерацией | Исправить текст и отправить |

Пример. Данные условные; при неполной статистике ИИ сообщает, какой части кабинета не хватило.

- Диагностика: почему объявления не показываются — `diagnose_ad_delivery`
- Минус-фразы кампаний и групп одним вызовом — `get_negative_keywords_audit`
- Хватает ли конверсий для обучения стратегии — `get_strategy_learning_status`
- Ставки, корректировки и автостратегии — `set_keyword_bids`
- Наборы минус-фраз — `add_negative_keyword_set`
- Категории автотаргетинга — `update_autotargeting`

### Ставки и стратегии

Ручные ставки, назначение по формуле, корректировки по устройствам, полу, возрасту и регионам, смена стратегии и лимитов — каждое изменение ИИ показывает до записи вместе с текущими значениями.

Готовый запрос — вставьте в Claude, ChatGPT или Codex

Проведи аудит всех активных кампаний за 30 дней: почему у части групп нет показов, какие поисковые запросы и площадки тратят бюджет без конверсий, обучается ли стратегия. Сначала покажи находки с цифрами, правки предложи отдельным списком.

Чек-лист из 30 проверок — [«Аудит Яндекс Директа»](https://lidfly.ru/articles/audit-yandex-direct)

## Статистика и отчёты Яндекс Директа

Расход, показы, клики, CTR, конверсии и CPA по кампаниям, группам, объявлениям и фразам за любой период. Отчёт по поисковым запросам, произвольный отчёт с нужными полями и охват медийных кампаний — без ручной выгрузки из мастера отчётов.

| Кампания | Расход | Клики | Конверсии | CPA |
| --- | --- | --- | --- | --- |
| Поиск — бренд | 12 400 ₽ | 1 830 | 41 | 302 ₽ |
| Поиск — услуги | 46 900 ₽ | 2 410 | 58 | 809 ₽ |
| РСЯ — ретаргетинг | 18 200 ₽ | 3 920 | 14 | 1 300 ₽ |
| ЕПК — товары | 6 800 ₽ | 940 | 4 | 1 700 ₽ |

Пример за сентябрь. Данные условные.

- Статистика кампаний, групп и объявлений — `get_campaign_stats`
- Статистика фраз и условий показа — `get_criteria_stats`
- Поисковые запросы — `get_search_queries`
- Произвольный отчёт Reports API — `get_custom_report`
- Охват и частота медийных кампаний — `get_reach_frequency_stats`

Готовый запрос — вставьте в Claude, ChatGPT или Codex

Сделай отчёт по всем кампаниям за сентябрь: расход, клики, конверсии и CPA по каждой, сравнение с августом и три главных вывода простыми словами. Отдельно — 10 самых дорогих поисковых запросов без конверсий.

10 инструментов Reports API в одном разборе — [«Статистика Яндекс Директа через ИИ»](https://lidfly.ru/articles/yandex-direct-reports-api)

## Цели и отчёты Яндекс Метрики через ИИ

Метрика подключается тем же входом в Яндекс. ИИ видит счётчики, создаёт и правит цели, строит отчёты по источникам трафика, страницам и целям, сводит расход Директа с конверсиями и выгружает сырые визиты через Logs API.

- Счётчики и цели — `metrika_get_goals`
- Создание и изменение целей — `metrika_create_goal`
- Отчёт по целям и конверсиям — `metrika_get_goals_report`
- Источники трафика и популярные страницы — `metrika_get_traffic_sources`
- Отчёт по рекламе Директа в Метрике — `metrika_get_direct_report`
- Выгрузка визитов через Logs API — `metrika_create_log_export`

Готовый запрос — вставьте в Claude, ChatGPT или Codex

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

Настройка и проверка целей — [«Цели в Яндекс Метрике через ИИ»](https://lidfly.ru/articles/celi-v-yandeks-metrike-cherez-ii)

## Как подключить Яндекс Директ к Claude, ChatGPT или Codex

Три шага, около трёх минут. Яндекс Директ и Метрика входят в MCP-пакет LidFly: 990 ₽ за 30 дней. Первые 7 дней — бесплатно, без карты и автосписаний.

### Шаг 1. Зарегистрируйтесь в LidFly

Email и код из письма — без пароля и без карты. После входа кабинет сразу откроет карточку «Яндекс» с кнопкой подключения.

### Шаг 2. Подключите кабинет через вход в Яндекс

Нажмите «Подключить Яндекс» и выберите личный профиль или организацию с кабинетом Директа — LidFly сохранит именно выбранный Яндексом логин. Метрика подключается тем же входом, клиенты агентского кабинета загрузятся сами. Если кабинет ещё не работал с API, LidFly покажет кнопку «Принять в Яндексе».

### Шаг 3. Добавьте LidFly в свой ИИ

Выберите клиент. Ключ копировать не нужно: вход по email через OAuth.

Адрес MCP-сервера: `https://lidfly.ru/mcp/v3`

Инструкции для Claude, ChatGPT, Codex, Cursor и других клиентов: [быстрый старт](https://lidfly.ru/docs/quickstart).

Проверка

Напишите ИИ «Покажи мои кампании в Яндекс Директе» — он вернёт список кампаний со статусами.

## Почему ИИ не испортит кабинет

Ошибка в ставке или минус-фразе стоит денег, поэтому каждое изменение проходит одни и те же проверки.

**Подтверждение перед каждым изменением**

ИИ показывает, какие кампании, группы, фразы и значения изменятся, и выполняет запись только после вашего «да».

**Было → станет**

Перед изменением ИИ читает текущее состояние и показывает разницу. Управление объявлениями проверяет итог контрольным чтением по каждому ID, автотаргетинг меняется только после чтения текущих настроек.

**Честно о неполных данных**

Если API вернул не всё, ИИ так и пишет: пустой ответ не считается доказательством, что кампаний или показов нет.

**Точный кабинет и клиент**

При нескольких логинах и агентских клиентах ИИ выбирает кабинет по точному логину, а не по похожему названию.

**Изменения только через ваш доступ**

LidFly работает в рамках прав подключённого логина и не обходит модерацию Яндекса.

## Все 152 инструмента MCP для Директа и Метрики

75 чтений ИИ вызывает через `call_tool`, 77 действий — через `call_write_tool` после вашего подтверждения. Список виден целиком; поиск и фильтр только сужают его.

### Кампании

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_campaigns` | Кампании с бюджетами, статистикой, раскрытыми стратегиями, наборами минус-фраз и целями Метрики best-effort | Чтение |
| `add_campaign` | Создать текстово-графическую кампанию со стратегией | Действие |
| `add_unified_campaign` | Создать единую перфоманс-кампанию для ЕПК/комбинаторных объявлений; совместимость стратегий и обязательные бюджеты/цели проверяются до запроса | Действие |
| `update_campaign` | Изменить настройки кампании: стратегию, бюджет, таргетинг | Действие |
| `update_cpm_banner_campaign` | Изменить медийную кампанию: стратегию CPM/CPV, частоту показов | Действие |
| `update_mobile_app_campaign` | Изменить мобильную кампанию: стратегию CPI/install, настройки | Действие |
| `update_unified_campaign` | Изменить единую перфоманс-кампанию: стратегию, PlacementTypes, цели | Действие |
| `manage_campaigns` | Удалить, остановить, возобновить, архивировать/разархивировать кампании | Удаление |

### Группы объявлений

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_adgroups` | Группы с раскрытыми кампаниями, регионами, фидами и наборами минус-фраз | Чтение |
| `add_adgroup` | Создать группу в кампании с геотаргетингом | Действие |
| `add_adgroups` | Batch-создание нескольких групп за один вызов (до 1000) | Действие |
| `update_adgroup` | Изменить название, регионы, минус-фразы | Действие |
| `delete_adgroups` | Удалить группы со всеми объявлениями и фразами | Удаление |

### Объявления

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_ads` | Объявления всех типов с фактическим Type; цену TEXT_AD запрашивайте отдельно через text_ad_price_field_names, содержимое RESPONSIVE_AD — через responsive_ad_field_names; Carousel старого TEXT_AD API не возвращает | Чтение |
| `get_responsive_ads` | Комбинаторные объявления с AdImages, текстами быстрых ссылок и уточнений | Чтение |
| `add_ad` | Compatibility-создание обычного объявления; CPM-видео принимает только проверенный CPM_VIDEO_CREATIVE | Действие |
| `add_responsive_ad` | Создать комбинаторное объявление в UNIFIED_AD_GROUP | Действие |
| `add_ads` | Batch compatibility для legacy TEXT_AD (до 1000) | Действие |
| `update_ad` | Изменить обычное объявление; fail-closed guards проверяют TextAd и новый CPM-видеокреатив | Действие |
| `update_ads` | Batch-правка подтверждённых legacy TEXT_AD; не применяется к RESPONSIVE_AD | Действие |
| `update_responsive_ad` | Изменить комбинаторное объявление без пересоздания; добавить или удалить подтверждённые изображения, максимум 5 | Действие |
| `manage_ads` | Удалить, остановить, возобновить, архивировать, модерировать объявления; контрольное чтение состояния по каждому ID | Удаление |
| `diagnose_ad_delivery` | Почему нет показов: состояние и модерация кампаний, групп, объявлений и фраз, показы за период; подтверждённые препятствия отдельно от наблюдений | Чтение |

### Ключевые фразы

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_keywords` | Фразы со ставками, статусами и раскрытыми кампаниями/группами | Чтение |
| `add_keywords` | Добавить ключевые фразы в группу (до 200 за раз) | Действие |
| `add_keywords_batch` | Batch-добавление фраз в несколько групп за один вызов (до 1000) | Действие |
| `update_keywords` | Изменить текст ключевых фраз | Действие |
| `manage_keywords` | Удалить, остановить, возобновить показы по фразам | Удаление |

### Ставки

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_keyword_bids` | Ставки для поиска и сетей с текстами фраз и названиями групп | Чтение |
| `set_keyword_bids` | Назначить ставки для фраз и автотаргетинга | Действие |
| `set_keyword_bids_auto` | Включить автоматическое управление ставками | Действие |

### Ставки (устаревший)

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_bids` | Ставки с ценами позиций, текстами фраз и названиями групп | Чтение |
| `set_bids` | Назначить ставки вручную | Действие |
| `set_bids_auto` | Включить автоставки | Действие |

### Корректировки ставок

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_bid_modifiers` | Корректировки для устройств, демографии, регионов | Чтение |
| `add_bid_modifiers` | Добавить корректировки (мобильные, пол/возраст, регионы) | Действие |
| `set_bid_modifiers` | Изменить коэффициенты корректировок | Действие |
| `delete_bid_modifiers` | Удалить корректировки ставок | Удаление |

### Автотаргетинг

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_autotargeting` | Автотаргетинги с категориями, брендами и ставками; фильтры states=OFF/ON/SUSPENDED, statuses=ACCEPTED/DRAFT/REJECTED и serving_statuses=ELIGIBLE/RARELY_SERVED; продолжение по курсору | Чтение |
| `update_autotargeting` | Изменить категории и бренды после обязательного чтения и merge с текущим состоянием; сервер не позволит выключить все категории или все три брендовые настройки | Действие |
| `manage_autotargeting` | Остановить, возобновить, удалить автотаргетинг | Удаление |

### Аудиторный таргетинг

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_audience_targets` | Условия нацеливания на аудиторию | Чтение |
| `add_audience_targets` | Создать аудиторные условия в группе | Действие |
| `manage_audience_targets` | Удалить, остановить, возобновить аудиторные условия | Удаление |
| `set_audience_target_bids` | Назначить ставки для аудиторных условий | Действие |

### Ретаргетинг

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_retargeting_lists` | Списки ретаргетинга с фильтром по типу (RETARGETING/AUDIENCE), Scope, правила | Чтение |
| `add_retargeting_list` | Создать условие: RETARGETING — цели Метрики и сегменты Аудиторий для ЕПК, AUDIENCE — медийные кампании | Действие |
| `update_retargeting_list` | Изменить список ретаргетинга: название, описание, правила | Действие |
| `delete_retargeting_lists` | Удалить списки ретаргетинга | Удаление |

### Динамические объявления

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_dynamic_ad_targets` | Условия таргетинга для динамических объявлений | Чтение |
| `add_dynamic_ad_targets` | Создать условия по URL, заголовку, содержимому | Действие |
| `manage_dynamic_ad_targets` | Удалить, остановить, возобновить динамический таргетинг | Удаление |
| `set_dynamic_ad_target_bids` | Назначить ставки для динамических условий | Действие |

### Смарт-баннеры

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_smart_ad_targets` | Фильтры смарт-баннеров со ставками и приоритетами | Чтение |
| `add_smart_ad_target` | Создать фильтр по условиям из фида | Действие |
| `update_smart_ad_target` | Изменить фильтр смарт-баннеров | Действие |
| `manage_smart_ad_targets` | Удалить, остановить, возобновить фильтры | Удаление |
| `set_smart_ad_target_bids` | Назначить ставки для фильтров | Действие |

### Фид-таргетинг

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_dynamic_feed_ad_targets` | Фильтры динамических объявлений по фиду | Чтение |
| `add_dynamic_feed_ad_targets` | Добавить фильтры по фиду | Действие |
| `manage_feed_ad_targets` | Удалить, остановить, возобновить фильтры фида | Удаление |
| `set_dynamic_feed_ad_target_bids` | Назначить ставки для фильтров фида | Действие |

### Минус-фразы

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_negative_keyword_sets` | Общие наборы минус-фраз | Чтение |
| `add_negative_keyword_set` | Создать набор минус-фраз для нескольких кампаний | Действие |
| `update_negative_keyword_set` | Изменить набор минус-фраз | Действие |
| `delete_negative_keyword_sets` | Удалить наборы минус-фраз | Удаление |
| `get_negative_keywords_audit` | Получить все видимые через API минус-фразы по кампании или группам одним вызовом. | Чтение |

### Исследование фраз

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `deduplicate_keywords` | Убрать дубли из списка ключевых фраз | Чтение |
| `check_search_volume` | Проверить наличие поискового трафика по фразам | Чтение |

### Дополнения объявлений

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_campaign_addons` | Read-only: фактические быстрые ссылки и уточнения TEXT_AD/RESPONSIVE_AD/SHOPPING_AD/LISTING_AD; общие элементы и одинаковые конфигурации по кампаниям, группам или объявлениям | Чтение |

### Быстрые ссылки

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `sitelinks` | Быстрые ссылки: get с пагинацией, add и delete; scope-add создаёт новый набор, заменяет SitelinkSetId у найденных сейчас объявлений и делает до трёх контрольных чтений без удаления старого набора | Действие |

### Уточнения

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `ad_extensions` | Уточнения: get, add и delete; scope-add привязывает к найденным сейчас объявлениям и после ads.update до трёх раз проверяет точное множество для SET или наличие новых ID для ADD | Действие |

### Изображения

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `ad_images` | Общая библиотека кабинета: получить, загрузить или удалить; не показывает состав и порядок карусели объявления | Действие |
| `generate_ad_image` | AI-креатив: сначала показать промпт и формат, затем генерировать только после подтверждения; исходник и до 5 безопасных экспортов без увеличения; на пробной неделе — до 5 изображений из общего промобюджета при достаточном остатке; при оплаченном MCP-доступе — 5 бесплатных/мес, далее по прайсу в подтверждении; применение image ID подтверждается отдельно | Действие |

### Видео

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `ad_videos` | Видеодополнения: получить (get) или загрузить по URL (add). Возвращает строковый VideoId для VIDEO_EXTENSION_CREATIVE | Действие |

### Креативы

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `creatives` | Получить креативы (get) или создать только VIDEO_EXTENSION_CREATIVE (add). CPM_VIDEO_CREATIVE создаётся в интерфейсе Директа | Действие |

### Визитки

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `vcards` | Визитки: получить (get), создать (add) или удалить (delete) | Действие |

### Фиды

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_feeds` | Источники данных о товарах для динамических кампаний | Чтение |
| `inspect_feed_usage` | Найти фид по ID/URL и проверить обработку, число оферов и связанные кампании | Чтение |
| `add_feed` | Создать фид по URL (XML/CSV/TSV) | Действие |
| `update_feed` | Изменить настройки фида | Действие |
| `delete_feeds` | Удалить фиды | Удаление |

### Бизнес-профили

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_businesses` | Полный постраничный список организаций из Яндекс Бизнеса (страницы по 1000) без повторного чтения одностраничного ответа | Чтение |

### Турбо-страницы

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_turbo_pages` | Метаданные опубликованных Турбо-страниц и связанных turbo.site-ссылок; контент редактируется в интерфейсе Директа | Чтение |

### Лиды

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_leads` | Отправленные формы без чтения или изменения контента страницы | Чтение |

### Стратегии

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_strategies` | Портфельные стратегии: фильтры, пагинация и совместимые с live API общие/подтиповые поля; цели multi-goal читаются из PriorityGoals, названия целей Метрики раскрываются best-effort | Чтение |
| `add_strategy` | Создать кликовую или конверсионную портфельную стратегию, включая multi-goal, CRR, MAX_PROFIT, MANUAL_CPM и HIGHEST_POSITION; затем привязать кампании через package_strategy_id | Действие |
| `update_strategy` | Частично изменить тип, бюджет, цель, CPA/CRR, атрибуцию, счётчики и ключевые цели с чтением до и после записи | Действие |
| `manage_strategies` | Архивировать или разархивировать стратегии | Удаление |

### Рекламодатели

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_client` | Параметры аккаунта, валюта, часовой пояс | Чтение |
| `update_client` | Изменить телефон и информацию рекламодателя | Действие |
| `get_account_balance` | Точный баланс общего счёта через AccountManagement; недоступный остаток отмечается как непроверенный и не заменяется нулём | Чтение |

### Клиенты агентства

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_agency_clients` | Список клиентов: AgencyClients.get, затем fallback на Clients.get.ManagedLogins; без автоматического списка используйте сохранённые client_login | Чтение |
| `save_yandex_client_account` | Проверить точный client_login и после подтверждения сохранить кабинет. Настройка всего аккаунта LidFly: доступна только владельцу, меняет режим подключения и учитывается в тарификации по количеству | Действие |
| `add_agency_client` | Зарегистрировать нового клиента агентства | Действие |
| `update_agency_client` | Изменить параметры клиента | Действие |
| `agency_dashboard` | Сводка по агентским клиентам и сохранённым client_login: кампании, показы, статус | Чтение |
| `agency_budget_alerts` | Проверка остатков кампаний и общих счетов в RUB: проблемы, непроверенные данные и охват клиентов | Чтение |
| `agency_client_stats` | Статистика по агентским клиентам и сохранённым client_login за период | Чтение |
| `agency_campaign_audit` | Аудит кампаний и объявлений, оплаты и остатков ниже 500 RUB с указанием непроверенных данных | Чтение |
| `agency_bulk_manage` | Массовое управление кампаниями по клиентам | Действие |

### Справочники

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `get_dictionaries` | Регионы, валюты, часовые пояса, метро, интересы | Чтение |
| `get_geo_regions` | Поиск регионов по названию/ID для гео-таргетинга | Чтение |

### Изменения

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `check_changes` | Все изменения объектов с указанного момента | Чтение |
| `check_campaign_changes` | Изменения в конкретных кампаниях | Чтение |
| `check_dictionary_changes` | Изменения в справочниках | Чтение |

### Статистика

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `discover_all_campaigns` | Кампании, фактически наблюдаемые Reports API за выбранный период; не гарантирует все объекты веб-интерфейса | Чтение |
| `get_campaign_stats` | Показы, клики, расход, CTR, CPC и конверсии; без goals — агрегат по всем целям Метрики и модель Reports API по умолчанию, attribution применяется только с непустым goals | Чтение |
| `get_search_queries` | Строки поисковых запросов по одной, нескольким или всем кампаниям выбранного кабинета с фильтром групп. Строгие фильтры показов, кликов и расхода; compact выводит больше строк. До 200 строк и 10 000 символов; первая страница считает размер и итоги, сообщает полноту и охват. next_call сохраняет параметры и накопленные суммы; страница не является полным отчётом | Чтение |
| `analyze_search_queries` | Числовые итоги всех прочитанных поисковых строк без хранения отчёта: расход, клики, показы, конверсии, CTR/CPC/CPA/CR, разбивка по кампаниям или группам и до 20 дорогих строк. Полнота расчёта и ограничения явные; примеры не заменяют смысловой анализ всех запросов | Чтение |
| `get_adgroup_stats` | Статистика по группам объявлений — сравнение эффективности групп | Чтение |
| `get_ad_stats` | A/B-статистика с текстами и публичными URL изображений; в Google Sheets креативы вставляются через IMAGE, а не как ссылки | Чтение |
| `get_criteria_stats` | Статистика по ключевым фразам и условиям таргетинга | Чтение |
| `get_account_stats` | Общая статистика по всему аккаунту с группировкой по времени | Чтение |
| `get_custom_report` | Произвольный CUSTOM_REPORT: Revenue/PurchaseRevenue/Profit/GoalsRoi, цели и модели вплоть до LSCCD; поисковые запросы — через get_search_queries | Чтение |
| `get_reach_frequency_stats` | Охват и частота для медийных кампаний | Чтение |
| `get_strategy_learning_status` | Оценка конверсий по фактическим целям за 7 дней: раскрывает GoalId=13 и пакетные стратегии, ограничивает пакет отчётов общим временем и не выдаёт неоднозначность за нативный статус Директа | Чтение |

### Яндекс Метрика

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `metrika_create_log_export` | После подтверждения ставит выгрузку visits/hits в очередь; владельцу проект необязателен, участнику нужен выданный проект; source_chain учитывает атрибуцию | Действие |
| `metrika_get_log_export` | Статус, прогресс, безопасный preview и session download URL выгрузки | Чтение |
| `metrika_get_log_exports` | До 20 доступных выгрузок: личные владельца или выгрузки выбранного проекта | Чтение |
| `metrika_request_log_export_download` | Одноразовая приватная ссылка на готовый TSV.GZ сроком на пять минут; только MCP | Чтение |
| `metrika_cancel_log_export` | После подтверждения удаляет локальные данные и отменяет либо очищает сохранённый request_id Яндекса | Удаление |
| `metrika_get_counters` | Список доступных счётчиков Метрики (ID, сайт, статус, право доступа); в Пространстве показывает только привязанные счётчики | Чтение |
| `metrika_get_counter` | Детали одного счётчика (название, сайт, настройки) | Чтение |
| `metrika_delete_counter` | После подтверждения удаляет один точный счётчик: только владелец own, один DELETE и проверка Deleted. Сбор статистики прекратится; при неизвестном исходе повтор запрещён | Удаление |
| `metrika_get_goals` | Цели счётчика — ID нужны для метрик конверсий | Чтение |
| `metrika_get_goal` | Точечно перечитывает одну цель по goal_id со всеми настройками её фактического типа | Чтение |
| `metrika_create_goal` | После подтверждения создаёт типизированную цель и проверяет результат контрольным чтением | Действие |
| `metrika_update_goal` | После подтверждения частично изменяет цель через безопасные GET, один PUT и контрольный GET | Действие |
| `metrika_delete_goal` | После подтверждения необратимо удаляет точную цель без автоматического повтора и проверяет список | Удаление |
| `metrika_get_report` | Универсальный отчёт с явной атрибуцией; default lastsign, raw fixed expressions сохраняются | Чтение |
| `metrika_get_report_bytime` | Динамика с тем же явным attribution contract | Чтение |
| `metrika_get_report_comparison` | Сравнение сегментов или периодов с общей моделью атрибуции | Чтение |
| `metrika_get_page_search_phrases` | Фразы по странице: органика и Директ используют одну модель, default lastsign | Чтение |
| `metrika_get_direct_report` | Кампании Директа из Метрики через parameterized dimensions | Чтение |
| `metrika_get_traffic_sources` | Согласованные источники и фильтры; ad означает весь платный трафик | Чтение |
| `metrika_get_audience` | Демография и техника: гео, устройства, пол, возраст | Чтение |
| `metrika_get_popular_pages` | Популярные страницы входа/выхода | Чтение |
| `metrika_get_goals_report` | Конверсии по цели с явной моделью атрибуции | Чтение |
| `metrika_get_yandex_business_events` | События ресторана в Яндекс Картах: сравнение периодов, дни недели, поверхности, неизвестные события и методологические предупреждения | Чтение |
| `metrika_get_segments` | Сегменты Метрики. | Чтение |
| `metrika_get_segment` | Сегмент Метрики. | Чтение |
| `metrika_find_segments` | Найти существующие API/UI-сегменты Метрики по подстроке имени в точном разрешённом счётчике. | Чтение |

### Задачи (legacy)

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `add_tasks` | Legacy notice: задачи переехали в Workspace MCP (/mcp/workspace). Там же хранятся клиенты, кампании, решения, контекст и AI-автозапуски | Чтение |
| `get_tasks` | Legacy notice: используйте workspace_get_tasks, workspace_get_context или workspace_get_scheduled_ai_tasks | Чтение |
| `complete_task` | Legacy notice: используйте workspace_complete_task | Чтение |

### Медиафайлы

| Инструмент | Что делает | Тип |
| --- | --- | --- |
| `list_stored_images` | Изображения в хранилище LidFly: квота, сроки хранения и подтверждённые копии ВК; без запросов в ВК. | Чтение |
| `delete_stored_images` | Удалить выбранные локальные изображения после согласия: публичные URL медиатеки перестанут работать, фото и посты ВК сохранятся. | Удаление |
| `request_upload` | Запросить URL для загрузки локального файла (pre-signed URL → curl -T) | Действие |
| `list_media` | Список загруженных медиафайлов с публичными URL | Чтение |
| `delete_media` | Удалить загруженный медиафайл | Удаление |
| `get_recent_images` | Недавние изображения. | Чтение |

### Технические подробности для ИИ-клиентов

- Яндекс Товары (`merchants_*`) и Яндекс Еда (`eda_*`) подключаются отдельно от Директа и описаны на своих страницах: [Яндекс Товары](https://lidfly.ru/docs/yandex-products) и [Яндекс Еда](https://lidfly.ru/docs/yandex-eda).
- Несколько входов в Яндекс в одном аккаунте LidFly различаются параметром `connection_id`. При нескольких логинах или клиентах ИИ сначала вызывает `get_provider_context`; точный логин Директа передаётся в `client_login`, свободный поиск по проекту, названию и ИНН — в `query`.
- Если известна кампания, `resolve_campaign_scope` принимает ровно один селектор: точный `campaign_id` или полное название. Кампания, найденная только в Reports API, получает `access_mode=statistics_only` и не разрешает запись. Инструменты Метрики используют `counter_id`, а не `client_login`.
- Агентские клиенты берутся из `AgencyClients.get`, при ошибке 54 — из `Clients.get.ManagedLogins`. Агентский пакет стоит 4 990 ₽ за 30 дней; кабинеты из ManagedLogins — по 990 ₽ за каждый, но не больше 4 990 ₽ за одно подключение. Точный `client_login` можно сохранить через подтверждаемый `save_yandex_client_account`.
- Код 513 означает, что выбранный профиль не подключён к Директу: повторите вход и выберите организацию или другой профиль. Код 53 на запросе с `client_login` сам по себе не отключает подключение: LidFly проверяет основной кабинет без этого заголовка.
- Если задача упирается в ограничение публичного API Яндекса, `search_tools` добавляет `capability_notice.status=unsupported_by_provider_api` со следующим шагом. Похожие инструменты нельзя использовать вместо неподдерживаемой части задачи.
- При перегрузке MCP-сервер отвечает HTTP 429 с `Retry-After` и JSON-RPC ошибкой -32002: повторите запрос после задержки, без параллельных повторов.
- Кампании из «Мастера кампаний»: `discover_all_campaigns` видит только то, что вернул Reports API за период. Найденное только в Reports доступно для статистики, но не для управления.

## Чего пока нет

Честный список, чтобы вы не тратили время на проверку того, что сейчас не работает.

- **Лендинги clients.site и Турбо-страницы**: Публичный API не отдаёт и не меняет контент лендингов Директа — правьте их в интерфейсе Яндекса. Метаданные Турбо-страниц и отправленные формы ИИ читает.
- **Видеокреатив для медийных объявлений**: API не создаёт CPM_VIDEO_CREATIVE. Загрузите креатив в интерфейсе Директа, а ИИ подставит его ID в объявление и проверит тип до записи.
- **Карусель старого текстового объявления**: API не возвращает состав и порядок карусели TEXT_AD. Изображения для комбинаторного объявления нужно подтвердить заново.
- **Объекты «Мастера кампаний»**: Часть из них не возвращают ни Campaigns API, ни Reports API. Управлять можно только кампаниями режима эксперта.

## Примеры и разборы в блоге LidFly

Длинные сценарии с готовыми запросами и разбором результата.

- [Как настроить Яндекс Директ с нуля: пошаговая инструкция 2026](https://lidfly.ru/articles/kak-nastroit-yandex-direct-s-nulya) — Инструкция · 26 августа 2026. Настройте Яндекс Директ самостоятельно: выберите точку старта, подготовьте сайт, цели и бюджет. Пройдите восемь шагов, модерацию и проверку первой заявки с LidFly.
- [Аудит Яндекс Директа: чек-лист из 30 проверок](https://lidfly.ru/articles/audit-yandex-direct) — Инструкция · 26 августа 2026. Пошаговый аудит Яндекс Директа: проверьте цели Метрики, расходы, стратегии, поисковые запросы, РСЯ, объявления, посадочные и безопасные правки через ИИ.
- [Статистика Яндекс Директа через ИИ: 10 инструментов Reports API](https://lidfly.ru/articles/yandex-direct-reports-api) — Обновление · 4 мая 2026. Кампании, поисковые запросы, группы, объявления, фразы, охват, произвольные отчёты и обучение стратегий. Разбираем, какие инструменты доступны в LidFly, зачем они нужны и какими промптами запускать анализ.
- [Настройка и ведение Яндекс Директа нейросетью: как подключить ИИ к кабинету](https://lidfly.ru/articles/neyroset-dlya-reklamy) — Инструкция · 31 мая 2026. ИИ подключается к вашему кабинету Директа и ведёт кампании сам: семантика, минус-слова, ставки, отчёты. Не советы, а действия.
- [Цели в Яндекс Метрике: настройка и проверка через ИИ](https://lidfly.ru/articles/celi-v-yandeks-metrike-cherez-ii) — Инструкция · 21 августа 2026. Настройте цели в Яндекс Метрике через ИИ: выберите один из 13 типов, проверьте дубли, подтвердите создание и используйте goal_id в отчётах LidFly безопасно.
- [11 примеров запросов к Яндекс Метрике через ИИ](https://lidfly.ru/articles/metrika-examples) — Инструкция · 15 марта 2026. Конверсии кампаний, отказы по фразам, аудитория, сравнение периодов &mdash; готовые промпты, которые можно скопировать и использовать прямо сейчас.

[Все статьи блога](https://lidfly.ru/articles/)

## Частые вопросы

### Можно ли подключить нейросеть к Яндекс Директу?

Да. LidFly подключает кабинет Директа к Claude, ChatGPT, Codex, Cursor и другим клиентам с поддержкой MCP, а также к встроенному чату LidFly. ИИ читает кабинет и вносит изменения только после вашего подтверждения.

### Можно ли через ИИ изменить лендинг Директа на clients.site?

Нет: публичный API Яндекса не отдаёт и не меняет контент лендингов. Откройте лендинг в интерфейсе Директа; менять вместо этого объявление или кампанию не нужно.

### Можно ли работать с кампаниями из «Мастера кампаний»?

Только с теми, которые возвращает Campaigns API. Найденные лишь в Reports API доступны для статистики. Для полного контроля через ИИ удобнее кампании режима эксперта: ЕПК или обычные поисковые.

### Как создать видеокреатив для медийного объявления?

Создайте или загрузите его в веб-интерфейсе Директа: API создаёт только видеодополнения. Затем ИИ получит ID креатива и подставит его в объявление.

### Работает ли LidFly с агентскими кабинетами?

Да. Клиенты агентства загружаются автоматически, ИИ работает с каждым по точному логину. Для каждого клиента удобно завести отдельный проект с памятью и задачами.

### Нужно ли отдельно подключать Метрику?

Нет. Метрика подключается тем же входом в Яндекс, что и Директ. Вебмастер, Аудитории и Яндекс Товары подключаются отдельно.

### Сколько стоит?

Яндекс Директ и Метрика входят в MCP-пакет — 990 ₽ за 30 дней, агентский пакет — 4 990 ₽. Первые 7 дней бесплатно, без карты.
