# Yandex Wordstat MCP

Brings Yandex search demand metrics into AI coding assistants. Helps analyze query volume, seasonal trends, and regional popularity.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: askads
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/askads/mcp-yandex-wordstat
- Updated: 2026-10-04
- HTML: https://affpapa.org/en/nevibecode/mcp/askads-yandex-wordstat-mcp

## What it does

The server links AI clients to Yandex search demand metrics via the Yandex Cloud Search API. It provides five tools that fetch related queries, track demand curves, inspect regional popularity indexes, and navigate location identifiers. All endpoints operate strictly in read-only mode, meaning the integration cannot edit advertising campaigns or keyword lists.

Query and territory reports cover the preceding 30 days. You can narrow data down by device type to compare phone, tablet, and desktop traffic. Each call handles only one search phrase. Without an active Yandex Cloud API key and folder ID, the server will not answer queries.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `WORDSTAT_API_KEY`, `WORDSTAT_FOLDER_ID`, `WORDSTAT_LANG`, `WORDSTAT_API_BASE`, `WORDSTAT_TIMEOUT_MS`, `WORDSTAT_MAX_RETRIES` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env WORDSTAT_API_KEY=<WORDSTAT_API_KEY> --env WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> --env WORDSTAT_LANG=<WORDSTAT_LANG> --env WORDSTAT_API_BASE=<WORDSTAT_API_BASE> --env WORDSTAT_TIMEOUT_MS=<WORDSTAT_TIMEOUT_MS> --transport stdio askads-yandex-wordstat-mcp -- npx -y mcp-yandex-wordstat
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add askads-yandex-wordstat-mcp --env WORDSTAT_API_KEY=<WORDSTAT_API_KEY> --env WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> --env WORDSTAT_LANG=<WORDSTAT_LANG> --env WORDSTAT_API_BASE=<WORDSTAT_API_BASE> --env WORDSTAT_TIMEOUT_MS=<WORDSTAT_TIMEOUT_MS> -- npx -y mcp-yandex-wordstat
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "askads-yandex-wordstat-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-yandex-wordstat"
            ],
            "env": {
                "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
                "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>",
                "WORDSTAT_LANG": "<WORDSTAT_LANG>",
                "WORDSTAT_API_BASE": "<WORDSTAT_API_BASE>",
                "WORDSTAT_TIMEOUT_MS": "<WORDSTAT_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "askads-yandex-wordstat-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-yandex-wordstat"
            ],
            "env": {
                "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
                "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>",
                "WORDSTAT_LANG": "<WORDSTAT_LANG>",
                "WORDSTAT_API_BASE": "<WORDSTAT_API_BASE>",
                "WORDSTAT_TIMEOUT_MS": "<WORDSTAT_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e WORDSTAT_API_KEY=<WORDSTAT_API_KEY> -e WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> -e WORDSTAT_LANG=<WORDSTAT_LANG> -e WORDSTAT_API_BASE=<WORDSTAT_API_BASE> -e WORDSTAT_TIMEOUT_MS=<WORDSTAT_TIMEOUT_MS> askads-yandex-wordstat-mcp npx -y mcp-yandex-wordstat
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- check monthly search volumes and related phrases on Yandex
- track search interest shifts across days, weeks, or months
- compare keyword popularity across different regional markets
- inspect query distribution between mobile devices and desktop computers

## Example prompts
- Check monthly search volume and related queries for 'bike rental'
- Show monthly search dynamics for 'winter boots' over the past year
- Which cities show above-average interest in home renovation services?

## Similar
- [New-Term Radar](https://affpapa.org/en/nevibecode/mcp/new-term-radar.md) — MCP server · ★ 1823
- [NotFair](https://affpapa.org/en/nevibecode/mcp/notfair.md) — MCP server · ★ 4064
- [seo-monster](https://affpapa.org/en/nevibecode/mcp/seo-monster.md) — MCP server · ★ 555
- [Google Maps MCP Server](https://affpapa.org/en/nevibecode/mcp/google-maps-mcp-server.md) — MCP server · ★ 484
- [Search Console MCP](https://affpapa.org/en/nevibecode/mcp/search-console-mcp.md) — MCP server · ★ 310
- [squirrelscan](https://affpapa.org/en/nevibecode/mcp/squirrelscan.md) — MCP server · ★ 298

## Other versions with the same name
- [Yandex Wordstat MCP · stufently](https://affpapa.org/en/nevibecode/mcp/yandex-wordstat-mcp.md) — ★ 19

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md