MCP-сервер Yandex Search API v2

yandex-search-mcp

Self-hosted MCP для Yandex Search API v2: веб, картинки и генеративный поиск по всем шести индексам Яндекса

oleg-cat/yandex-search-mcpАвтор:oleg-cat

Установка

В терминале, через SkillFoxx CLI

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

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

Выполните в терминале

claude mcp add --transport stdio --env 'YANDEX_SEARCH_API_KEY=<ваш YANDEX_SEARCH_API_KEY>' --env 'YANDEX_FOLDER_ID=<ваш YANDEX_FOLDER_ID>' --env YANDEX_MCP_DEFAULT_SEARCH_TYPE=ru --env YANDEX_MCP_TIMEOUT_WEB=15 --env YANDEX_MCP_TIMEOUT_GEN=120 --env YANDEX_MCP_LOG_LEVEL=INFO --env YANDEX_MCP_TRANSPORT=stdio --env YANDEX_MCP_HOST=127.0.0.1 --env YANDEX_MCP_PORT=8000 yandex-search-mcp -- uvx yandex-search-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "yandex-search-mcp": {
      "command": "uvx",
      "args": [
        "yandex-search-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "yandex-search-mcp": {
      "command": "uvx",
      "args": [
        "yandex-search-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"yandex-search-mcp","type":"stdio","command":"uvx","args":["yandex-search-mcp"],"env":{"YANDEX_SEARCH_API_KEY":"<ваш YANDEX_SEARCH_API_KEY>","YANDEX_FOLDER_ID":"<ваш YANDEX_FOLDER_ID>","YANDEX_MCP_DEFAULT_SEARCH_TYPE":"ru","YANDEX_MCP_TIMEOUT_WEB":"15","YANDEX_MCP_TIMEOUT_GEN":"120","YANDEX_MCP_LOG_LEVEL":"INFO","YANDEX_MCP_TRANSPORT":"stdio","YANDEX_MCP_HOST":"127.0.0.1","YANDEX_MCP_PORT":"8000"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "yandex-search-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "yandex-search-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add yandex-search-mcp --env 'YANDEX_SEARCH_API_KEY=<ваш YANDEX_SEARCH_API_KEY>' --env 'YANDEX_FOLDER_ID=<ваш YANDEX_FOLDER_ID>' --env YANDEX_MCP_DEFAULT_SEARCH_TYPE=ru --env YANDEX_MCP_TIMEOUT_WEB=15 --env YANDEX_MCP_TIMEOUT_GEN=120 --env YANDEX_MCP_LOG_LEVEL=INFO --env YANDEX_MCP_TRANSPORT=stdio --env YANDEX_MCP_HOST=127.0.0.1 --env YANDEX_MCP_PORT=8000 -- uvx yandex-search-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.yandex-search-mcp]
command = "uvx"
args = ["yandex-search-mcp"]
env = { YANDEX_SEARCH_API_KEY = "<ваш YANDEX_SEARCH_API_KEY>", YANDEX_FOLDER_ID = "<ваш YANDEX_FOLDER_ID>", YANDEX_MCP_DEFAULT_SEARCH_TYPE = "ru", YANDEX_MCP_TIMEOUT_WEB = "15", YANDEX_MCP_TIMEOUT_GEN = "120", YANDEX_MCP_LOG_LEVEL = "INFO", YANDEX_MCP_TRANSPORT = "stdio", YANDEX_MCP_HOST = "127.0.0.1", YANDEX_MCP_PORT = "8000" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'YANDEX_SEARCH_API_KEY=<ваш YANDEX_SEARCH_API_KEY>' -e 'YANDEX_FOLDER_ID=<ваш YANDEX_FOLDER_ID>' -e YANDEX_MCP_DEFAULT_SEARCH_TYPE=ru -e YANDEX_MCP_TIMEOUT_WEB=15 -e YANDEX_MCP_TIMEOUT_GEN=120 -e YANDEX_MCP_LOG_LEVEL=INFO -e YANDEX_MCP_TRANSPORT=stdio -e YANDEX_MCP_HOST=127.0.0.1 -e YANDEX_MCP_PORT=8000 yandex-search-mcp uvx yandex-search-mcp

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-search-mcp": {
      "command": "uvx",
      "args": [
        "yandex-search-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "yandex-search-mcp": {
      "command": "uvx",
      "args": [
        "yandex-search-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-search-mcp": {
      "command": "uvx",
      "args": [
        "yandex-search-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-search-mcp": {
      "command": "uvx",
      "args": [
        "yandex-search-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "yandex-search-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "yandex-search-mcp"
      ],
      "environment": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "yandex-search-mcp": {
      "command": "uvx",
      "args": [
        "yandex-search-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-search-mcp": {
      "command": "uvx",
      "args": [
        "yandex-search-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>",
        "YANDEX_MCP_DEFAULT_SEARCH_TYPE": "ru",
        "YANDEX_MCP_TIMEOUT_WEB": "15",
        "YANDEX_MCP_TIMEOUT_GEN": "120",
        "YANDEX_MCP_LOG_LEVEL": "INFO",
        "YANDEX_MCP_TRANSPORT": "stdio",
        "YANDEX_MCP_HOST": "127.0.0.1",
        "YANDEX_MCP_PORT": "8000"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_SEARCH_API_KEYсекрет, обязательная: Api-Key (scope yc.search-api.execute)
YANDEX_FOLDER_IDсекрет, обязательная: Folder ID (role search-api.editor)
YANDEX_SEARCH_API_KEY_FILEсекрет, необязательная: Alternative: path to a file with the key (Docker/K8s secrets)
YANDEX_MCP_ENABLED_TOOLSнеобязательная: Tool whitelist, space- or comma-separated, e.g. "yandex_web_search"
YANDEX_MCP_DISABLED_TOOLSнеобязательная: Tool blacklist, applied after the whitelist, e.g. "yandex_gen_search"
YANDEX_MCP_DEFAULT_REGIONнеобязательная: Default geo-id (225 = Russia, 213 = Moscow)

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 26 сент. 2026, коммит 4315ed7.

Текст для агента

Склонируй oleg-cat/yandex-search-mcp, поставь зависимости через venv и pip install -e ., получи ключ и Folder ID в Yandex Cloud, подключи командой claude mcp add yandex-search -e YANDEX_SEARCH_API_KEY=ключ -e YANDEX_FOLDER_ID=папка -- /абсолютный/путь/.venv/bin/python -m yandex_search_mcp.

Другие способы из описания автора

claude mcp add yandex-search -e YANDEX_SEARCH_API_KEY=<key> -e YANDEX_FOLDER_ID=<folder> -- /abs/path/to/yandex-search-mcp/.venv/bin/python -m yandex_search_mcp

Команда из README, использует абсолютный путь к venv python.

Проверка безопасности

Как мы проверяем

Низкий рискНизкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.

Все три инструмента только читают публичные результаты поиска через официальный API

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер на Python дает три типизированных инструмента: yandex_web_search для классического веб-поиска с операторами site, host, date и минус-словами, yandex_image_search с фильтрами по формату, размеру, ориентации и цвету, и yandex_gen_search для одного ИИ-ответа со ссылками на источники. Поддерживаются все шесть индексов Яндекса: ru, com, tr, kk, be, uz. Автор написал сервер с нуля взамен официального yandex/yandex-search-mcp-server, который называет демкой под турецкий рынок с хрупким XML-парсингом и хаком json.loads на генеративном поиске. Здесь XML парсится defusedxml против живых фикстур API, есть повторы с экспоненциальной задержкой на 429 и 5xx и юнит-контракт ошибок, а API-ключ по тестам никогда не попадает в логи.

Для кого. Для разработчиков, которым нужен надежный и типизированный доступ к поиску Яндекса, включая ИИ-ответ с источниками, из Claude Code, Codex или opencode.

Подходит, если

Нужен официальный Yandex Search API v2, а не скрапинг выдачи
Нужен генеративный поиск с явными ссылками на источники, а не только список документов
Работаете с русскоязычным поиском и нужны все шесть индексов Яндекса

Не подходит, если

Нет сервисного аккаунта Yandex Cloud: без API-ключа и Folder ID сервер не запустится
Нужен мгновенный ответ от генеративного поиска: квота 1 запрос в секунду, а ответы занимают десятки секунд

Пример запроса к агенту

Найди свежие новости про закон о такси за последние две недели и дай короткий ответ со ссылками на источники

MCP

Транспорт: stdio
Авторизация: API-ключ

Переменные окружения

YANDEX_SEARCH_API_KEY обязательная, секрет: Api-Key сервисного аккаунта Yandex Cloud со scope yc.search-api.execute
YANDEX_FOLDER_ID обязательная: ID папки Yandex Cloud с ролью search-api.editor
YANDEX_MCP_ENABLED_TOOLS: Список разрешенных инструментов через пробел, по умолчанию все

Ограничения

Пакет не публикуется в PyPI, устанавливается клонированием и pip install -e. Квоты по умолчанию: 10 RPS и 10000 в час для веб- и картиночного поиска, 1 RPS и 1000 в час для генеративного поиска, сервер их не обходит, только повторяет запрос при 429 и 5xx. Нужен ключ сервисного аккаунта Yandex Cloud со scope yc.search-api.execute и ролью search-api.editor.

Как отключить. Удалите сервер командой claude mcp remove yandex-search или codex mcp remove yandex-search, либо уберите запись из конфигурации.

Частые вопросы

Чем это лучше официального сервера Яндекса?

Автор указывает на регион только tr/en у официального сервера, хрупкий XML-парсинг регулярками и несуществующий пин зависимости; здесь парсер проверен против живых фикстур и поддержаны все 6 индексов.

Почему генеративный поиск такой медленный?

Квота 1 запрос в секунду, а сам ответ формируется десятки секунд, таймаут по умолчанию 120 секунд.

MCP-серверы

Browser Use

Выбор редакции

CLI, скилл и Python-библиотека для управления браузером: агент кликает, заполняет формы и читает страницы через CDP

CLIВысокий риск116,6 тыс.

last30days

Выбор редакции

Скилл собирает обсуждения темы за последние 30 дней из Reddit, X, YouTube, HN, Polymarket и GitHub и сводит их в бриф

СкиллВысокий риск63,2 тыс.

Chrome DevTools MCP

Официальный

Официальный MCP-сервер команды Chrome DevTools: агент управляет живым Chrome, смотрит сеть, консоль и записывает трейсы производительности

MCP-серверСредний риск52,7 тыс.

agent-browser

Официальный

Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы

CLIВысокий риск43,4 тыс.

Коротко о README

README подробно объясняет отличия от официального сервера Яндекса, дает получение ключа и Folder ID в Yandex Cloud, установку через venv, конфиги для Claude Code, Codex CLI, opencode и Docker, полные таблицы параметров для всех трех инструментов, таблицу квот и раздел troubleshooting с типичными ошибками авторизации и лимитов.

Установка

Проверка безопасности

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

MCP

Переменные окружения

Ограничения

Частые вопросы

Похожие

Browser Use

last30days

Chrome DevTools MCP

agent-browser

Коротко о README