Yandex Direct Manager

npm version MIT license Glama MCP server

Подключите Claude или ChatGPT к Яндекс Директу и управляйте рекламой в диалоге: «Где уходят деньги впустую?» → ассистент найдёт кампании с ROAS < 1 и предложит, что отключить.

Connect Claude or ChatGPT to Yandex Direct and manage ad campaigns in chat — analytics, wasted-spend detection, bids, budgets, negative keywords.

Попробовать бесплатно — 7 дней тарифа «Профи» →

Сайт / Website: https://app.marketscore.ru

---

Что это

marketscore-direct-mcp — тонкий коннектор к хостовому MCP-серверу Direct Manager. Сам сервер, доступ к Direct API и вся логика работают на стороне сервиса — этот пакет лишь подключает к нему ваш ИИ-ассистент.

Как выглядит работа:

Вы: Где у меня уходят деньги впустую за последние 14 дней?

Claude: Нашёл 3 проблемы на 12 400 ₽: кампания «Ремонт квартир — РСЯ» потратила 4 210 ₽ без единой конверсии; площадка dsp.example даёт ROAS 0.2; 6 ключей с расходом и нулём заявок. Отключить площадку и добавить ключи в минус-слова?

Что умеет

77 инструментов поверх Direct API v5 и Reports API (на тарифах «Ассистент» и «Профи» — 76, на «Агентстве» — 77, включая портфельный accounts_overview):

• Аналитика и статистика — метрики кампаний по периодам и срезам: устройства, пол, возраст, площадки РСЯ, гео; поисковые запросы; доля показов.
• Поиск неэффективных расходов — кампании с ROAS < 1, расход без конверсий, лишние площадки и ключи.
• Управление — пауза/возобновление, дневной и недельный бюджет, стратегии (включая конверсионные с целью и таргет CPA/ROAS), минус-слова, ключи, ставки и корректировки.
• Сборка кампаний с нуля — кампания → группа → объявление с быстрыми ссылками и UTM.
• ИИ-выводы — прогноз расхода и конверсий на 30 дней, диагностика просадок (трафик/CR/CPC), объяснение изменений период-к-периоду с драйверами, ранжированный топ находок в рублях, готовый еженедельный бриф одним вызовом.
• Wordstat — подбор слов с частотностями.
• Для агентств — портфельный обзор по всем аккаунтам: расход, прибыль, лишние траты и остаток бюджета по каждому клиенту в одном ответе.

Действия на запись помечены отдельными аннотациями — ассистент и клиент видят, что именно меняется, до применения правки. Ошибки Direct API обрабатываются корректно, в том числе «тихие» (когда API отвечает 200, но правка не применилась).

Установка

Claude (Desktop, веб, Code) и ChatGPT — по ссылке

Добавьте удалённый MCP-коннектор:

https://app.marketscore.ru/api/mcp

Ассистент откроет вход — авторизуйтесь по OAuth. Токен Яндекса ассистенту не передаётся.

Локальные MCP-клиенты (Cursor, VS Code, Cline, Zed) — через мост

npx -y marketscore-direct-mcp

Пример конфигурации MCP-клиента:

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

Тарифы и доступ

Коннектору нужен аккаунт Direct Manager. На регистрации — 7 дней тарифа «Профи» бесплатно (включая ИИ-ассистента в Claude/ChatGPT). Дальше:

• «Ассистент» — 990 ₽/мес: полный MCP-набор (76 инструментов) для работы из чата ИИ, до 3 аккаунтов Директа. Без веб-дашборда — только ассистент.
• «Профи» — 1 990 ₽/мес: те же 76 инструментов плюс веб-дашборд с аналитикой и автопилотом, до 5 аккаунтов Директа.
• «Агентство» — 9 900 ₽/мес: 77 инструментов (плюс портфельный обзор accounts_overview), до 20 аккаунтов.

Без действующего тарифа сервер отдаёт 0 инструментов. Регистрация: https://app.marketscore.ru/register · Тарифы: https://app.marketscore.ru/pricing

Чем отличается от open-source обёрток над Direct API

Существуют self-host MCP-обёртки над Direct API (например, mcp-yandex-direct). Честное сравнение:

	Direct Manager (этот коннектор)	Self-host обёртка
Установка	OAuth-вход по ссылке	получить токен Директа и вписать его в конфиг
ИИ-выводы, аудит, автопилот	есть (прогноз, диагностика, бриф, топ находок)	нет — только сырые вызовы API
Веб-дашборд и Telegram-бот	есть	нет
Портфель аккаунтов	есть (обзор по всем клиентам)	нет
Цена	подписка (7 дней бесплатно)	бесплатно, но настраивать и хостить самому
Где живёт токен Яндекса	на сервисе, в конфиге клиента его нет	локально в конфиге клиента

