SkillFoxx

Yandex Search API v2 MCP server

yandex-search-mcp

A self-hosted MCP for Yandex Search API v2: web, image and generative search across all six Yandex indexes

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

Extended access

Why this level

  • Runs a Python server that searches the web and images via Yandex Search API
  • Needs a Yandex Cloud service account key, and requests use its quota
All reasons and checks
Russian stack

oleg-cat/yandex-search-mcpAuthor:oleg-cat

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/oleg-cat-yandex-search-mcp

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 a Python server that searches the web and images via Yandex Search API
  • Needs a Yandex Cloud service account key, and requests use its quota

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

What it does

A Python server provides three typed tools: yandex_web_search for classic web search with site, host, date operators and minus words, yandex_image_search with format, size, orientation and color filters, and yandex_gen_search for one AI-synthesized answer with cited sources. All six Yandex indexes are supported: ru, com, tr, kk, be, uz. The author wrote the server from scratch to replace the official yandex/yandex-search-mcp-server, calling it a Turkish-market demo with fragile XML parsing and a json.loads hack on generative search. Here XML is parsed with defusedxml against live API fixtures, there are retries with exponential backoff on 429 and 5xx, a unified error contract, and tests confirm the API key never leaks into logs.

Who it is for. For developers who want reliable, typed access to Yandex search, including an AI answer with sources, from Claude Code, Codex or opencode.

Good fit when

  • You need the official Yandex Search API v2, not SERP scraping
  • You need generative search with explicit source citations, not just a document list
  • You work with Russian-language search and need all six Yandex indexes

Not a fit when

  • You lack a Yandex Cloud service account: without the API key and Folder ID the server will not start
  • You need instant generative search answers: the quota is 1 request per second, and responses take tens of seconds

Example request

Find recent news about the taxi law over the last two weeks and give a short answer with source citations

MCP

Transport
stdio
Authentication
API key

Environment variables

YANDEX_SEARCH_API_KEY required, secret
Yandex Cloud service-account Api-Key with yc.search-api.execute scope
YANDEX_FOLDER_ID required
Yandex Cloud folder ID with the search-api.webSearch.user role
YANDEX_MCP_ENABLED_TOOLS
Space-separated allowlist of enabled tools, defaults to all

Limitations

The package is not published to PyPI; install by cloning and pip install -e. Default quotas are 10 RPS and 10,000 per hour for web and image search, 1 RPS and 1,000 per hour for generative search; the server does not work around them, it only retries on 429 and 5xx. A Yandex Cloud service-account key with yc.search-api.execute scope and the search-api.webSearch.user role is required.

How to disable. Remove the server with claude mcp remove yandex-search or codex mcp remove yandex-search, or delete the entry from your config.

FAQ

How is this better than the official Yandex server?

The author points to the official server's tr/en-only regions, fragile regex-based XML parsing, and a nonexistent dependency pin; this one is tested against live fixtures and supports all 6 indexes.

Why is generative search so slow?

The quota is 1 request per second, and the answer itself takes tens of seconds to generate; the default timeout is 120 seconds.

Discussion

No questions or reviews yet.

All Yandex Search tools

Yandex Search API v2 MCP server over HTTP

Yandex Search API MCP server, StreamableHTTP build

Russian stack

A fork of Yandex's official server adding HTTP transport and the full range of search types: web, generative, image

MCP serverExtended access1

Yandex image search MCP

mcp-yandex-search-api

Russian stack

A Python MCP server for searching Yandex Images through the Yandex Search API

MCP serverExtended access

Yandex Search API MCP with deferred search

Yandex Search MCP Server (Async Mode)

Russian stack

A fork of Yandex's official server defaulting to deferred async search, cutting Search API cost by up to 94%

MCP serverExtended access
Russian stack

An MCP web-search and content-extraction server via Yandex and Google on top of SerpAPI, geared toward RU/CIS results

MCP serverExtended access1

README in short

The README explains in detail the differences from the official Yandex server, covers getting an API key and Folder ID in Yandex Cloud, venv install, configs for Claude Code, Codex CLI, opencode and Docker, full parameter tables for all three tools, a quota table, and a troubleshooting section for common auth and limit errors.

README badge

Report a problem