СрезAI — MCP Сервер и поисковый API для ИИ Агентов README

srezai-mcp

MCP-сервер срезAI — поисковый API для ИИ-агентов: живой веб-поиск по Рунету и глобальному вебу, чтение страниц в чистый Markdown, карта сайта, извлечение по схеме, проверка утверждений, готовые ответы, многошаговое исследование и субтитры YouTube как встроенные инструменты ИИ-агента.

MCP server for SrezAI — a search API for AI agents: live web search, page reading into clean Markdown, site map, schema-based extraction, claim verification, ready answers, multi-step research and YouTube transcripts as native agent tools.

Нужен ли вам этот пакет / Do you need this package

Скорее всего нет. Если ваш клиент умеет Streamable HTTP (Claude Desktop, современные IDE-агенты) — подключайтесь к серверу напрямую, без установки:

config.json

{
  "mcpServers": {
    "srezai": {
      "url": "https://srezai.ru/api/mcp",
      "headers": { "Authorization": "Bearer srz_live_ваш_ключ" }
    }
  }
}

Пакет нужен там, где клиент умеет только stdio и не поддерживает удалённые серверы по HTTP.

Установка / Installation

config.json

{
  "mcpServers": {
    "srezai": {
      "command": "npx",
      "args": ["-y", "srezai-mcp"],
      "env": { "SREZAI_API_KEY": "srz_live_ваш_ключ" }
    }
  }
}

Ключ создаётся в личном кабинете. Нужен Node 18+.

Если Windows капризничает с переменными окружения, в некоторых клиентах помогает такая форма:

Code

cmd /c "set SREZAI_API_KEY=srz_live_ваш_ключ && npx -y srezai-mcp"

Инструменты / Tools

Инструмент	Что делает
`web_search`	Поиск в живом вебе: заголовок, ссылка, фрагмент. Категории, языки, свежесть, фильтр по доменам
`image_search`	Картинки: прямые ссылки, источник, разрешение
`read_url`	Страница → чистый Markdown; длинная приходит окнами по `offset`
`read_urls`	То же, до 5 страниц за вызов
`yt_srt`	Субтитры ролика YouTube (ручные или авто) → текст в контекст агента; окно `from`/`to`, таймкоды, до 5 роликов за вызов. Видео и звук не скачиваются
`fetch_page`	Рендер в браузере: скриншот и Markdown; если рендер не удался — текст за 1 кредит вместо 3
`extract`	Только запрошенные поля по вашей схеме, без текста страницы; до 5 ссылок
`verify_claim`	Вердикт `supported` / `refuted` / `mixed` / `unverified` с дословными цитатами по 2–5 независимым доменам
`answer_search`	Готовый ответ со ссылками: поиск, семантическое ранжирование BGE-reranker-v2-m3, чтение и синтез
`deep_research`	Агентное исследование по многим источникам; идёт долго, поэтому возвращает талон, а ответ забирается по нему
`get_usage`	Баланс, квота, расход по услугам и прайс-лист. Бесплатно, квоту не расходует
`map`	Карта сайта: адреса и разделы из `sitemap` или со стартовой страницы, до 200 адресов за вызов
`crawl`	Карта адресов плюс текст найденных страниц; фильтры по адресу и по тексту

Описания, параметры и цены живут на сервере, а не в пакете: агент видит их через tools/list в момент подключения. Новый инструмент появляется у вас без обновления srezai-mcp.

Платите только за результат: ошибка и вызов, не принёсший ничего, не списываются. 1 кредит = 0,10 ₽, точный прайс-лист отдаёт get_usage.

Как это работает / How it works

Пакет — тонкий мост: читает JSON-RPC из stdin, пересылает на https://srezai.ru/api/mcp с вашим ключом, возвращает ответ в stdout. Собственной логики инструментов в нём нет — поэтому он не может разойтись с тем, что на самом деле умеет API.

Зависимостей во время работы — ноль: только встроенные модули Node.

Готовый mcp-remote здесь не подошёл: он начинает с OAuth-регистрации клиента и не умеет статический Bearer-ключ, на котором работает срезAI.

Настройка / Configuration

Переменная	Назначение
`SREZAI_API_KEY`	Ключ доступа. Нужен для вызова инструментов
`SREZAI_MCP_ENDPOINT`	Другой адрес сервера. По умолчанию `https://srezai.ru/api/mcp`

Без ключа мост всё равно запускается и отдаёт initialize и tools/list: список инструментов сервер публикует анонимно, так его читают каталоги MCP. Вызов любого инструмента в этом режиме вернёт ошибку с указанием задать SREZAI_API_KEY. / Without a key the bridge still starts and serves initialize and tools/list — the tool list is public, which is how MCP directories read it. Calling a tool returns an error asking you to set SREZAI_API_KEY.

Разработка / Development

Terminal

npm ci && npm test && npm run build

Docker-образ (его собирают каталоги MCP, опрашивая сервер в песочнице) / Docker image, built by MCP directories to introspect the server in a sandbox:

Terminal

docker build -t srezai-mcp . && docker run --rm -i -e SREZAI_API_KEY=srz_live_ваш_ключ srezai-mcp

Правки принимаются здесь, на GitHub: CONTRIBUTING.md объясняет, почему копия на GitVerse — зеркало и как прислать патч, если GitHub недоступен. Об уязвимости — SECURITY.md, не публичным issue. Правила общения — CODE_OF_CONDUCT.md.

Changes go to GitHub: CONTRIBUTING.md explains why the GitVerse copy is a mirror and how to send a patch if GitHub is unavailable to you. For vulnerabilities see SECURITY.md rather than a public issue. Ground rules: CODE_OF_CONDUCT.md.

Лицензия / License

MIT