SkillFoxx

Yandex Wordstat MCP

An MCP server for Yandex Wordstat via the official Yandex Cloud Search API: frequency, related queries, dynamics and regions

  • 2 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Runs a local server that reads Wordstat statistics with a Yandex Cloud key
  • Search API calls are billed to your cloud account
All reasons and checks
Russian stack

n1arko/yandex-wordstat-mcpAuthor:N1arko

Install

Manual install

pipx install git+https://github.com/N1arko/yandex-wordstat-mcp.git

The main README method: install an isolated package via pipx.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Runs a local server that reads Wordstat statistics with a Yandex Cloud key
  • Search API calls are billed to your cloud account

This is third-party code. Review the repository files before installing.

What it does

The server gives an agent four tools over the Wordstat API: wordstat_top_requests returns popular and related queries for a phrase, wordstat_dynamics shows demand dynamics over a date range, wordstat_get_regions_tree returns Yandex's region tree, and wordstat_find_region looks up a region ID by name. Region 225 (all of Russia) is the default. The README shows how an agent chains the calls, find the region, check top queries, then dynamics, and turns the results into a marketer-facing read on commercial vs. informational intent.

Who it is for. For marketers who build keyword lists and check demand seasonality directly in a Codex or Claude Desktop conversation.

Good fit when

  • You need a quick demand check on a phrase and related wordings
  • You need a year of seasonality data to plan a campaign launch
  • You need a Yandex region ID by city name

Not a fit when

  • You have no Yandex Cloud account with Search API access
  • You need automatic clustering or negative-keyword collection: the server returns only raw data

Example request

Check the seasonality of "kids summer camp" over the last year across Russia and tell me when to launch the campaign

MCP

Transport
stdio
Authentication
API key

Environment variables

YC_SEARCH_API_KEY required, secret
Service account API key with the yc.search-api.execute scope.
YC_FOLDER_ID required
Yandex Cloud folder ID.
YC_IAM_TOKEN secret
An alternative to the API key.

Limitations

You need YC_SEARCH_API_KEY (or YC_IAM_TOKEN) and YC_FOLDER_ID from Yandex Cloud, and calls are billed. Stop words are not applied by default; ask the agent explicitly. The smoke test in scripts/ needs real credentials.

How to disable. Remove the yandex_wordstat entry from your MCP client config, and if installed via pipx, run pipx uninstall yandex-wordstat-mcp.

FAQ

What region is used if none is specified?

225, all of Russia. For Moscow specifically, pass region 213.

Do I need a Yandex Direct account?

No, access goes through the Yandex Cloud Search API via a service account with the search-api.webSearch.user role.

How is Yandex Wordstat MCP different from other Wordstat servers?

The server uses the official Yandex Cloud Search API and gives four tools: wordstat_top_requests returns popular and similar queries for a phrase, wordstat_dynamics shows demand dynamics by date, and there are regions and frequency.

Which region is used if none is given and do I need a Direct account?

The default region is described in the server README, to be safe set it in the request. A Yandex Direct account is not needed: access goes through a Yandex Cloud service account and a Search API key. Install with pipx install git+https://github.com/N1arko/yandex-wordstat-mcp.git.

Discussion

No questions or reviews yet.

All Yandex Wordstat tools
Russian stack

An MCP server for Yandex Wordstat via the Yandex Cloud Search API: frequency, dynamics, regions and an operator-aware phrase builder

MCP serverExtended access3

Yandex Wordstat MCP

Яндекс Вордстат MCP

Russian stack

Wordstat MCP server via Yandex Cloud Search API: query volume and related queries, seasonality, demand by region and device

MCP serverExtended access9

Yandex Wordstat MCP Server by khanton

Yandex Wordstat MCP Server

Russian stack

A compact TypeScript MCP server for Yandex Wordstat via the Yandex Search API: top queries, dynamics and regions

MCP serverExtended access1
Russian stack

A Wordstat MCP server via the Yandex Search API that estimates and tracks request cost before and after each call

MCP serverExtended access
Russian stack

An MCP server for the Yandex Cloud Search API v2: Wordstat and web search with file caching, date normalization and 429-retry handling

MCP serverExtended access

README in short

The Russian README explains why the server exists, gives a ready-made phrase for an agent to self-install it, a table of the required Yandex Cloud variables, example marketing tasks, a tool table, and a detailed troubleshooting section for common auth errors.

README badge

Report a problem