Yandex Wordstat

Provides access to Yandex Wordstat data for keyword research, trends, and regional analysis through an MCP interface.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "altrnex-yandex-wordstat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_WORDSTAT_TOKEN": "your_token_here"
      }
    }
  }
}

You can run the Yandex Wordstat MCP server to perform keyword research and search trend analysis for the Russian market. It exposes endpoints like regional trees, top requests, dynamics, and regional distributions, and it authenticates with a Wordstat API token to fetch data on your behalf.

How to use

Once you have the MCP server set up, you interact with it through an MCP client. You can request the following tools: a regional tree to discover all supported regions with IDs, top requests containing a keyword from the last 30 days, search volume dynamics over time, and the regional distribution of search volume. Combine these capabilities to perform keyword research, monitor trends, and analyze geographic interest for your target market.

How to install

Prerequisites: you need Node.js compatible tooling. You will also run a small utility via npx to authenticate and start using the MCP server.

Step 1: Install the MCP and prepare authentication will be handled in a later step. You will obtain a token from Yandex Wordstat and then configure your client to pass that token to the MCP.

Configuration and usage notes

Configure your MCP client to pass the access token you obtain from Yandex Wordstat. This token authorizes requests to the Wordstat API through the MCP server.

In your client configuration, set the environment variable YANDEX_WORDSTAT_TOKEN to your token value. Then run the MCP using the following runtime command.

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_WORDSTAT_TOKEN": "your_token_here"
      }
    }
  }
}

Usage examples

Keyword Research: ask for the most popular queries for a term in Russia, or for top searches containing a phrase.

Search Trends: request the trend for a keyword over the past year or inspect weekly dynamics.

Regional Analysis: query which regions search a term the most and view regional distribution.

Get region IDs

Request the Yandex Wordstat regions tree and identify the region ID for a specific city or area.

Available tools

get-regions-tree

Retrieve all supported regions with their IDs so you can map regions for your analysis.

top-requests

Fetch popular queries containing a keyword within the last 30 days, returning insights into demand and interest.

dynamics

Get the evolution of search volume for a keyword over time to observe trends.

regions

Analyze regional distribution of search volume to understand geographic interest.