Marketscore Direct Mcp

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

[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 и вся логика работают на стороне сервиса — этот пакет лишь подключает к нему ваш ИИ-ассистент.

У сервиса два независимых 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, Авито, Wordstathttps://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-сервер для Яндекс Вебмастера: https://app.marketscore.ru/blog/mcp-server-yandex-webmaster
• Нейросеть для SEO — что реально автоматизируется: https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya
• Почему клики в Search Console не сходятся: https://app.marketscore.ru/blog/search-console-kliki-ne-shodyatsya

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: up to 116 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.

SEO MCP (separate server): https://app.marketscore.ru/api/mcp/seo — 21 tools for organic search on top of Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor and Wordstat: search performance and period comparison, queries and pages, Yandex indexation state with exclusion reasons, growth opportunities (near-top queries, low-CTR pages, impressions without clicks, cannibalisation), a full SEO audit with a source and a date behind every finding, single-page technical analysis (PageSpeed, Core Web Vitals, on-page signals), sitemap status in both engines, Google URL inspection, Yandex recrawl requests, competitor positions, keyword management in Topvisor, landing-page conversions from Metrica, and a deterministic Russian-text check. Only three tools write anything; paid position checks are deliberately kept out of chat. Every answer carries provenance — a revoked source shows up as a source failure, never as zero traffic. Separate subscription (590 / 1 490 / 9 900 ₽/mo, 7-day trial): https://app.marketscore.ru/seo

Pricing: a Direct Manager account is required; sign-up includes a 7-day free Pro trial. Assistant — 990 ₽/mo (111 tools, chat-only, 3 Direct accounts); Pro — 1 990 ₽/mo (111 tools + web dashboard, 5 accounts); Agency — 9 900 ₽/mo (116 tools incl. portfolio overview, 20 accounts). SEO is a separate plan axis on a separate connector URL. 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, SEO MCP, Yandex Webmaster, Яндекс Вебмастер, Google Search Console, Yandex Metrica, Topvisor, SEO audit, ИИ-менеджер для Яндекс Директа, ИИ для рекламы.

License

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