SkillFoxx
Telegram

MCP Yandex Search API с отложенным поиском

Yandex Search MCP Server (Async Mode)

Форк официального сервера Яндекса с отложенным async-поиском по умолчанию, который экономит до 94% на тарифе Search API

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

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

  • Запускает Python-сервер, который по ключу Yandex Cloud ставит отложенные поисковые запросы
  • ID операций хранит в локальной SQLite, запросы платные
Все причины и проверки
Российский стек

hdworker/ydex-async-search-mcp-serverАвтор:hdworker

Установка

Ручная установка

docker build -t yandex-mcp-server-async:latest . && docker run -i --rm -e SEARCH_API_KEY=<your_api_key> -e FOLDER_ID=<your_folder_id> -v $(pwd)/data:/app/data yandex-mcp-server-async:latest

Сборка и запуск в Docker с сохранением SQLite-хранилища в volume.

Доступ и проверки

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

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Запускает Python-сервер, который по ключу Yandex Cloud ставит отложенные поисковые запросы
  • ID операций хранит в локальной SQLite, запросы платные

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

Что делает

Сервер дорабатывает официальный yandex/yandex-search-mcp-server: инструмент web_search по умолчанию уходит в отложенный (async) режим вместо синхронного, потому что отложенный тариф Яндекса дешевле в разы, особенно ночью. Статус и результат операции проверяются отдельным инструментом get_search_status по operation_id, список незавершенных запросов дает get_pending_searches, а cleanup_old_searches чистит старые записи. ID операций хранятся в локальной SQLite, а не только в памяти, так что их можно проверить позже даже после перезапуска сервера.

Для кого. Для тех, кто много и часто ищет через Yandex Search API и хочет платить по отложенному тарифу вместо синхронного.

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

  • Объем запросов достаточно большой, чтобы разница в цене между sync и async была заметна
  • Агент может подождать результат или проверить его позже отдельным вызовом
  • Нужно отслеживать статус пачки запросов и чистить старые записи автоматически

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

  • Нужен мгновенный синхронный ответ на каждый запрос: можно передать mode sync, но тогда экономии нет
  • Нужны картиночный или генеративный поиск: сервер сфокусирован на web_search

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

Найди информацию про кофемашины в отложенном режиме и сообщи, когда результат будет готов

MCP

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

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

SEARCH_API_KEY обязательная, секрет
API-ключ сервисного аккаунта Yandex Cloud со scope yc.search-api.execute
FOLDER_ID обязательная
ID папки Yandex Cloud

Ограничения

Async-режим по умолчанию означает, что результат не мгновенный, агенту нужно опрашивать get_search_status или явно передать wait true. Нужен сервисный аккаунт Yandex Cloud с ролью search-api.webSearch.user и API-ключ со scope yc.search-api.execute. Цены в README указаны на момент публикации и могут измениться у Яндекса.

Как отключить. Остановите контейнер или процесс сервера и удалите его из конфигурации MCP клиента.

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

Можно ли получить синхронный ответ, как в оригинале?

Да, передайте mode sync в вызове web_search, но тогда действует более дорогой синхронный тариф.

Где хранятся ID операций?

В локальной SQLite базе, которая монтируется как volume /app/data в Docker.

Обсуждение

Вопросов и отзывов пока нет.

Яндекс Поиск — все инструменты
Российский стек

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

MCP-серверРасширенный доступ4

MCP-сервер Yandex Search API v2 по HTTP

Yandex Search API MCP server, StreamableHTTP build

Российский стек

Форк официального сервера Яндекса с добавленным HTTP-транспортом и полным набором типов поиска: веб, генеративный, картинки

MCP-серверРасширенный доступ1
Российский стек

MCP-сервер поиска Яндекса на .NET 10 с нативной AOT-сборкой, конвертацией страниц в Markdown и поиском по regex

MCP-серверРасширенный доступ
Российский стек

MCP-сервер Yandex Cloud Search API v2: Вордстат и веб-поиск с файловым кешем, нормализацией дат и устойчивостью к 429

MCP-серверРасширенный доступ

Коротко о README

README на русском сравнивает цены синхронного и отложенного тарифов Яндекса с конкретной экономией в процентах и рублях, дает пошаговую настройку Yandex CLI, сервисного аккаунта и API-ключа, установку через Docker или Python, конфиги для Claude Desktop, Cursor и opencode, описание всех четырех инструментов и схему архитектуры сервера.

Бейдж для README

Сообщить о проблеме