marketscore-seo-mcp
Connects AI assistants to SEO data from Yandex Webmaster, Google Search Console, Yandex Metrica, and Topvisor, enabling natural language analysis of search performance, indexation, positions, and audits.
README
MarketScore SEO — MCP для Вебмастера, Search Console, Метрики и Topvisor
Подключите Claude или ChatGPT к данным поиска и разбирайте SEO в диалоге: «Почему просел трафик за последние 28 дней?» → ассистент сверит Вебмастер, Search Console и Метрику, найдёт выпавшие из индекса страницы и назовёт причину, которую видит сам Яндекс.
Connect Claude or ChatGPT to Yandex Webmaster, Google Search Console, Yandex Metrica and Topvisor — search performance, indexation, positions, and a full SEO audit in chat.
Попробовать — 7 дней бесплатно →
Сайт / Website: https://app.marketscore.ru/seo
Что это
marketscore-seo-mcp — тонкий коннектор к хостовому SEO-MCP-серверу MarketScore. Сам сервер, доступ к API поисковых систем и вся логика работают на стороне сервиса — этот пакет лишь подключает к нему ваш ИИ-ассистент.
Как выглядит работа:
Вы: Почему просел трафик из поиска за последние 28 дней?
Claude: Клики упали с 940 до 610. Считаю только по источникам, измерившим оба периода: Search Console — да, Вебмастер — да, Topvisor не подключён, независимой проверки позиций не было. Основная просадка — раздел
/catalog: 18 страниц выпали из поиска Яндекса с причиной «дубль», Вебмастер видит это с 3 августа. Показать список адресов?
Обратите внимание на вторую фразу. Ассистент не сложил два источника в одно число: период, который один из источников не измерил, в сравнение не входит — иначе пробел в данных выглядел бы как падение трафика.
Что умеет
21 инструмент поверх Яндекс Вебмастера, Google Search Console, Яндекс Метрики, Topvisor, Wordstat, PageSpeed Insights и Chrome UX Report.
Данные поиска
| Инструмент | Что делает |
|---|---|
seo_overview |
Клики, показы, CTR, средняя позиция, запросы в топ-3 и топ-10. По запросу — сравнение с предыдущим равным периодом. |
seo_search_queries |
Запросы и страницы из Вебмастера и Search Console с разбивкой по устройствам и регионам. |
seo_indexation |
Сколько страниц в поиске Яндекса, сколько исключено и по какой причине, какие проблемы видит сама поисковая система. |
seo_positions |
Последняя проверка Topvisor: позиция, разрез «поисковик · регион · устройство», изменение с прошлого съёма. |
seo_metrika |
Поведение посетителей из поиска и достижения главных целей — только по домену проекта. |
seo_landing_pages |
Визиты и заявки в разрезе страницы входа — единственное место, где SEO-находка связывается с деньгами. |
Работа с сайтом
| Инструмент | Что делает |
|---|---|
seo_audit |
Индексирование, техника, on-page, потеря позиций и конкуренция страниц за один запрос — с источником и датой у каждого вывода. |
seo_page_analysis |
Скорость и Core Web Vitals по PageSpeed и Chrome UX Report плюс разбор HTML: код ответа, индексируемость, canonical, title, H1, объём текста. |
seo_opportunities |
Запросы рядом с топом, страницы с низким CTR, показы без единого перехода, каннибализация — отсортировано по ожидаемым дополнительным переходам. |
seo_sitemaps |
Видят ли Яндекс и Google карту сайта, когда обходили и сколько в ней адресов. |
seo_url_inspection |
Вердикт Google по конкретному адресу: в индексе ли, разрешён ли роботами, какой адрес он считает каноническим. |
seo_request_recrawl |
Отправить адрес на переобход в Яндексе. Пишет. |
seo_text_check |
ИИ-штампы, канцелярит, конструкция «это не X, а Y» и переспам в готовом русском тексте — с точной цитатой каждой находки. |
Спрос, ключи, конкуренты, проект
| Инструмент | Что делает |
|---|---|
seo_keyword_demand |
Частотность, похожие фразы, разметка шума и сезонность спроса из Wordstat. |
seo_keywords |
Какие фразы стоят на проверке позиций в проекте Topvisor. |
seo_add_keywords |
Поставить фразы на проверку. Пишет и удорожает следующую проверку позиций. |
seo_positions_plan |
Расписание проверок, цена запуска и остаток баланса Topvisor. |
seo_competitors |
Наши позиции рядом с позициями конкурентов по последней проверке. |
seo_add_competitors |
Добавить сайты конкурентов в проект. Пишет и удорожает следующую проверку. |
seo_projects |
Сайты кабинета и их идентификаторы. |
seo_sources |
Что подключено, в каком состоянии и что именно перестаёт быть известно, пока источник не работает. |
Чем это отличается от обёртки над теми же API
Все четыре источника имеют открытые API, и подключить их к модели можно самому. Разница — в том, что происходит, когда данные неполные.
У каждой цифры есть источник и дата. Ответ несёт состояние каждого источника: fresh, stale, missing, failed или not_connected. Отозванный доступ к Вебмастеру виден как отказ источника, а не как нулевой трафик. «Данных нет» и «проблем нет» — разные ответы, и модель не должна их путать.
Невыполненные проверки перечисляются. Аудит с молчащим источником, без подключённого Topvisor или на неподтверждённом сайте возвращает список «что именно не проверялось и почему» и ограничивает оценку сверху, а не занижает её до «всё в порядке». Пустой ответ здесь никогда не означает «всё хорошо».
Сравнение периодов честное. Источник, не измеривший оба периода, в итог не входит. Сравнивать нечем — null, а не нулевая динамика: процента от нуля не существует.
Неизмеренная позиция не подставляется нулём. Ноль лучше первого места и завышал бы видимость; такие строки идут прочерком и уходят вниз при сортировке в обе стороны.
Данные ограничены доменом проекта. Один счётчик Метрики и один ресурс sc-domain часто обслуживают несколько сайтов владельца. Фильтр строится по точному совпадению домена, а не по вхождению подстроки: example.ru содержится в shop.example.ru.
Клики источника ≠ сумма по запросам. Search Console скрывает строки с анонимизированными запросами, поэтому итог берётся отдельным запросом без разреза по запросу, а разрыв объясняется подписью. Синтетической строки «скрытые запросы» в данных нет — она попала бы в сортировки и выгрузку.
Граница записи проведена по деньгам
Из 21 инструмента пишут три: seo_add_keywords, seo_add_competitors и seo_request_recrawl. Первые два денег сами не тратят, но удорожают каждую следующую проверку позиций — бесплатно проверяются только первые пять конкурентов, а объём ключей умножает стоимость. Ассистент обязан назвать это последствие и дождаться согласия. Переобход тратит суточную квоту Вебмастера, вернуть её нельзя, поэтому остаток называется до отправки.
Намеренно не вынесены в чат: платный запуск проверки позиций, изменение расписания проверок, удаление ключей и конкурентов. Проверки позиций списываются с вашего баланса Topvisor, MarketScore вернуть их не может — цена должна быть видна на экране до списания, а список перед удалением человек должен видеть глазами.
Чего сервис не обещает
- Обхода всего сайта нет. За одну проверку читается одна страница — указанная или главная. Числа «страниц за аудит» в тарифах нет, потому что обхода нет.
- Уникальность текста не проверяется. Источника для этого у сервиса нет, и обещать её было бы неправдой.
- Позиции без Topvisor не выдумываются. Средняя позиция из Вебмастера и Search Console — это не проверка позиций по регионам и устройствам.
- Данных AI Overviews в API Search Console нет (проверено в августе 2026): отчёт живёт только в интерфейсе, выгрузки нет.
Установка
Claude (Desktop, веб, Code) и ChatGPT — по ссылке
Добавьте удалённый MCP-коннектор:
https://app.marketscore.ru/api/mcp/seo
Ассистент откроет вход — авторизуйтесь по OAuth. Токены Яндекса, Google и ключ Topvisor ассистенту не передаются.
Локальные MCP-клиенты (Cursor, VS Code, Cline, Zed) — через мост
npx -y marketscore-seo-mcp
Пример конфигурации MCP-клиента:
{
"mcpServers": {
"marketscore-seo": {
"command": "npx",
"args": ["-y", "marketscore-seo-mcp"]
}
}
}
Подключение источников
Источники подключаются один раз в кабинете https://app.marketscore.ru/seo, коннектор их только читает.
- Яндекс Вебмастер — OAuth. Нужны оба права:
webmaster:hostinfoоткрывает список сайтов, а аналитика и диагностика живут заwebmaster:verify. - Google Search Console — OAuth,
webmasters.readonly. Права на отправку карты сайта сознательно не запрашиваются: это потребовало бы переподключения у всех пользователей ради операции, которая делается раз в жизни проекта. - Яндекс Метрика — OAuth, выбирается счётчик и до трёх главных целей. Пока цели не выбраны, достижения не считаются, и инструмент говорит об этом прямо.
- Topvisor — API-ключ вида
userId:ключодним полем. Идентификатор проекта не спрашивается: он вычисляется по домену.
Любой источник можно отключить, а не только «подключить ещё раз». Рядом со статусом видно время последней проверки — «ошибка» без даты неотличима от застарелой.
Тарифы и доступ
Коннектору нужен аккаунт MarketScore с действующим SEO-тарифом. На старте — 7 дней бесплатно.
| Тариф | Цена | Сайты | Аудиты | Wordstat |
|---|---|---|---|---|
| SEO Старт | 590 ₽/мес | 1 | 2 / мес | 20 / мес |
| SEO Профи | 1 490 ₽/мес | 5 | 10 / мес | 200 / мес |
| SEO Агентство | 9 900 ₽/мес | 20 | 60 / мес | 2 000 / мес |
Все 21 инструмент доступны на любом действующем SEO-тарифе. Проверки позиций работают на балансе вашего аккаунта Topvisor по вашему ключу — своей наценки на них сервис не берёт. Без действующего тарифа сервер отдаёт 401 и ноль инструментов.
SEO-тариф и тариф рекламного продукта — разные подписки. Аккаунт MarketScore общий, второй логин не нужен, но подписка на Яндекс Директ доступа к SEO-инструментам не даёт, и наоборот.
Безопасность
- Авторизация — OAuth 2.1: токены поисковых систем и ключ Topvisor не передаются ассистенту и не лежат в конфиге MCP-клиента.
- Токены хранятся зашифрованными (AES-256-GCM); смена пароля аккаунта отзывает все выданные MCP-доступы.
- Инструменты на запись помечены аннотациями — MCP-клиент запрашивает подтверждение до вызова.
- Персональные данные хранятся на серверах в РФ (152-ФЗ).
FAQ
Это бесплатно? Первые 7 дней — да. Дальше — SEO-тариф от 590 ₽/мес.
Нужен ли аккаунт Яндекс Директа? Нет. SEO — самостоятельный продукт со своей подпиской.
Можно ли подключить оба сервера сразу? Да. Рекламный — https://app.marketscore.ru/api/mcp, SEO — https://app.marketscore.ru/api/mcp/seo. Это независимые коннекторы с независимыми подписками.
Может ли ассистент что-то сломать? Из 21 инструмента пишут три, каждый помечен аннотацией, и MCP-клиент спрашивает подтверждение. Платные операции в чат не вынесены вовсе.
Работает ли без Topvisor? Да — Вебмастер, Search Console и Метрика дают основную часть. Без Topvisor не будет независимой проверки позиций и сравнения с конкурентами, и инструменты скажут об этом прямо, а не покажут пустой результат.
Проверяет ли он весь сайт? Нет. За одну проверку читается одна страница. Обхода сайта в продукте сейчас нет, и в тарифах он не обещан.
Docker
docker build -t marketscore-seo-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-seo-mcp
OAuth-URL печатается в stdout — браузер из контейнера не откроется, перейдите по ссылке вручную. Токены mcp-remote живут в ~/.mcp-auth — смонтируйте volume, чтобы не переавторизовываться при каждом запуске.
Полезные ссылки
- MarketScore SEO: https://app.marketscore.ru/seo
- 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
- Технический SEO-аудит сайта: https://app.marketscore.ru/blog/tehnicheskij-seo-audit-sajta
- Рекламный MCP того же сервиса: https://github.com/marketscore/marketscore-direct-mcp
- Wordstat-MCP: https://github.com/marketscore/marketscore-wordstat-mcp
English
MarketScore SEO is a hosted MCP service for organic search on the Russian web. This package is a thin connector to the hosted server: it lets Claude, ChatGPT, or any MCP client read Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor, Wordstat, PageSpeed Insights and Chrome UX Report data from chat.
Install (remote, Claude/ChatGPT): add connector URL https://app.marketscore.ru/api/mcp/seo and sign in via OAuth.
Install (local MCP clients — Cursor, VS Code, Cline, Zed):
{
"mcpServers": {
"marketscore-seo": {
"command": "npx",
"args": ["-y", "marketscore-seo-mcp"]
}
}
}
Tools: 21 tools — search performance with period comparison, queries and pages by device and region, Yandex indexation state with exclusion reasons, Topvisor positions and competitor positions, Metrica behaviour and goal completions, landing-page conversions, growth opportunities (near-top queries, low-CTR pages, impressions without clicks, cannibalisation), a full SEO audit, single-page technical analysis (PageSpeed, Core Web Vitals, on-page signals), sitemap status in both engines, Google URL inspection, Yandex recrawl requests, Wordstat demand and seasonality, Topvisor keyword management, and a deterministic Russian-text check.
What makes it different from wrapping the same APIs yourself: every figure carries its source and observation date, and every source carries a state (fresh / stale / missing / failed / not_connected). A revoked Webmaster grant shows up as a source failure, never as zero traffic. Unperformed checks are listed explicitly and cap the audit score instead of silently lowering it. A source that did not measure both periods is excluded from period comparison rather than reported as a decline. An unmeasured position is never substituted with zero.
Writes: only three of the 21 tools write anything (add keywords, add competitors, request a Yandex recrawl); the first two make the next position check more expensive and the assistant must state that before calling. Paid position checks and schedule changes are deliberately kept out of chat — they spend the user's Topvisor balance, and the price must be visible on screen before it is spent.
Pricing: a MarketScore SEO plan is required; 7 days free. Start — 590 ₽/mo (1 site, 2 audits, 20 Wordstat); Pro — 1 490 ₽/mo (5 sites, 10 audits, 200 Wordstat); Agency — 9 900 ₽/mo (20 sites, 60 audits, 2 000 Wordstat). All 21 tools are available on every active SEO plan. Position checks run on your own Topvisor balance with no markup. Without an active plan the server returns 401 and exposes zero tools. The SEO plan is separate from the ads product plans.
FAQ:
Is it free? The first 7 days are; after that a SEO plan is required.
Do I need a Yandex Direct account? No — SEO is a standalone product with its own subscription.
Where do my credentials go? OAuth 2.1 — search-engine tokens and the Topvisor key stay on the service, encrypted, and never appear in the local MCP client config. Personal data is stored on servers in Russia (152-FZ).
Does it crawl my whole site? No — one page per check. Site-wide crawling is not part of the product and is not promised in any plan.
Keywords: SEO MCP, MCP server, Model Context Protocol, Yandex Webmaster, Яндекс Вебмастер, Google Search Console, Yandex Metrica, Яндекс Метрика, Topvisor, Топвизор, Wordstat, SEO audit, SEO-аудит, поисковая оптимизация, проверка позиций, индексация сайта, Core Web Vitals, PageSpeed, ИИ для SEO, нейросеть для SEO, Claude, ChatGPT, Cursor, AI SEO.
License
MIT — see LICENSE. Коннектор открыт; сервис MarketScore SEO — платный SaaS. / The connector is open; the MarketScore SEO service is a paid SaaS.
推荐服务器
Baidu Map
百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
Audiense Insights MCP Server
通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。
VeyraX
一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。
graphlit-mcp-server
模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。
Kagi MCP Server
一个 MCP 服务器,集成了 Kagi 搜索功能和 Claude AI,使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。
e2b-mcp-server
使用 MCP 通过 e2b 运行代码。
Neon MCP Server
用于与 Neon 管理 API 和数据库交互的 MCP 服务器
Exa MCP Server
模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。