SkillFoxx

Начните вводить название, задачу или сервис

MCP Yandex Search.API с Wordstat

Yandex Search.API MCP Server

MCP-сервер официального Search.API Яндекса: веб, картинки, генеративный поиск и четыре инструмента Wordstat в одном пакете npm

MCP-сервер

Низкий риск

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

Почему такой уровень

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

shufl9dka/yandex-searchapi-mcpАвтор:shufl9dka

Установка

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

npx skillfoxx add mcp/yandex-search-api-mcp-server

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

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

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

claude mcp add --transport stdio --env 'FOLDER_ID=<значение FOLDER_ID>' --env 'API_KEY=<ваш API_KEY>' yandex-searchapi -- npx -y yandex-searchapi-mcp

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

{
  "mcpServers": {
    "yandex-searchapi": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-searchapi-mcp"
      ],
      "env": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

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

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

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

{
  "mcpServers": {
    "yandex-searchapi": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-searchapi-mcp"
      ],
      "env": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

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

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

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

code --add-mcp '{"name":"yandex-searchapi","type":"stdio","command":"npx","args":["-y","yandex-searchapi-mcp"],"env":{"FOLDER_ID":"<значение FOLDER_ID>","API_KEY":"<ваш API_KEY>"}}'

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

{
  "servers": {
    "yandex-searchapi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "yandex-searchapi-mcp"
      ],
      "env": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

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

codex mcp add yandex-searchapi --env 'FOLDER_ID=<значение FOLDER_ID>' --env 'API_KEY=<ваш API_KEY>' -- npx -y yandex-searchapi-mcp

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

[mcp_servers.yandex-searchapi]
command = "npx"
args = ["-y", "yandex-searchapi-mcp"]
env = { FOLDER_ID = "<значение FOLDER_ID>", API_KEY = "<ваш API_KEY>" }

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

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

{
  "mcpServers": {
    "yandex-searchapi": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-searchapi-mcp"
      ],
      "env": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

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

{
  "mcpServers": {
    "yandex-searchapi": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-searchapi-mcp"
      ],
      "env": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "yandex-searchapi": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-searchapi-mcp"
      ],
      "env": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

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

{
  "mcpServers": {
    "yandex-searchapi": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-searchapi-mcp"
      ],
      "env": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

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

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

{
  "mcp": {
    "yandex-searchapi": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "yandex-searchapi-mcp"
      ],
      "environment": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

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

{
  "context_servers": {
    "yandex-searchapi": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-searchapi-mcp"
      ],
      "env": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

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

{
  "mcpServers": {
    "yandex-searchapi": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-searchapi-mcp"
      ],
      "env": {
        "FOLDER_ID": "<значение FOLDER_ID>",
        "API_KEY": "<ваш API_KEY>"
      }
    }
  }
}

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

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

FOLDER_IDобязательная
API_KEYсекрет, обязательная

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

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 9df0e62.

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

Установи пакет npm install yandex-searchapi-mcp, добавь сервер в конфиг MCP клиента с переменными FOLDER_ID и API_KEY сервисного аккаунта Yandex Cloud.

Другие способы из описания автора
npm install yandex-searchapi-mcp

Установка пакета из npm registry.

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

Что делает

Сервер дает семь инструментов поверх REST-эндпоинтов Search.API: web_search, image_search и generative_search используют /v2/web/search, /v2/image/search и /v2/gen/search, а wordstat_get_top, wordstat_get_dynamics, wordstat_get_regions_distribution и wordstat_get_regions_tree покрывают Wordstat REST. Веб- и картиночный поиск декодируют rawData из Base64 и разбирают XML в структурированные группы документов, веб-поиск всегда работает с форматом XML. Входные параметры инструментов минимальны по умолчанию, чтобы не раздувать контекст модели, при этом searchType доступен везде и по умолчанию SEARCH_TYPE_COM.

Для кого. Для разработчиков и маркетологов, которым нужны и поиск, и спрос по ключевым словам Wordstat в одном официальном MCP-сервере.

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

  • Нужны и поиск, и спрос по ключевым словам Wordstat в одном сервере
  • Важно, чтобы веб- и картиночный поиск возвращали структурированные группы документов, а не сырой XML
  • Устраивает установка одной командой npm install из зарегистрированного пакета

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

  • Нужен доступ к Яндекс Вебмастеру или Директу: сервер покрывает только Search.API и Wordstat
  • Не готовы оформлять сервисный аккаунт Yandex Cloud с ключом и Folder ID

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

Найди топ похожих запросов для купить зимнюю резину и покажи динамику спроса за последний месяц

Ограничения

Нужны переменные FOLDER_ID и API_KEY сервисного аккаунта Yandex Cloud. Веб-поиск принудительно использует формат XML, других форматов ответа нет. Wordstat недоступен без отдельного разрешения на использование этого метода в Yandex Cloud.

Как отключить. Удалите запись yandex-searchapi из mcpServers в конфигурации клиента.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
API_KEY
обязательная, секрет		Ключ сервисного аккаунта Yandex Cloud для Search.API
FOLDER_ID
обязательная		ID папки Yandex Cloud

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

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

Коротко о README

README перечисляет все семь инструментов с входными и выходными полями, объясняет, что сервер использует только REST-эндпоинты Search.API и Wordstat, дает установку через npm и пример конфигурации MCP-клиента с переменными FOLDER_ID и API_KEY.

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

В каком формате приходит веб-поиск?

Сервер всегда запрашивает XML (responseFormat FORMAT_XML) и сам разбирает его в структурированные группы документов.

Нужен ли отдельный доступ для Wordstat?

Да, методы Wordstat в Yandex Cloud обычно требуют отдельного разрешения на сервисном аккаунте.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2
Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

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

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.
Foxx AIMCP Yandex Search.API с Wordstat

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.