Yandex Wordstat MCP
Yandex Wordstat search-demand data: top queries, trends and regions for AI apps
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 2.4.4
- Listing updated
- today
Similar MCP servers
About Yandex Wordstat MCP
Yandex Wordstat MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.
The server reads Yandex's search-demand statistics through the Yandex Cloud Search API, so it works without access to a Yandex Direct advertising account or the old OAuth-based Wordstat API. You need a Yandex Cloud API key for the Search API (WORDSTAT_API_KEY) and a folder ID (WORDSTAT_FOLDER_ID), and Node.js 20 or newer.
There are five read-only tools. Top and related queries and regional breakdowns cover the last 30 days, while the dynamics report returns date, count and share series by day, week or month, and can be narrowed by region or by device (computer, phone, tablet). In the regions report an affinity index above 100% means interest above average. Each call handles a single phrase, and the Yandex Cloud quota is shared per key, so long keyword lists should be trimmed first.
Requests time out after 60 seconds and are retried up to three times on 429, 5xx or network errors. The README is written in Russian.
Install
Run in a terminal
claude mcp add mcp-yandex-wordstat --env WORDSTAT_API_KEY='<WORDSTAT_API_KEY>' --env WORDSTAT_FOLDER_ID='<WORDSTAT_FOLDER_ID>' -- npx -y mcp-yandex-wordstatAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-yandex-wordstat": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-wordstat"
],
"env": {
"WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-yandex-wordstat": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-wordstat"
],
"env": {
"WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-yandex-wordstat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-yandex-wordstat"
],
"env": {
"WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-yandex-wordstat": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-wordstat"
],
"env": {
"WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-yandex-wordstat": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-wordstat"
],
"env": {
"WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
WORDSTAT_API_KEYYandex Cloud API key for the Search API (sent as Api-Key). Treat it as a secret.RequiredWORDSTAT_FOLDER_IDYandex Cloud folder id, injected into every request body.RequiredWORDSTAT_LANGLanguage for API responses (ru, en, ...).WORDSTAT_API_BASEAPI root host override.WORDSTAT_TIMEOUT_MSPer-request timeout in milliseconds.WORDSTAT_MAX_RETRIESRetries on transient errors (429, 5xx, network).
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- top_requests
- Returns popular and related queries for a phrase.
- dynamics
- Returns demand over time by day, week or month.
- regions
- Returns demand distribution by region.
- raw_request
- Sends a technical request to the API.
What it does
- Top and related queries
- Shows popular queries containing a phrase plus semantically close ones.
- Demand dynamics
- Daily, weekly or monthly time series for seasonality.
- Regional breakdown
- Spreads demand across regions with an affinity index.
- Region and device filters
- Narrow reports to a region or compare computers, phones and tablets.
- Read-only access
- Nothing in Wordstat can be created or changed.
- Retry handling
- Retries transient errors and respects Retry-After.
Good for
- Estimate monthly search volume for a Russian-language phrase
- Spot seasonal peaks in demand for a product
- Compare interest in Moscow and Saint Petersburg
- Build a keyword list around a topic with frequencies
Pricing
Open source
Free server; uses your Yandex Cloud Search API quota
Yandex Wordstat MCP FAQ
What credentials does it need?
A Yandex Cloud API key for the Search API and a Yandex Cloud folder ID.
Does it need a Yandex Direct account?
No. It uses the Yandex Cloud Search API instead.
Can it change anything?
No. All five tools, including raw_request, are read-only.
What time period do top queries cover?
The last 30 days.
Is Yandex Wordstat MCP free?
Yes. Yandex Wordstat MCP is open source, so you can use and self-host it for free.
How do I add Yandex Wordstat MCP to Claude Code?
Run this command in your terminal: claude mcp add mcp-yandex-wordstat --env WORDSTAT_API_KEY='<WORDSTAT_API_KEY>' --env WORDSTAT_FOLDER_ID='<WORDSTAT_FOLDER_ID>' -- npx -y mcp-yandex-wordstat
What are the best alternatives to Yandex Wordstat MCP?
The closest alternatives to Yandex Wordstat MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Customer Io, Google_search_console and Ads AI Creator MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
