home / mcp / yandex wordstat mcp server
Provides access to Yandex Wordstat data for keyword research, trends, and regional analysis through an MCP interface.
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.
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.
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.
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"
}
}
}
}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.
Request the Yandex Wordstat regions tree and identify the region ID for a specific city or area.
Retrieve all supported regions with their IDs so you can map regions for your analysis.
Fetch popular queries containing a keyword within the last 30 days, returning insights into demand and interest.
Get the evolution of search volume for a keyword over time to observe trends.
Analyze regional distribution of search volume to understand geographic interest.