Yandex Search MCP — MCP-сервер для Claude Code: поиск и установка
MCP-сервер подключает Yandex Search API к ИИ-клиенту и возвращает структурированные результаты веб-поиска. Пригодится для поиска по русскоязычным и международным запросам.
claude mcp add yandex-search-mcp -e YANDEX_SEARCH_API_KEY=<YANDEX_SEARCH_API_KEY> -e YANDEX_FOLDER_ID=<YANDEX_FOLDER_ID> -- npx -y @stufently/yandex-search-mcpЧто делает Yandex Search MCP
Yandex Search MCP передаёт запросы в Yandex Search API v2 и возвращает позиции, заголовки, URL, домены, сниппеты, фрагменты текста и метаданные страниц. Для maxResults можно задать число результатов от 1 до 100, а также передать регион, страницу и режим семейного поиска.
Сервер использует YANDEX_SEARCH_API_KEY и YANDEX_FOLDER_ID, а запросы с кириллицей направляет в русский индекс, а латинские запросы — в международный. При ошибках 429 и 5xx включён повтор с экспоненциальной задержкой. Без ключа API и идентификатора папки сервер не запустится.
Какие задачи решает
- найти страницы по веб-запросу
- получить сниппеты и URL результатов
- отфильтровать выдачу по региону
- переключить режим семейного поиска
Примеры запросов агенту
- Найди в интернете документацию по библиотеке
react-queryи верни URL, заголовки и краткие фрагменты. - Проверь запросом на русском, какие страницы описывают настройку
YANDEX_FOLDER_ID. - Повтори поиск с
maxResultsравным 20 и режимомFAMILY_MODE_STRICT.
Как установить Yandex Search MCP
Командой платформы
claude mcp add yandex-search-mcp -e YANDEX_SEARCH_API_KEY=<YANDEX_SEARCH_API_KEY> -e YANDEX_FOLDER_ID=<YANDEX_FOLDER_ID> -- npx -y @stufently/yandex-search-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add yandex-search-mcp --env YANDEX_SEARCH_API_KEY=<YANDEX_SEARCH_API_KEY> --env YANDEX_FOLDER_ID=<YANDEX_FOLDER_ID> -- npx -y @stufently/yandex-search-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"yandex-search-mcp": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-search-mcp"
],
"env": {
"YANDEX_SEARCH_API_KEY": "<YANDEX_SEARCH_API_KEY>",
"YANDEX_FOLDER_ID": "<YANDEX_FOLDER_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"yandex-search-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stufently/yandex-search-mcp"
],
"env": {
"YANDEX_SEARCH_API_KEY": "<YANDEX_SEARCH_API_KEY>",
"YANDEX_FOLDER_ID": "<YANDEX_FOLDER_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e YANDEX_SEARCH_API_KEY=<YANDEX_SEARCH_API_KEY> -e YANDEX_FOLDER_ID=<YANDEX_FOLDER_ID> yandex-search-mcp npx -y @stufently/yandex-search-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Yandex Search MCP
Как установить Yandex Search MCP в Claude Code?
Выполните `claude mcp add yandex-search-mcp -e YANDEX_SEARCH_API_KEY=<YANDEX_SEARCH_API_KEY> -e YANDEX_FOLDER_ID=<YANDEX_FOLDER_ID> -- npx -y @stufently/yandex-search-mcp`.
Что делает Yandex Search MCP?
Он даёт ИИ-клиенту доступ к веб-поиску через Yandex Search API v2 и возвращает структурированные результаты с заголовками, URL и сниппетами.
Что нужно для работы сервера?
Нужны ключ YANDEX_SEARCH_API_KEY из Yandex Cloud Console и YANDEX_FOLDER_ID из Yandex Cloud. OAuth-поток не требуется.
