Wordstat MCP
Connects 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.
README
Wordstat MCP — подбор слов Яндекса в Claude и ChatGPT
Подключите Claude или ChatGPT к Яндекс Вордстату и собирайте семантику прямо в диалоге: «Собери частотности и сезонность по запросу “купить пылесос”» → ассистент вернёт похожие фразы с частотностями, отсеет мусор и покажет, когда у ниши сезонный пик.
Connect Claude or ChatGPT to Yandex Wordstat and do keyword research in chat — frequencies, related phrases, noise filtering, and 24-month seasonality.
Попробовать — 1 запрос бесплатно →
Сайт / Website: https://app.marketscore.ru/mcp-wordstat
<!-- TODO(владелец): скриншот/GIF диалога с Claude сюда — главный ага-момент -->
Что это
marketscore-wordstat-mcp — тонкий коннектор к хостовому MCP-серверу подбора слов. Сам сервер, доступ к API Яндекс Вордстата и вся логика работают на стороне сервиса — этот пакет лишь подключает к нему ваш ИИ-ассистент.
Как выглядит работа:
Вы: Собери семантику по «увлажнитель воздуха», регион Москва.
Claude: Основной запрос — 74 200 показов/мес. Похожих фраз: 40. Отсеял мусор (инфо-запросы «как выбрать», «своими руками», вакансии) — адресуемый спрос 58 900. Сезонный пик — октябрь–февраль, летом спад в ~2 раза. Топ по частотности: «увлажнитель воздуха купить» (12 100), «увлажнитель воздуха для квартиры» (8 300)…
Что умеет
Четыре инструмента поверх официального API Яндекс Вордстата:
wordstat_suggest— частотности и похожие фразы по запросу, с разметкой шума (инфо-запросы, «бесплатно/скачать», вакансии, гео-хвосты), адресуемым спросом (сумма без мусора), готовым списком минус-слов и разбивкой по интенту (коммерч./инфо/навиг./бренд). Регион — по id геобазы (225 — Россия, 213 — Москва, 2 — Санкт-Петербург); фильтр по устройствам (десктоп/смартфоны/планшеты).wordstat_dynamics— помесячная динамика спроса за последние 24 месяца: сезонный пик и спад, тренд год-к-году, вердикт словами. Тоже с фильтром по устройствам.wordstat_cluster— похожие фразы, разложенные в черновик групп объявлений: кластер по слову-модификатору → имя группы, заголовок объявления и ключи. Готовый каркас семантики.wordstat_regions— распределение спроса по регионам и городам: affinityIndex (>100 — регион «горячее» среднего по стране) и показы в месяц.
Повторный запрос той же фразы отдаётся из кэша — бесплатно, без списания.
Установка
Claude (Desktop, веб, Code) и ChatGPT — по ссылке
Добавьте удалённый MCP-коннектор:
https://app.marketscore.ru/api/mcp
Ассистент откроет вход — авторизуйтесь по OAuth. Больше ничего вводить не нужно.
Локальные MCP-клиенты (Cursor, VS Code, Cline, Zed) — через мост
npx -y marketscore-wordstat-mcp
Пример конфигурации MCP-клиента:
{
"mcpServers": {
"wordstat": {
"command": "npx",
"args": ["-y", "marketscore-wordstat-mcp"]
}
}
}
Сколько стоит
Никакой подписки — предоплата пакетами запросов. Один вызов wordstat_suggest или wordstat_dynamics = 1 запрос (повтор из кэша не тратит). На регистрации — 1 запрос бесплатно, чтобы попробовать.
| Пакет | Цена | Цена за запрос |
|---|---|---|
| 100 запросов | 20 ₽ | 0.20 ₽ |
| 500 запросов | 90 ₽ | 0.18 ₽ |
| 1 000 запросов | 150 ₽ | 0.15 ₽ |
| 2 000 запросов | 250 ₽ | 0.125 ₽ |
Кредиты не сгорают. Без баланса сервер отдаёт 0 инструментов. Регистрация и пакеты: https://app.marketscore.ru/mcp-wordstat
Чем отличается от парсеров Вордстата
| Wordstat MCP (этот коннектор) | Парсеры / расширения | |
|---|---|---|
| Где работает | прямо в Claude/ChatGPT, в диалоге | отдельная программа/сайт |
| Разметка шума и адресуемый спрос | есть (инфо-запросы, вакансии, гео) | обычно нет — сырая выдача |
| Сезонность | 24 месяца, пик/спад, тренд | не всегда |
| Установка | OAuth-вход по ссылке | ключ/логин, настройка |
| Оплата | предоплата, от 20 ₽, кредиты не сгорают | подписка/лимиты |
Безопасность и доступ
- Авторизация — OAuth 2.1: ключи и токены не лежат в конфиге MCP-клиента, они на стороне сервиса.
- Смена пароля аккаунта отзывает все выданные MCP-доступы.
- Персональные данные хранятся на серверах в РФ (152-ФЗ).
- Без действующего баланса запросов сервер отдаёт 0 инструментов — коннектор бесполезен без пополнения.
FAQ
Это бесплатно? Первый запрос — да (демо на регистрации). Дальше — пакеты от 20 ₽.
Нужна ли подписка? Нет. Это разовая предоплата пакетами, кредиты не сгорают.
Работает ли с ChatGPT, Cursor, VS Code? Да: Claude и ChatGPT подключаются по URL напрямую, Cursor/VS Code/Cline/Zed — через этот пакет (npx -y marketscore-wordstat-mcp).
Чем данные отличаются от бесплатного wordstat.yandex.ru? Источник тот же (официальный API Яндекса), но ответ приходит уже размеченным: мусор отделён, посчитан адресуемый спрос, сезонность за 2 года — всё в одном ответе внутри чата.
Нужен ли аккаунт Яндекс Директа? Нет. Wordstat MCP — самостоятельный продукт для подбора слов, кабинет Директа не требуется.
Docker
docker build -t marketscore-wordstat-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-wordstat-mcp
OAuth-URL печатается в stdout — браузер из контейнера не откроется, перейдите по ссылке вручную. Токены mcp-remote живут в ~/.mcp-auth — смонтируйте volume, чтобы не переавторизовываться при каждом запуске.
Полезные ссылки
- Wordstat в Claude и ChatGPT: https://app.marketscore.ru/blog/wordstat-v-claude-i-chatgpt
- Как ИИ чистит семантику: https://app.marketscore.ru/blog/kak-ii-chistit-semantiku
English
Wordstat MCP is a hosted MCP service for Yandex Wordstat (Russian keyword research). This package is a thin connector to the hosted server: it lets Claude, ChatGPT, or any MCP client pull keyword frequencies, related phrases (with noise filtering and addressable-demand totals), and 24-month seasonality straight 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": {
"wordstat": {
"command": "npx",
"args": ["-y", "marketscore-wordstat-mcp"]
}
}
}
Tools: four tools over the official Yandex Wordstat API — wordstat_suggest (frequencies + related phrases with noise annotation, addressable demand, ready negative keywords, intent breakdown, device filter), wordstat_dynamics (24-month seasonality: peak/trough, YoY trend, verdict), wordstat_cluster (phrases grouped into ad-group drafts with names and headlines), and wordstat_regions (demand by region/city with affinityIndex). Repeat lookups are served from cache for free.
Pricing: no subscription — prepaid request packs. Sign-up includes 1 free request. 100 req — 20 ₽; 500 — 90 ₽; 1 000 — 150 ₽; 2 000 — 250 ₽. Credits never expire. Without a balance the server exposes zero tools. No Yandex Direct account required.
FAQ:
Is it free? The first request is (a demo on sign-up); after that, packs from 20 ₽.
Where do my credentials go? OAuth 2.1 — nothing is stored in the local MCP client config; auth lives on the service. Personal data is stored on servers in Russia (152-FZ).
Works with ChatGPT, Cursor, VS Code? Yes — Claude and ChatGPT connect by URL directly; Cursor/VS Code/Cline/Zed via npx -y marketscore-wordstat-mcp.
Keywords: Yandex Wordstat, Яндекс Вордстат, keyword research, семантика, подбор слов, MCP, Model Context Protocol, MCP server, SEO, PPC, search demand, seasonality, Claude, ChatGPT, Cursor, AI marketing.
License
MIT — see LICENSE. Коннектор открыт; сервис подбора слов — платный. / The connector is open; the keyword-research service is paid.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.