Yandex Searchapi MCP Server

MCP server for Yandex Search API (web, image, generative, wordstat).

Local serverstdio

What is the Yandex Searchapi MCP MCP server?

Most search and retrieval work still happens through a UI a human drives. Yandex Searchapi MCP MCP server moves it into the conversation instead. MCP server for Yandex Search API (web, image, generative, wordstat).

The short version

MCP server for Yandex Search API over REST with 7 tools: - web_search - image_search - generative_search - wordstat_get_top - wordstat_get_dynamics - wordstat_get_regions_distribution - wordstat_get_regions_tree

  • Uses only REST endpoints (/v2/web/search, /v2/image/search, /v2/gen/search, Wordstat REST paths)
  • Minimal tool inputs by default to keep model context compact
  • searchType is available for all relevant tools and defaults to SEARCH_TYPE_COM
  • Web search always forces responseFormat: FORMAT_XML
  • Web/image tools decode rawData from Base64 and parse XML into structured groups
  • Error handling with clear API status and details

The tools it exposes

The server publishes 8 tools. What each one is for:

  • web_search — image_search
  • generative_search — wordstat_get_top
  • wordstat_get_dynamics — wordstat_get_regions_distribution
  • FOLDER_ID — API_KEY
  • image_search — Use this tool when you need image search results and image metadata (thumbnail/original links and dimensions)
  • wordstat_get_top — Use this tool to understand what related queries users search for around a keyword
  • wordstat_get_regions_distribution — Use this tool to see in which regions/cities a keyword is relatively more popular
  • wordstat_get_regions_tree — Use this tool to get valid region IDs and names for regional Wordstat filters

What it needs from you

Configuration is passed through the environment: FOLDER_ID, API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

yandex-searchapi-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

How it compares

Plenty of search and retrieval servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Yandex Searchapi MCP's toolset — web_search, generative_search, wordstat_get_dynamics and 5 more — is a fair guide to whether it matches your workflow. It is maintained by shufl9dka; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
web_searchimage_search
generative_searchwordstat_get_top
wordstat_get_dynamicswordstat_get_regions_distribution
FOLDER_IDAPI_KEY
image_searchUse this tool when you need image search results and image metadata (thumbnail/original links and dimensions).
wordstat_get_topUse this tool to understand what related queries users search for around a keyword.
wordstat_get_regions_distributionUse this tool to see in which regions/cities a keyword is relatively more popular.
wordstat_get_regions_treeUse this tool to get valid region IDs and names for regional Wordstat filters.

How to install the Yandex Searchapi MCP MCP server

## MCP client config example

```json
{
  "mcpServers": {
    "yandex-searchapi": {
      "command": "npx",
      "args": ["-y", "yandex-searchapi-mcp"],
      "env": {
        "FOLDER_ID": "your-folder-id",
        "API_KEY": "your-api-key"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
FOLDER_IDConfiguration value read at startup.Optional
API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Yandex Searchapi MCP to web search.
  • Use Yandex Searchapi MCP to generative search.
  • Use Yandex Searchapi MCP to wordstat get dynamics.

Frequently asked questions

It connects Yandex Searchapi MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (web_search, generative_search, wordstat_get_dynamics, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Yandex Searchapi MCP directly.