SkillFoxx

Yandex Search.API MCP with Wordstat

Yandex Search.API MCP Server

An MCP server for Yandex's official Search.API: web, image, generative search and four Wordstat tools in one npm package

  • 1 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Runs an npm server that calls Search API and Wordstat as a Yandex Cloud service account
  • Only reads results and demand, and requests use the account quota
All reasons and checks
Russian stack

shufl9dka/yandex-searchapi-mcpAuthor:shufl9dka

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/yandex-search-api-mcp-server

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Runs an npm server that calls Search API and Wordstat as a Yandex Cloud service account
  • Only reads results and demand, and requests use the account quota

This is third-party code. Review the repository files before installing.

What it does

The server provides seven tools over Search.API's REST endpoints: web_search, image_search and generative_search hit /v2/web/search, /v2/image/search and /v2/gen/search, while wordstat_get_top, wordstat_get_dynamics, wordstat_get_regions_distribution and wordstat_get_regions_tree cover the Wordstat REST surface. Web and image search decode rawData from Base64 and parse the XML into structured document groups; web search always runs in XML format. Tool inputs default to minimal to keep the model's context compact, while searchType is available everywhere and defaults to SEARCH_TYPE_COM.

Who it is for. For developers and marketers who want both search and Wordstat keyword demand in one MCP server on the official API.

Good fit when

  • You need both search and Wordstat keyword demand in one server
  • Web and image search should return structured document groups, not raw XML
  • A one-command npm install from a registered package works for you

Not a fit when

  • You need Yandex Webmaster or Direct access: the server only covers Search.API and Wordstat
  • You are not ready to set up a Yandex Cloud service account with a key and Folder ID

Example request

Find the top related queries for winter tires and show demand dynamics over the last month

MCP

Transport
stdio
Authentication
API key

Environment variables

API_KEY required, secret
Yandex Cloud service-account key for Search.API
FOLDER_ID required
Yandex Cloud folder ID

Limitations

The FOLDER_ID and API_KEY variables of a Yandex Cloud service account are required. Web search is forced to XML format, with no other response format available. Wordstat access needs separate permission for that method in Yandex Cloud.

How to disable. Remove the yandex-searchapi entry from mcpServers in your client configuration.

FAQ

What format does web search return?

The server always requests XML (responseFormat FORMAT_XML) and parses it itself into structured document groups.

Does Wordstat need separate access?

Yes, Wordstat methods in Yandex Cloud usually require separate permission on the service account.

Discussion

No questions or reviews yet.

All Yandex Search tools
Russian stack

An MCP server for the Yandex Cloud Search API v2: Wordstat and web search with file caching, date normalization and 429-retry handling

MCP serverExtended access
Russian stack

An MCP server for Yandex Wordstat via the official Yandex Cloud Search API: frequency, related queries, dynamics and regions

MCP serverExtended access2

Yandex Wordstat MCP Server by khanton

Yandex Wordstat MCP Server

Russian stack

A compact TypeScript MCP server for Yandex Wordstat via the Yandex Search API: top queries, dynamics and regions

MCP serverExtended access1
Russian stack

A compact MCP server on the official SDK for five Yandex Wordstat operations: top requests, dynamics, regions, region tree, account info

MCP serverExtended access
Russian stack

An MCP server for Yandex Wordstat via the Yandex Cloud Search API: frequency, dynamics, regions and an operator-aware phrase builder

MCP serverExtended access3

README in short

The README lists all seven tools with their input and output fields, explains that the server only uses Search.API and Wordstat REST endpoints, shows npm install and an MCP client config example with FOLDER_ID and API_KEY variables.

README badge

Report a problem