SkillFoxx

Yandex Search and Wordstat MCP: web_search and phrase stats

mcp-yandex-search

An MCP server on a single AI Studio key: four Wordstat methods, search over the Yandex index and a raw request to the Wordstat API

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

Minimal access

Why this level

  • The server only reads stats and results, but every call is billed by Yandex and uses the shared quota of the key
All reasons and checks
Russian stack

kvdecvlt/mcp-yandex-searchAuthor:kvdecvlt

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/mcp-yandex-search

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The server only reads stats and results, but every call is billed by Yandex and uses the shared quota of the key

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

What it does

A Node.js MCP server calls the Yandex Search API with one AI Studio key (`YANDEX_API_KEY`) and gives six tools: `wordstat_get_top` (top and related queries over 30 days), `wordstat_get_dynamics`, `wordstat_get_regions`, `wordstat_get_regions_tree`, `web_search` (search over the Yandex index, `async`, `sync` and `auto` modes) and `raw_request` for any Wordstat API path. The default transport is stdio, and `MCP_TRANSPORT=http` enables HTTP on port 3100 with a `/health` check. Retries on 429, 5xx and timeouts respect `Retry-After`, the region tree is cached and there is no telemetry. Launch: `npx -y mcp-yandex-search`.

Who it is for. SEO specialists, content marketers and editors who want both phrase frequencies and Yandex results in one connection.

Good fit when

  • You first check demand for a phrase and then see what Yandex shows for it in results
  • You need a Wordstat API method that is not among the ready tools, and `raw_request` helps
  • The server should serve several users over HTTP rather than locally
  • You do not want one key for Wordstat and another for search

Not a fit when

  • You need Metrika, Webmaster or Direct: the server covers only Wordstat and search
  • You need to process thousands of phrases: the Search API quota is shared per key and each phrase costs one call
  • You need parallel calls with no queue: deferred search waits for an operation up to ten minutes

Example request

Compare the frequency of "new-build mortgage" and "secondary market mortgage" by month and show what Yandex returns for the first

MCP

Transport
stdio, http
Authentication
API key

Environment variables

YANDEX_API_KEY required, secret
Yandex Search API key from AI Studio
YANDEX_FOLDER_ID
Yandex Cloud folder id, not needed for AI Studio keys
MCP_TRANSPORT
Transport: stdio or http

Limitations

A Yandex Search API key with the `search-api.webSearch.user` role is required, and for keys not from AI Studio also `YANDEX_FOLDER_ID`. The quota is shared per key and one call equals one phrase. Wordstat frequencies cover the last 30 days, and only `wordstat_get_dynamics` takes dates. Deferred `web_search` waits for the operation up to 600 seconds by default. On 401 and 403 errors check access to the Search API and the folder. The project is small: zero stars, last commit in October 2026, MIT license, tests run without a network.

How to disable. Remove the server from the client settings and revoke the `YANDEX_API_KEY` key in the Yandex Cloud console.

FAQ

Which tools are there?

Six: four Wordstat methods, `web_search` for search over the Yandex index and `raw_request` for an arbitrary Wordstat API path.

Where do I get the key?

In AI Studio: a service account with the `search-api.webSearch.user` role is created along with the key.

How do I enable HTTP instead of stdio?

Set `MCP_TRANSPORT=http`; the default port is 3100 and the liveness check is at `/health`.

What does `raw_request` do?

It sends a POST to any relative Wordstat API path with your request body when the needed method is not among the ready tools.

Does the server send usage statistics?

No, it has no telemetry.

Discussion

No questions or reviews yet.

All Yandex Wordstat tools
Russian stack

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

MCP serverExtended access2
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

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

Yandex Search.API MCP with Wordstat

Yandex Search.API MCP Server

Russian stack

An MCP server for Yandex's official Search.API: web, image, generative search and four Wordstat tools in one npm package

MCP serverExtended access1
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

README in short

The README briefly covers the quick start with an AI Studio key, config examples for Claude Desktop, Cursor and opencode, a table of six tools with parameters, environment variables and server behavior on errors and retries.

README badge

Report a problem