Wordstat MCP — keyword research from Yandex in Claude and ChatGPT

Connect Claude or ChatGPT to Yandex Wordstat and collect semantics right in the chat: "Get frequencies and seasonality for the query 'buy vacuum cleaner'" → the assistant returns related phrases with frequencies, filters out noise, and shows when the niche peaks seasonally.

Connect Claude or ChatGPT to Yandex Wordstat and do keyword research in chat — frequencies, related phrases, noise filtering, and 24-month seasonality.

Try it — 1 free request →

Website: https://app.marketscore.ru/mcp-wordstat

What it is

marketscore-wordstat-mcp is a lightweight connector to a hosted MCP server for keyword research. The server itself, access to the Yandex Wordstat API, and all the logic run on the service side — this package only connects your AI assistant to it.

How it works:

You: Collect semantics for "air humidifier", region Moscow.

Claude: Main query — 74,200 impressions/month. Related phrases: 40. Filtered out noise (informational queries "how to choose", "DIY", vacancies) — addressable demand 58,900. Seasonal peak — October–February, summer drop of ~2x. Top by frequency: "buy air humidifier" (12,100), "air humidifier for apartment" (8,300)…

Related MCP server: yandex-searchapi-mcp

What it can do

Four tools on top of the official Yandex Wordstat API:

• wordstat_suggest — frequencies and related phrases for a query, with noise markup (informational queries, "free/download", vacancies, geo-tails), addressable demand (sum without noise), a ready list of negative keywords, and intent breakdown (commercial/informational/navigational/brand). Region — by geobase ID (225 — Russia, 213 — Moscow, 2 — Saint Petersburg); device filter (desktop/smartphones/tablets).

• wordstat_dynamics — monthly demand dynamics for the last 24 months: seasonal peak and trough, year-over-year trend, verdict in words. Also with device filter.

• wordstat_cluster — related phrases laid out as ad group drafts: cluster by modifier word → group name, ad headline, and keywords. A ready semantic framework.

• wordstat_regions — demand distribution by region and city: affinityIndex (>100 — region is "hotter" than the national average) and impressions per month.

A repeat request for the same phrase is served from cache — free, no charge.

Installation

Claude (Desktop, Web, Code) and ChatGPT — by link

Add the remote MCP connector:

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

The assistant will open the login page — authorize via OAuth. Nothing else to enter.

Local MCP clients (Cursor, VS Code, Cline, Zed) — via bridge

npx -y marketscore-wordstat-mcp

Example MCP client configuration:

{
  "mcpServers": {
    "wordstat": {
      "command": "npx",
      "args": ["-y", "marketscore-wordstat-mcp"]
    }
  }
}

Pricing

No subscription — prepaid request packs. One call to wordstat_suggest or wordstat_dynamics = 1 request (repeat from cache does not consume). On sign-up — 1 free request to try it out.

Credits never expire. Without a balance the server exposes zero tools. Registration and packs: https://app.marketscore.ru/mcp-wordstat

How it differs from Wordstat parsers

Security and access

• Authorization — OAuth 2.1: keys and tokens are not stored in the MCP client config; they are on the service side.

• Changing your account password revokes all issued MCP accesses.

• Personal data is stored on servers in Russia (152-FZ).

• Without an active request balance, the server exposes 0 tools — the connector is useless without a top-up.

FAQ

Is it free? The first request is (demo on sign-up). After that, packs from 20 ₽.

Do I need a subscription? No. It's one-time prepaid packs, credits never expire.

Does it work with ChatGPT, Cursor, VS Code? Yes: Claude and ChatGPT connect via URL directly; Cursor/VS Code/Cline/Zed — via this package (npx -y marketscore-wordstat-mcp).

How is the data different from the free wordstat.yandex.ru? The source is the same (official Yandex API), but the response comes already annotated: noise separated, addressable demand calculated, seasonality over 2 years — all in one response inside the chat.

Do I need a Yandex Direct account? No. Wordstat MCP is a standalone product for keyword research; a Direct account is not required.

Docker

docker build -t marketscore-wordstat-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-wordstat-mcp

The OAuth URL is printed to stdout — the browser won't open from the container; follow the link manually. mcp-remote tokens live in ~/.mcp-auth — mount a volume to avoid reauthorizing on every run.

What else the service offers

Keyword research is the cheapest entry point. The same account also has two more MCP servers, each with its own address and subscription.

SEO — Webmaster, Search Console, Metrica, Topvisor

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

21 tools for organic search: clicks, impressions, and positions from Yandex Webmaster and Google Search Console; indexation state in Yandex with page exclusion reasons; visitor behavior from search and goal completions from Yandex Metrica; independent position check and competitor comparison via Topvisor; demand and seasonality from Wordstat (same source as here); SEO audit with source and date for every finding; page speed and Core Web Vitals check; growth opportunities (queries near the top, pages with low CTR, impressions without clicks, cannibalization); sitemap through the eyes of both search engines; Google verdict on a URL; submission of a URL for re-crawl in Yandex; deterministic check of Russian text for clichés and overspam.

Only three of the 21 tools change anything — paid launch of position check in chat is intentionally not included. Every number in the response has a source and date: a revoked access is visible as a source refusal, not as zero traffic.

SEO pricing is separate — 590 / 1,490 / 9,900 ₽/month, 7 days free: https://app.marketscore.ru/seo

Advertising — Yandex Direct, VK, Avito

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

Up to 116 tools: campaign analytics by slices, finding wasted spend, bids, budgets, strategies, negative keywords, campaign building from scratch, forecasts, and performance drop diagnostics. Wordstat packs are not part of these plans — this is a separate subscription: https://app.marketscore.ru/pricing

Useful links

• Wordstat in Claude and ChatGPT: https://app.marketscore.ru/blog/wordstat-v-claude-i-chatgpt

• How AI cleans semantics: https://app.marketscore.ru/blog/kak-ii-chistit-semantiku

• MCP server for Yandex Webmaster: https://app.marketscore.ru/blog/mcp-server-yandex-webmaster

• Neural network for SEO — what is really automated: https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya

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.

Also on the same account: a separate SEO MCP server at https://app.marketscore.ru/api/mcp/seo — 21 tools over Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor and Wordstat: search performance and period comparison, indexation state with exclusion reasons, growth opportunities, a full SEO audit with provenance behind every finding, page speed and Core Web Vitals, sitemap status, Google URL inspection, Yandex recrawl requests, competitor positions and landing-page conversions. Separate subscription (590 / 1,490 / 9,900 ₽/mo, 7-day trial): https://app.marketscore.ru/seo — and an ads MCP server (Yandex Direct, VK, Avito) at https://app.marketscore.ru/api/mcp.

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, SEO MCP, Yandex Webmaster, Яндекс Вебмастер, Google Search Console, Yandex Metrica, Topvisor, PPC, search demand, seasonality, Claude, ChatGPT, Cursor, AI marketing.

License

MIT — see LICENSE. The connector is open; the keyword-research service is paid. / The connector is open; the keyword-research service is paid.