Yandex Wordstat MCP Server by khanton

Yandex Wordstat MCP Server

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

  • 1 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • Runs a Node server built from source with four Wordstat API methods
  • Calls Yandex Cloud with an API key or IAM token, and calls are paid
All reasons and checks
Russian stack

khanton/yandex-search-mcp

Install

Manual install

git clone https://github.com/khanton/yandex-search-mcp.git && cd yandex-search-mcp && npm install && npm run build

The only install method in the README: build from source.

Access and checks

How we review

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

  • Runs a Node server built from source with four Wordstat API methods
  • Calls Yandex Cloud with an API key or IAM token, and calls are paid

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

What it does

A Node.js server wraps four Wordstat API v2 methods: wordstat_get_top returns the top queries for a phrase over 30 days, wordstat_get_dynamics builds a frequency timeline by month, wordstat_get_regions_distribution shows the regional breakdown, and wordstat_get_region_tree returns the region reference with IDs. Auth is via a Yandex Cloud API key or IAM token, and the build is a plain npm run build with no extra tooling.

Who it is for. For anyone who wants a minimal, no-frills Wordstat MCP server and is fine building it from source.

Good fit when

  • You want a simple server without extras like a phrase builder
  • You already have Yandex Cloud with the search-api.webSearch.user role and want a quick start

Not a fit when

  • You want a ready npx/uvx package with no cloning
  • You need a phrase builder, region caching or cost estimation

Example request

Show the top related queries for "chat bot" and the breakdown across major cities

MCP

Transport
stdio
Authentication
key is optional

Environment variables

YANDEX_FOLDER_ID required
Yandex Cloud folder ID.
YANDEX_API_TOKEN secret
API key; either this or an IAM token is required.
YANDEX_IAM_TOKEN secret
IAM token, takes priority over the API key.

Limitations

The package is not published to npm; you build from source with npm install && npm run build. There is no LICENSE file in the repository. You need YANDEX_FOLDER_ID and either YANDEX_IAM_TOKEN or YANDEX_API_TOKEN; Search API calls are billed. No tests or CI.

How to disable. Remove the yandex-wordstat entry from claude_desktop_config.json, or run claude mcp remove yandex-wordstat.

FAQ

What is used if both an IAM token and an API key are set?

The IAM token takes priority.

Where do I get YANDEX_FOLDER_ID?

From the Yandex Cloud console, in the folder's properties.

Discussion

No questions or reviews yet.

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 access3Repository stars
Russian stack

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

MCP serverExtended access2Repository stars

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 access9Repository stars
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

README in short

The Russian README gives a table of four tools, npm build instructions, an environment variable table, and two connection methods: editing claude_desktop_config.json or the claude mcp add command, with call examples for every tool.

README badge

Report a problem