Marketscore Direct MCP

Direct Manager — MCP для Яндекс Директа

Подключите 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 дней тарифа «Профи» →](https://app.marketscore.ru/register)

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

---

Что это

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

У сервиса два независимых MCP-сервера: рекламный (Директ, VK, Авито, Wordstat) и SEO-шный (Вебмастер, Search Console, Метрика, Topvisor) — раздел про SEO ниже.

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

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

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

Что умеет

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

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

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

MarketScore SEO — второй MCP, для поисковой оптимизации

У того же аккаунта есть отдельный MCP-сервер для SEO: он не про рекламу, а про органический поиск — Яндекс Вебмастер, Google Search Console, Яндекс Метрика, Topvisor и Wordstat в одном ассистенте.

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

Это другой адрес и другая подписка: SEO-тариф не входит в тарифы Директа и наоборот. Инструменты Директа на SEO-адресе не появляются, и наоборот.

Вы: Почему просел трафик из поиска за последние 28 дней?

Claude: Клики упали с 940 до 610. Сравнение считаю только по источникам, измерившим оба периода: Search Console — да, Вебмастер — да, Topvisor не подключён, позиции независимо не проверялись. Основная просадка — раздел /catalog: 18 страниц выпали из поиска Яндекса с причиной «дубль», Вебмастер видит это с 3 августа. Показать список адресов?

21 инструмент, из них меняют что-либо только три (seo_add_keywords, seo_add_competitors, seo_request_recrawl) — остальные читают:

• Данные поиска — seo_overview (клики, показы, CTR, средняя позиция, топ-3/топ-10 и сравнение периодов), seo_search_queries (запросы и страницы Вебмастера и Search Console по устройствам и регионам), seo_positions (последняя проверка Topvisor), seo_indexation (сколько страниц в поиске Яндекса, что исключено и по какой причине), seo_metrika (поведение посетителей из поиска и достижения целей), seo_landing_pages (визиты и заявки в разрезе страницы входа).
• Работа с сайтом — seo_audit (разбор индексирования, техники, on-page и конкуренции страниц с источником у каждого вывода), seo_page_analysis (скорость, Core Web Vitals и on-page-сигналы страницы), seo_opportunities (запросы рядом с топом, страницы с низким CTR, показы без переходов, каннибализация), seo_sitemaps (видят ли Яндекс и Google карту сайта), seo_url_inspection (вердикт Google по конкретному адресу), seo_request_recrawl (отправить адрес на переобход в Яндексе), seo_text_check (ИИ-штампы, канцелярит и переспам в готовом русском тексте).
• Спрос — seo_keyword_demand: частотность, похожие фразы, разметка шума и сезонность из Wordstat.
• Ключи и проверки — seo_keywords (что стоит на проверке позиций), seo_add_keywords (поставить фразы на проверку), seo_positions_plan (расписание проверок, цена запуска и баланс Topvisor).
• Конкуренты — seo_competitors (наши позиции рядом с их позициями), seo_add_competitors (добавить сайты конкурентов в проект).
• Проект — seo_projects (сайты кабинета) и seo_sources (что подключено, что протухло и что именно перестаёт быть известно, пока источник не работает).

Что здесь сделано иначе, чем в обёртках над теми же API:

• Ответ несёт провенанс. У каждой цифры — источник и дата съёма. Отозванный доступ к Вебмастеру виден как отказ источника, а не как нулевой трафик: «данных нет» и «проблем нет» — разные ответы, и модель не должна их путать.
• Невыполненные проверки перечисляются. Аудит с молчащим источником или без подтверждённых прав на сайт возвращает список «что именно не проверялось и почему» и ограничивает оценку сверху, а не занижает её до «всё в порядке».
• Граница записи проведена по деньгам. Платный запуск проверки позиций, изменение расписания, удаление ключей и конкурентов в чат намеренно не вынесены — они списывают деньги с баланса Topvisor, и цена должна быть видна на экране до списания. Два пишущих инструмента удорожают следующую проверку позиций, и ассистент обязан назвать это последствие до вызова.
• Что не обещаем: обхода всего сайта нет — проверяется одна страница за вызов; уникальность текста не проверяется (источника у нас нет); позиции без подключённого Topvisor не выдумываются.

Тарифы SEO (отдельная подписка, 7 дней бесплатно): «Старт» — 590 ₽/мес (1 сайт, 2 аудита, 20 запросов Wordstat), «Профи» — 1 490 ₽/мес (5 сайтов, 10 аудитов, 200 Wordstat), «Агентство» — 9 900 ₽/мес (20 сайтов, 60 аудитов, 2 000 Wordstat). Все 21 инструмент доступны на любом действующем SEO-тарифе. Проверки позиций работают на балансе вашего аккаунта Topvisor — своей наценки на них нет.

Подробнее: https://app.marketscore.ru/seo

Установка

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

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

https://app.marketscore.ru/api/mcp        реклама: Яндекс Директ, VK, Авито, Wordstat

https://app.marketscore.ru/api/mcp/seo органика: Вебмастер, Search Console, Метрика, Topvisor

Ассистент откроет вход — авторизуйтесь по 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-набор (111 инструментов) для работы из чата ИИ, до 3 аккаунтов Директа. Без веб-дашборда — только ассистент.
• «Профи» — 1 990 ₽/мес: те же 111 инструментов плюс веб-дашборд с аналитикой и автопилотом, до 5 аккаунтов Директа.
• «Агентство» — 9 900 ₽/мес: 116 инструментов (плюс портфельный обзор accounts_overview), до 20 аккаунтов.
• SEO — отдельная ось тарифов (590 / 1 490 / 9 900 ₽/мес) и отдельный адрес коннектора. Тариф Директа доступа к SEO-инструментам не даёт, и наоборот.

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

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

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

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

• Авторизация — 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 инструментов.

А SEO вы умеете? Да, отдельным MCP-сервером: https://app.marketscore.ru/api/mcp/seo — 21 инструмент поверх Яндекс Вебмастера, Google Search Console, Метрики, Topvisor и Wordstat. Подписка на него отдельная от тарифов Директа, есть 7-дневный триал.

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
• MCP-серве