Claude Code, Cursor и любой MCP-совместимый агент смогут сами доставать кампании, ключевые фразы и статистику из Директа и отвечать на вопросы о рекламе на ваших реальных данных. Вы добавляете OAuth-токен один раз в кабинете — дальше агент работает через один эндпоинт Neurly.
Бесплатно · ключи шифруются · инструменты только для чтения
Никаких дашбордов и выгрузок — обычный вопрос в чате. Агент сам выберет нужные инструменты Яндекс.Директ, вызовет их и посчитает ответ.
direct_campaigns_list — Список кампаний через Campaigns.get: тип, статус, состояние, стратегия показов и дневной бюджет.direct_adgroups_list — Группы объявлений выбранных кампаний (AdGroups.get) со статусами и регионами показа.direct_ads_list — Объявления с заголовками, текстами, ссылками и статусом модерации (Ads.get).direct_keywords_list — Ключевые фразы со ставками, статусами и параметрами показа (Keywords.get).direct_stats_report — Статистика за период через сервис Reports: показы, клики, расход, CTR, средняя цена клика, конверсии — с разбивкой по кампаниям, группам или фразам.direct_search_queries_report — Отчёт по реальным поисковым запросам пользователей (SEARCH_QUERY_PERFORMANCE_REPORT) с показами, кликами и расходом.direct_client_info — Информация о рекламодателе из Clients.get: валюта, настройки, представители, остаток баллов API.direct_dictionaries_get — Справочники Директа (Dictionaries.get): регионы показа, валюты, категории — для расшифровки идентификаторов в отчётах.claude mcp add --transport http neurly https://neurly.ru/v1/mcp --header "Authorization: Bearer sk-neurly-..."
Это «переходник» между ИИ-агентом и API Директа. MCP (Model Context Protocol) — открытый протокол, по которому Claude Code, Cursor и другие агенты подключают внешние инструменты. MCP-сервер Neurly превращает методы Direct API v5 (Campaigns.get, Keywords.get, сервис Reports) в инструменты, которые агент вызывает сам: вы спрашиваете «какие фразы съедают бюджет без конверсий» — агент достаёт отчёт и отвечает на ваших данных.
Токен добавляется один раз в кабинете Neurly и хранится в зашифрованном виде; в логи и ответы агенту он не попадает. Все инструменты — только чтение: агент не сможет изменить ставки, остановить кампанию или отправить объявление на модерацию, даже если его об этом попросить. Отозвать токен можно в любой момент в Яндекс ID.
MCP-серверы Neurly бесплатны и останутся бесплатными. Нужен только аккаунт Neurly с положительным балансом — сам баланс при работе MCP-инструментов не расходуется. Само API Директа со стороны Яндекса тоже бесплатно.
Да, как и любое приложение, работающее с Direct API: запросы идут от вашего OAuth-токена и тратят ваш суточный лимит баллов (units). Лимит индивидуален и зависит от активности кампаний, а начисляется по 1/24 в час. Read-only запросы дешёвые, а остаток баллов виден в заголовке Units каждого ответа — мы планируем отдавать его инструментом direct_client_info, чтобы агент сам следил за лимитом.
Официального MCP-сервера Яндекс для Директа не публикует; встречаются community-реализации на GitHub, которые нужно ставить и обновлять локально, самостоятельно разбираясь с токенами и офлайн-очередью Reports API. Hosted-вариант Neurly не требует установки: один эндпоинт со всеми вашими интеграциями (Директ, Ozon и другие), токены зашифрованы на сервере, а обработку TSV-отчётов и повторные запросы при кодах 201/202 сервер берёт на себя.