Безопасность

• Авторизация — OAuth 2.1: токен Яндекса не передаётся ассистенту и не лежит в конфиге клиента, он хранится на стороне сервиса.
• Смена пароля аккаунта Direct Manager отзывает все выданные MCP-доступы.
• Действия на запись помечены аннотациями и подтверждаются на стороне MCP-клиента.
• Персональные данные хранятся на серверах в РФ (152-ФЗ).

FAQ

Это бесплатно? Первые 7 дней — да (триал тарифа «Профи» на регистрации). Дальше — тариф от «Ассистента» (990 ₽/мес, MCP-only) и выше.

Куда попадает токен Директа? Он выдаётся сервису Direct Manager при OAuth-подключении и хранится на его серверах. Ассистент и MCP-клиент токена не видят.

Может ли ассистент что-то сломать в кабинете? Инструменты на запись помечены отдельно, и MCP-клиент запрашивает подтверждение перед их вызовом. Паузы кампаний и бюджеты автопилот сам не трогает — только по вашей команде.

Работает ли с ChatGPT, Cursor, VS Code? Да: Claude и ChatGPT подключаются по URL напрямую, Cursor/VS Code/Cline/Zed — через этот пакет (npx -y marketscore-direct-mcp).

Чем отличается от бесплатных MCP-обёрток? Кроме доступа к API — слой ИИ-выводов, аудит, дашборд, Telegram-бот и портфельный обзор; токен Яндекса не хранится в конфиге. Подробнее — таблица выше.

Работает ли без подписки? Нет — без действующего тарифа сервер отдаёт 0 инструментов.

Docker

docker build -t marketscore-direct-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-direct-mcp

OAuth-URL печатается в stdout — браузер из контейнера не откроется, перейдите по ссылке вручную. Токены mcp-remote живут в ~/.mcp-auth — смонтируйте volume, чтобы не переавторизовываться при каждом запуске.

Полезные ссылки

• Что такое MCP-сервер для Яндекс Директа: https://app.marketscore.ru/blog/mcp-server-yandex-direct
• ИИ для Яндекс Директа — инструменты 2026: https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026
• Управление Директом через Claude и ChatGPT: https://app.marketscore.ru/blog/upravlenie-yandex-direct-cherez-claude-chatgpt

---

English

Direct Manager is an AI/MCP service for Yandex Direct (Russian search advertising). This package is a thin connector to the hosted Direct Manager MCP server: it lets Claude, ChatGPT, or any MCP client read campaign analytics and run actions (pause, bids, budgets, negative keywords) on a Yandex Direct account from chat.

Install (remote, Claude/ChatGPT): add connector URL https://app.marketscore.ru/api/mcp and sign in via OAuth.

Install (local MCP clients — Cursor, VS Code, Cline, Zed):

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

Tools: 77 tools on top of Direct API v5 and Reports API — campaign analytics by device/gender/age/placements/geo, search queries, impression share, wasted-spend detection (ROAS < 1), campaign management (pause, budgets, strategies, negative keywords, bids), building campaigns from scratch, AI insights (spend forecast, drop diagnosis, change explanation, weekly brief), Wordstat keyword research, and a cross-account portfolio overview for agencies.

Pricing: a Direct Manager account is required; sign-up includes a 7-day free Pro trial. Assistant — 990 ₽/mo (76 tools, chat-only, 3 Direct accounts); Pro — 1 990 ₽/mo (76 tools + web dashboard, 5 accounts); Agency — 9 900 ₽/mo (77 tools incl. portfolio overview, 20 accounts). Without an active plan the server exposes zero tools.

FAQ:

Is it free? The first 7 days are (Pro trial on sign-up); after that a subscription is required.

Where does my Yandex token go? It stays on the Direct Manager service — the assistant and the MCP client never see it, and it is not stored in any local config.

Can the assistant break my ad account? Write tools are annotated separately and the MCP client asks for confirmation before running them.

Keywords: Yandex Direct, Яндекс Директ, MCP, Model Context Protocol, MCP server, PPC, ads management, campaign analytics, ROAS, negative keywords, Wordstat, Claude, ChatGPT, Cursor, AI marketing.

License

MIT — see LICENSE. Коннектор открыт; сервис Direct Manager — платный SaaS. / The connector is open; the Direct Manager service is a paid SaaS.