A1 инженерная AI-компания GitHub
Подключить MCP-сервер Яндекс Директ к AI-агенту Открытый код, MIT, npm-пакет. Инструкция по подключению к Claude, Cursor и Codex — в репозитории; вопросы по внедрению — в Telegram. Репозиторий на GitHub Telegram

Яндекс Директ: Статистика — MCP-инструмент (tool)

MCP-инструмент (tool) для Яндекс Директа: Запрашивает отчёт по эффективности через сервис Reports Яндекс Директа.

Техническое имя: get_statistics

Какую задачу решает

Я хочу посмотреть статистику.

Запрашивает отчёт по эффективности через сервис Reports Яндекс Директа.

Когда использовать

Используйте эту возможность, когда нужен результат «Статистика» без ручной работы в интерфейсе Яндекс Директа. Операция выполняется только по вызову из AI-приложения.

Что нужно передать

  • reportType — необязательно. Тип отчёта. По умолчанию CAMPAIGN_PERFORMANCE_REPORT.
  • dateRangeType — необязательно. Предустановленный период. Если заданы dateFrom/dateTo, подставляется CUSTOM_DATE.
  • dateFrom — необязательно. Дата начала YYYY-MM-DD (обязательна для CUSTOM_DATE).
  • dateTo — необязательно. Дата окончания YYYY-MM-DD (обязательна для CUSTOM_DATE).
  • fieldNames — необязательно. Колонки отчёта (должны быть допустимы для его типа).
  • campaignIds — необязательно. Ограничить отчёт этими id кампаний.
  • includeVat — необязательно. Включать ли НДС в расход. По умолчанию true.
  • sortBy — необязательно. Метрика для ранжирования строк детализации. По умолчанию Cost.
  • order — необязательно. Порядок сортировки строк детализации. По умолчанию desc.
  • topN — необязательно. Максимум строк детализации в сводке (на сервере ограничено 100). По умолчанию 50.
  • minCost — необязательно. Включать в детализацию только строки с Cost >= этого значения.
  • queryContains — необязательно. Включать только строки, где запрос или условие содержит эту подстроку (без учёта регистра).
  • zeroClicksOnly — необязательно. Включать в детализацию только строки с 0 кликов.
  • zeroConversionsOnly — необязательно. Только строки с clicks>0 и 0 конверсий (нужно Conversions в fieldNames).

Что вернёт

Возвращает компактный JSON-ответ исходного API или понятную ошибку MCP-инструмента. Точный состав полей зависит от операции и описан в техническом справочнике.

Что изменится в Яндекс Директе

Инструмент только читает данные или состояние подключения и не изменяет их.

Пример запроса

Посмотреть статистику в Яндекс Директе. Если не хватает обязательных идентификаторов, сначала уточни их.

Возможные ошибки и ограничения

По умолчанию отчёт АГРЕГИРОВАН за весь период (одна строка на объект) — добавлять "Date" в fieldNames только для динамики по дням или вопросов о трендах. ALL_TIME без фильтра по кампаниям отклоняется для отчётов SEARCH_QUERY/CRITERIA: нужно передать campaignIds или ограниченный период. SEARCH_QUERY_PERFORMANCE_REPORT возвращает не сырые строки, а ВЫЧИСЛЕННУЮ СВОДКУ (итоги по ВСЕМ строкам + детализация top-N + свёртка хвоста + количество строк без кликов и без конверсий); её форму задают sortBy/topN/minCost/queryContains/zeroClicksOnly/zeroConversionsOnly, а для подсчётов по конверсиям нужно добавить Conversions в fieldNames. Остальные типы отчётов возвращают строки, разделённые табуляцией (без заголовка).

Доступ также зависит от прав токена, квот и ограничений исходного API.

Связанные MCP-инструменты

Связанных специализированных инструментов в этой группе нет.

Технические сведения