Log inSubmit server
Yandex Wordstat logo

Yandex Wordstat

Query Yandex search demand, related phrases, trends, device data, and regional interest through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Yandex Wordstat

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat@latest"
      ],
      "env": {
        "WORDSTAT_API_KEY": "YOUR_VALUE_HERE",
        "WORDSTAT_FOLDER_ID": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Yandex Wordstat MCP server connects AI clients to Yandex search-demand statistics through Yandex Cloud Search API v2. It exposes tools for top and related queries, time-based demand, regional distribution, region lookup, and direct Wordstat requests. Use it for keyword research, seasonality analysis, or comparing demand across locations and devices without access to a Yandex Direct advertising account. The server is read-only and requires a Yandex Cloud API key and folder ID.

Use cases

  • Find related keyword phrases and their search demand
  • Measure seasonal trends for a query
  • Compare search interest across cities and regions
  • Filter demand reports by device type
  • Resolve Yandex region IDs before making regional queries

Key features

  • Top and semantically related search queries
  • Daily, weekly, and monthly demand dynamics
  • Regional demand and affinity analysis
  • Device and region filtering
  • Cached region reference hierarchy
  • Direct access to additional Wordstat POST endpoints

Tools5

What Yandex Wordstat lets your agent do. Expand a tool for its parameters.

Verified live~1.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

19/23 checks healthy over the last 90d

What it can do

From the 5 tools this server returned when we ran it; 5 declare their own safety hints.

Makes network requests · 5Read-only tools · 5
Network at startup4 connections
Files written at startup1
Install scriptsprepare
npm provenanceNot published
Package age119 days
Maintainers1

Observed 2026-10-26 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · mcp-yandex-wordstat@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars9Stargazers on the source repository.
npm downloads1.6kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Tools exposed5Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Yandex Wordstat works

What Yandex Wordstat does

Yandex Wordstat provides an MCP interface to aggregated Yandex search-demand data. Its main use is researching a phrase: identify popular queries that contain it, discover semantically related queries, measure demand over time, and compare interest between regions. Top-query and regional reports cover the most recent 30 days, while historical analysis is available through configurable time-series intervals.

The server does not manage advertising campaigns or create keywords, ads, or other account objects. Although requests use HTTP POST, the exposed Wordstat operations are read-only. It also avoids the legacy standalone Wordstat API with Direct OAuth and instead uses Yandex Cloud Search API v2.

How it works

An AI client starts the server over stdio and supplies a phrase or other tool parameters. The server sends requests to Yandex Cloud Search API, automatically adding the configured folder ID. top_requests returns matching and associated queries, their counts, and totalCount; dynamics returns {date, count, share} points; and regions reports counts, shares, and regional affinity. Counts may be returned as strings because large integers are represented that way in JSON.

Region filtering accepts region IDs and device selections can narrow reports to computers, phones, or tablets. The period parameter for dynamics supports daily, weekly, and monthly series. Date bounds use RFC3339 timestamps, with the end date aligned to the selected period. A single call analyzes one phrase.

list_regions supplies the region ID and name hierarchy used by other tools. The hierarchy is large and stable, so a long-running process can request it once and reuse the result. raw_request sends JSON to another Wordstat path when a dedicated tool is not available; it is restricted to the Yandex Cloud Search API host.

Setup and configuration

Use Node.js 20 or newer and run the package with npx -y mcp-yandex-wordstat@latest. Configure these environment variables in the MCP client:

  • WORDSTAT_API_KEY: an API key for Yandex Cloud Search API.
  • WORDSTAT_FOLDER_ID: the Yandex Cloud folder ID used for requests.

Access requires a Yandex Cloud service account with the search-api.webSearch.user role. The API key should have the yc.search-api.execute scope. Treat the key as a password because MCP client configuration may store it in plain text.

The documented stdio configuration works with Codex, Claude Code, Claude Desktop, Cursor, and VS Code. Each client passes the two environment variables to the npx command. The server retries temporary failures, including rate limits, server errors, network failures, and timeouts, up to three times while observing Retry-After where available.

Tools and capabilities

  • top_requests returns popular queries containing the phrase, semantically similar associations, and a total count. Optional region IDs, devices, and a phrase limit from 1 to 2,000 refine the result.
  • dynamics shows demand by day, week, or month, including each interval's count and share of all Yandex searches.
  • regions groups the last 30 days of demand across all regions, cities, or administrative regions. An affinity index above 100% indicates above-average interest.
  • list_regions resolves supported region IDs to names and provides the hierarchy for regional filters.
  • raw_request supports Wordstat POST endpoints without a dedicated wrapper.

Limitations and notes

Reports contain aggregated search statistics rather than data from a specific advertising account. The API quota is shared by requests made with the same key, so large keyword lists are better narrowed before querying. The server does not run background monitoring by itself; periodic reports depend on scheduling support in the connected AI application.

A request has a 60-second timeout. Regional reference data can be cached within a long-lived process. By default, the server sends anonymous installation, tool, runtime, operating-system, and client metadata for telemetry, along with limited tool-origin and error information.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Yandex Wordstat

Yandex Wordstat is an MCP server that connects AI clients to Yandex search-demand statistics through Yandex Cloud Search API v2. Its main tools return top and related queries, demand dynamics, regional distribution, region metadata, and direct Wordstat requests. It is read-only and uses an API key plus Yandex Cloud folder ID.

Install it by configuring an MCP client to run `npx -y mcp-yandex-wordstat@latest` with the required environment variables. The documented setup covers Codex, Claude Code, Claude Desktop, Cursor, and VS Code, and requires Node.js 20 or newer.

It requires a Yandex Cloud API key and folder ID in `WORDSTAT_API_KEY` and `WORDSTAT_FOLDER_ID`. The service account needs the `search-api.webSearch.user` role, and the key needs the `yc.search-api.execute` scope.

Yes, regional and device filters are supported. Use region IDs with the query tools, select cities or administrative regions for regional reports, and narrow supported reports to computers, phones, or tablets.

No, Yandex Wordstat is read-only. Its tools retrieve aggregated search-demand statistics and do not create campaigns, advertisements, keywords, or other advertising-account objects.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewYandex Wordstat AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/yandex-wordstat?style=directory)](https://allmcps.com/mcp/yandex-wordstat)
HTML Embed
<a href="https://allmcps.com/mcp/yandex-wordstat"><img src="https://allmcps.com/api/badge/yandex-wordstat?style=directory" alt="Yandex Wordstat on AllMCPs" /></a>