Yandex Semantic Core MCP
Provides tools for collecting real Yandex Wordstat v2 data via Yandex Cloud Search API, including top queries, frequencies, dynamics, regional demand, and region tree, to support semantic core research.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Yandex Semantic Core MCP Collect semantic core for example.ru, Moscow region, exclude vacancies and free downloads."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Yandex Semantic Core MCP
MCP-сервер для сбора реальных данных Yandex Wordstat v2 и управляемого исследования семантического ядра. Работает локально через stdio, использует Yandex Cloud Search API и не требует внешних Python-пакетов.
Проект повторяет полезную архитектурную идею
ЯДрышко:
Wordstat остаётся источником частот, а подключённый AI-агент выполняет очистку,
разметку интентов, кластеризацию и подготовку отчёта. В отличие от референса,
здесь Wordstat MCP входит в сам проект, без промежуточного SaaS.
Что внутри
Возможность | MCP name | Что возвращает |
Проверка подключения |
| Готовность API и число доступных регионов |
Топ запросов |
| Реальные фразы, частоты и ассоциации за 30 дней |
Динамика |
| Дневной, недельный или месячный ряд |
Спрос по регионам |
| Частота, доля и affinity index |
Дерево регионов |
| ID и названия регионов Wordstat |
Workflow | MCP prompt | Последовательность полного исследования |
Методология | MCP resources | Правила качества, результат и настройка Yandex |
Сервер не вычисляет и не дополняет частоты. Значения в ответах инструментов приходят непосредственно из Wordstat v2.
Related MCP server: yandex-searchapi-mcp
Быстрый запуск
Требуется Python 3.10 или новее.
git clone https://github.com/zaborlux/yandex-semantic-core-mcp.git
cd yandex-semantic-core-mcp
export YANDEX_SEARCH_API_KEY='ваш API key'
export YANDEX_FOLDER_ID='ваш Folder ID'
python3 server.pyПри прямом запуске процесс ожидает MCP JSON-RPC в stdin. Обычно его запускает Cursor, Claude, Codex или другой MCP-клиент.
Полная настройка:
Вызвать
wordstat_get_user_info.Запустить prompt
semantic-coreили сформулировать задачу обычным текстом.
Пример запроса агенту
Собери семантическое ядро для https://example.ru.
Регион: Москва, Wordstat ID 213.
Цель: заявки на услугу.
Исключить: вакансии и бесплатные скачивания.
Используй prompt semantic-core и реальные данные Wordstat.Структура
yandex-semantic-core-mcp/
├── server.py
├── pyproject.toml
├── .env.example
├── docs/
│ ├── architecture.md
│ ├── mcp-client-setup.md
│ ├── semantic-core-workflow.md
│ ├── troubleshooting.md
│ └── yandex-cloud-setup.md
├── examples/
│ └── mcp-config.json
└── tests/
└── test_server.pyПроверка
python3 -m unittest discover -s tests -vПроверить только MCP handshake можно без ключа:
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05"}}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
| python3 server.pyДля обращения к Wordstat нужны Yandex Cloud API key и Folder ID.
Безопасность
Не коммитьте API key и не помещайте его в
.env.example.Создайте отдельный сервисный аккаунт с единственной ролью
search-api.webSearch.user.Ограничьте API key областью
yc.search-api.execute.Сервер не пишет ключ, Folder ID, запросы или ответы в stdout: stdout занят MCP-протоколом.
Сырые результаты Wordstat храните отдельно от выводов AI.
Ограничения
Транспорт — локальный stdio; публичного HTTP endpoint нет.
Обход сайта, live SERP, GSC и Яндекс Вебмастер не входят в сервер.
Кластеризацию делает подключённая модель по встроенной методологии; она должна явно отмечать отсутствие live SERP-проверки.
Использование Search API тарифицируется и ограничивается квотами Yandex Cloud.
Документы
Лицензия
MIT.
Available Tools
5 toolswordstat_get_dynamicsДинамика запросов WordstatB
Динамика частоты фразы по дням, неделям или месяцам.
Inputs: phrase (required), period, toDate, devices, +2 more.
wordstat_get_regionsРаспределение спроса по регионамC
Частота, доля и affinity index фразы по городам или регионам.
Inputs: phrase (required), region, devices.
wordstat_get_regions_treeДерево регионов WordstatB
Возвращает ID и названия регионов для фильтров остальных инструментов.
Inputs: depth.
wordstat_get_top_requestsТоп запросов WordstatB
Популярные и связанные запросы для фразы за последние 30 дней. Частоты возвращает Yandex Wordstat, сервер их не вычисляет.
Inputs: phrase (required), devices, regions, numPhrases.
wordstat_get_user_infoПроверить доступ к WordstatA
Проверяет API key, folder ID, роль и доступность Wordstat v2. Совместимое имя для workflow ЯДрышко.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct aspect of Yandex Wordstat: auth status, top requests, time dynamics, region breakdown, and region metadata. No two tools overlap in purpose, so an agent can reliably select the right one.
All tools follow the exact verb_noun pattern wordstat_get_*, making the naming highly predictable and consistent. The prefix also reinforces the domain, and the suffixes clearly indicate the resource or action.
Five tools is a well-scoped size for a Wordstat-focused server, covering the core read-only operations without redundancy. Each tool earns its place and the set feels neither sparse nor bloated.
The surface covers the essential Wordstat workflow: authentication verification, request discovery, time-series dynamics, region filtering, and region metadata. There are no obvious dead ends or missing core operations for this domain.
Related MCP Connectors
Yandex rank tracking and bulk SERP data, billed per result, hosted MCP.
Research Yandex search demand, trends and regions in ChatGPT. Yandex API charges apply.
Measured SEO and ads data for your site: semantic core, ad plan and launch results.
Projects, context, and reports. Paid research needs Agency or your own DataForSEO login.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables keyword research and search trend analysis for the Russian market through Yandex Wordstat API. Provides access to popular search queries, search volume dynamics over time, and regional distribution data.-
- AlicenseAqualityDmaintenanceProvides tools for web, image, generative search, and Wordstat keyword statistics via Yandex Search API.71MIT
- AlicenseAqualityBmaintenanceEnables querying Yandex Wordstat search statistics, including frequency, related queries, seasonality, and regional distribution, through natural language in AI clients.5178 npm9MIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude or ChatGPT to Yandex Wordstat for keyword research, enabling frequency lookups, related phrase suggestions with noise filtering, and 24-month seasonality analysis directly in chat.2MIT