@scom82/yandex-search-mcp
MCP-сервер Yandex Cloud Search API v2: Вордстат и веб-поиск с файловым кешем, нормализацией дат и устойчивостью к 429
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает статистику запросов и результаты веб-поиска, ничего не меняет
- Синхронный веб-поиск заметно дороже асинхронного, стоит выбирать режим по объему задачи
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/scom82-yandex-search-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio scom82-yandex-search-mcp -- npx -y @scom82/yandex-search-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"scom82-yandex-search-mcp": {
"command": "npx",
"args": [
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"scom82-yandex-search-mcp": {
"command": "npx",
"args": [
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"scom82-yandex-search-mcp","type":"stdio","command":"npx","args":["-y","@scom82/yandex-search-mcp"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"scom82-yandex-search-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add scom82-yandex-search-mcp -- npx -y @scom82/yandex-search-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.scom82-yandex-search-mcp]
command = "npx"
args = ["-y", "@scom82/yandex-search-mcp"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"scom82-yandex-search-mcp": {
"command": "npx",
"args": [
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"scom82-yandex-search-mcp": {
"command": "npx",
"args": [
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"scom82-yandex-search-mcp": {
"command": "npx",
"args": [
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"scom82-yandex-search-mcp": {
"command": "npx",
"args": [
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"scom82-yandex-search-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"scom82-yandex-search-mcp": {
"command": "npx",
"args": [
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"scom82-yandex-search-mcp": {
"command": "npx",
"args": [
"-y",
"@scom82/yandex-search-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Установи сервер командой npx -y @scom82/yandex-search-mcp, добавь в .mcp.json с переменными YC_SEARCH_API_KEY и YC_FOLDER_ID, вызови wordstat_regions_tree бесплатно, чтобы проверить подключение.
Другие способы из описания автора
npx -y @scom82/yandex-search-mcpСпособ из README, пакет опубликован в npm.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер закрывает пять инструментов: четыре метода Wordstat (топ похожих фраз с ассоциациями, динамика по датам, распределение по регионам с affinity-индексом, бесплатное дерево регионов) и websearch_query, поиск Яндекса с синхронным и вдвое-в-шестнадцать-раз более дешевым асинхронным режимом. Сервер сам решает мелкие неудобства API: числа int64 приходят строками и парсятся в числа, обычные ISO-даты автоматически выравниваются под границы периода Вордстата, короткие значения вроде monthly или desktop дополняются нужным префиксом enum, а результаты веб-поиска декодируются из base64 в чистый JSON вместо XML с тегами подсветки. Ответы кешируются в файл на 30 дней для Вордстата и на 1 день для веб-поиска.
Для кого. Для разработчиков, которым нужен надежный слой поверх Yandex Cloud Search API с кешем и защитой от типичных ошибок формата.
Подходит, если
- Нужны и Вордстат, и веб-поиск Яндекса в одном сервере
- Важно не тратить деньги на повторные одинаковые запросы: есть файловый кеш
- Нужна дешевая пакетная обработка веб-поиска: есть асинхронный режим
Не подходит, если
- Устраивает старый форк yandex-mcp с методами api.wordstat.yandex.net: тот хост Яндекс отключил, отсюда и появился этот сервер
- Не нужен веб-поиск, а нужен только Вордстат без кеша и нормализации
Пример запроса к агенту
Найди топ похожих запросов к фразе «доставка цветов» и покажи, кто занимает выдачу Яндекса по этому запросуОграничения
Нужны YC_SEARCH_API_KEY и YC_FOLDER_ID сервисного аккаунта с ролью search-api.webSearch.user. Синхронный веб-поиск стоит около 488 рублей за 1000 запросов, асинхронный, около 30.5 рубля. Планируемая функция Generative Search вынесена в отдельный будущий этап (Phase 2) и в этой версии не реализована. Пакет не опубликован в PyPI/npm registry с отдельным README, лицензия MIT.
Как отключить. Удалите запись yandex-search из .mcp.json или выполните claude mcp remove yandex-search.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YC_SEARCH_API_KEY обязательная, секрет | Ключ сервисного аккаунта Yandex Cloud. |
| YC_FOLDER_ID обязательная | ID каталога, добавляется в тело каждого запроса. |
Проверка безопасности
- Только читает статистику запросов и результаты веб-поиска, ничего не меняет
- Синхронный веб-поиск заметно дороже асинхронного, стоит выбирать режим по объему задачи
Коротко о README
README объясняет предысторию, замену отключенного хоста Вордстата, дает таблицу пяти инструментов, подробно описывает автоматические доработки формата (int64, даты, enum-префиксы, декодирование base64), таблицу переменных окружения и инструкцию по получению сервисного ключа в консоли Yandex Cloud.
Частые вопросы
Почему у старого yandex-mcp сломались инструменты wordstat_*?
Яндекс отключил отдельный хост api.wordstat.yandex.net, поэтому этот сервер переехал на Yandex Cloud Search API v2 с теми же именами инструментов.
Асинхронный веб-поиск отдает результат сразу?
Нет, нужно опрашивать /operations/{id}, зато он примерно в 16 раз дешевле синхронного.
Похожие
Скиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов