Yandex Wordstat MCP
Яндекс Вордстат MCP
Wordstat MCP server via Yandex Cloud Search API: query volume and related queries, seasonality, demand by region and device
Install
claude mcp add \
--env WORDSTAT_API_KEY=ваш_ключ \
--env WORDSTAT_FOLDER_ID=ваш_folder_id \
--transport stdio \
--scope user \
yandex-wordstat \
-- npx -y mcp-yandex-wordstat@latestThis is third-party code. Review the repository files before installing.
What it does
The server gives the agent Yandex search demand statistics. Five tools return top queries containing a phrase and semantically related queries for 30 days, dynamics by day, week or month, regional demand with an affinity index and the region reference. Reports can be narrowed to a region and device type. All tools are read-only and no Direct ad account is needed.
Who it is for. Marketers, SEO specialists and content writers who research keywords and estimate demand.
Good fit when
- You need monthly volume for a phrase and related queries
- You need to understand seasonality for a product or service
- You need to compare interest in a topic across cities
Not a fit when
- You need to create Direct campaigns and keywords
- You need to check thousands of phrases in bulk: the key quota is shared
Example request
How often per month do people search for «купить велосипед», what related queries exist and which cities show above average demand?Limitations
Requires Node.js 20, a Yandex Cloud service account with the search-api.webSearch.user role, an API key and a folder ID. One call covers one phrase, and the Search API quota is shared per key. By default the server sends anonymous telemetry: install ID, tool name, versions and client, without the key or arguments. Disable it with ASKADS_TELEMETRY=0. The key sits in plain text in the client config.
How to disable. Run claude mcp remove yandex-wordstat or the Codex equivalent, or delete the yandex-wordstat block from the client config.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| WORDSTAT_API_KEY required, secret | Yandex Cloud service account API key for Search API |
| WORDSTAT_FOLDER_ID required | Yandex Cloud folder ID |
| ASKADS_TELEMETRY | Set to 0 to disable anonymous telemetry |
Security check
- Calls Yandex Cloud with your API key and consumes quota
- Sends anonymous telemetry by default
README in short
The Russian README opens with a demo and scenarios: keyword research, seasonality and regional comparison. It gives setup for Codex, Claude Code, Claude Desktop, Cursor and VS Code and a step-by-step Yandex Cloud key guide. It explains response fields, limits, retries and timeouts, and exactly what telemetry sends. MIT license.
FAQ
Do I need Direct access?
No. The server uses Yandex Cloud Search API v2, not the old OAuth Wordstat API.
Can the server change anything?
No, Wordstat has no write methods, and the raw request tool cannot reach another host.
Related
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents
A Claude Code skill set for auditing sites for AI search: citability, AI crawler access, llms.txt, schema and reports
The experimental official Google Analytics 4 MCP server: reports, funnels and realtime data on request
Google Search Console MCP
Google Search Console MCP Server for SEOs
An MCP server for Google Search Console: queries and pages with clicks and positions, URL indexing checks, sitemaps and ready SEO skills