srezai-mcp
OfficialThe SrezAI MCP server turns an AI agent into a live-web research tool for the Russian and global web — search, read, extract, verify, and research without leaving the chat.
web_search— live web search with ranked titles, links and snippets; filter by category, language, recency and include/exclude up to 10 domains.image_search— find images as direct file links with source page and resolution (up to 48).read_url/read_urls— turn one or up to 5 pages into clean Markdown (JS-rendered SPAs included), with adjustablemaxCharsand fetch engine.fetch_page— full browser render returning a screenshot plus page Markdown (useful for layout/design questions).extract— pull only the fields you specify into JSON via a schema, across up to 5 URLs.yt_srt— YouTube transcripts (manual or auto) as text, with timestamps and windows, up to 5 videos.verify_claim— fact-check a claim into supported/refuted/mixed/unverified with verbatim quotes from 2–5 independent domains.answer_search— a ready synthesized answer with citations (search + BGE-reranker + read + synthesis).deep_research— multi-step agentic research returning a source-backed report (slower, ticket-based).map/crawl— site structure from sitemap or start page (up to 200 URLs), plus optional page text.get_usage— check balance, daily quota, reset time and the price list (free, no quota consumed).
Provides a tool to retrieve YouTube video transcripts/subtitles (manual or auto-generated) into the agent context, with timecode windowing and support for up to 5 videos per call; video and audio files are not downloaded.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@srezai-mcp search for latest AI news"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-агенты) — подключайтесь к серверу напрямую, без установки:
{
"mcpServers": {
"srezai": {
"url": "https://srezai.ru/api/mcp",
"headers": { "Authorization": "Bearer srz_live_ваш_ключ" }
}
}
}Пакет нужен там, где клиент умеет только stdio и не поддерживает удалённые серверы по HTTP.
Related MCP server: tavily-mcp
Установка / Installation
{
"mcpServers": {
"srezai": {
"command": "npx",
"args": ["-y", "srezai-mcp"],
"env": { "SREZAI_API_KEY": "srz_live_ваш_ключ" }
}
}
}Ключ создаётся в личном кабинете. Нужен Node 18+.
Если Windows капризничает с переменными окружения, в некоторых клиентах помогает такая форма:
cmd /c "set SREZAI_API_KEY=srz_live_ваш_ключ && npx -y srezai-mcp"Инструменты / Tools
Инструмент | Что делает |
| Поиск в живом вебе: заголовок, ссылка, фрагмент. Категории, языки, свежесть, фильтр по доменам |
| Картинки: прямые ссылки, источник, разрешение |
| Страница → чистый Markdown; длинная приходит окнами по |
| То же, до 5 страниц за вызов |
| Субтитры ролика YouTube (ручные или авто) → текст в контекст агента; окно |
| Рендер в браузере: скриншот и Markdown; если рендер не удался — текст за 1 кредит вместо 3 |
| Только запрошенные поля по вашей схеме, без текста страницы; до 5 ссылок |
| Вердикт |
| Готовый ответ со ссылками: поиск, семантическое ранжирование BGE-reranker-v2-m3, чтение и синтез |
| Агентное исследование по многим источникам; идёт долго, поэтому возвращает талон, а ответ забирается по нему |
| Баланс, квота, расход по услугам и прайс-лист. Бесплатно, квоту не расходует |
| Карта сайта: адреса и разделы из |
| Карта адресов плюс текст найденных страниц; фильтры по адресу и по тексту |
Описания, параметры и цены живут на сервере, а не в пакете: агент видит их
через 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
Переменная | Назначение |
| Ключ доступа. Нужен для вызова инструментов |
| Другой адрес сервера. По умолчанию |
Без ключа мост всё равно запускается и отдаёт 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.
Claude Code: плагин из маркетплейса / Claude Code plugin
Репозиторий сам является маркетплейсом Claude Code: плагин srezai-web-access
подключает удалённый MCP-сервер srezai.ru одной командой.
/plugin marketplace add srezai-team/srezai-mcp-web-search
/plugin install srezai-web-access@srezai-mcpПосле установки сервер srezai работает как обычный MCP с 14 инструментами.
Без ключа действует бесплатный режим — 25 запросов в сутки с одного IP. Для
платных инструментов ключ добавляется вручную:
claude mcp add --transport http srezai https://srezai.ru/api/mcp \
--header "Authorization: Bearer srz_live_ваш_ключ"Файлы маркетплейса: .claude-plugin/marketplace.json и
plugins/srezai-web-access/ (.claude-plugin/plugin.json + .mcp.json).
Валидация: claude plugin validate . → «Validation passed».
Разработка / Development
npm ci && npm test && npm run buildDocker-образ (его собирают каталоги MCP, опрашивая сервер в песочнице) / Docker image, built by MCP directories to introspect the server in a sandbox:
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
Available Tools
8 toolsdeep_researchГлубокое исследование / Deep researchARead-onlyInspect
Проводит многошаговое исследование: сам формулирует запросы, ищет, читает источники и возвращает готовый связный ответ со ссылками на использованные страницы.
Когда: вопрос требует сопоставления нескольких источников и вывода — «сравни», «разберись», «что известно о». Когда не: нужен один факт или список ссылок — это web_search, он в 20 раз дешевле и отвечает за секунды. Возвращает: текст ответа плюс список источников. Если источники не вернулись, в ответе будет предупреждение — такой вывод не считается проверенным. Время: 10 с – 2 мин, это самый медленный инструмент. Держите соединение открытым. Цена: 20 кредитов плюс 3 за каждую 1000 токенов ответа — самый дорогой вызов. Повтор темы даёт новый результат и списывается заново.
Runs multi-step research: forms its own queries, searches, reads sources and returns a finished answer with links to the pages it used.
Use when: the question needs several sources reconciled into a conclusion — "compare", "analyse", "what is known about". Do not use when: you need a single fact or a list of links — that is web_search, 20× cheaper and seconds fast. Returns: the answer text plus a source list. If no sources came back the response says so — treat that output as unverified. Time: 10 s – 2 min, the slowest tool here. Keep the connection open. Cost: 20 credits plus 3 per 1000 output tokens — the most expensive call. Repeating a topic produces a new result and is billed again.
Inputs: query (required).
extractИзвлечь данные по схеме / Extract data by schemaARead-onlyIdempotentInspect
Читает страницу и возвращает JSON строго по вашей схеме: только запрошенные поля, без текста страницы. Чего на странице нет — приходит null, значения не домысливаются.
Когда: нужны 2–5 конкретных значений — цена, характеристики, автор и дата, список вакансий. Экономит контекст: вместо всей страницы придут только поля. Когда не: нужен связный текст или вы не знаете заранее, что искать, — read_url (и в 4 раза дешевле). Схема: принимается и сокращённая форма — {"title":"string","price":"number?"}, где «?» делает поле необязательным, а «[]» — массивом; полный JSON Schema тоже работает. Описания полей заметно повышают точность разбора. Возвращает: объект по схеме на каждую ссылку. Можно передать до 5 ссылок разом — одна схема применится ко всем. Цена: 4 кредита за каждую ссылку (чтение плюс разбор моделью).
Reads a page and returns JSON strictly following your schema: only the requested fields, no page text. Anything absent from the page comes back as null — values are never invented.
Use when: you need a handful of specific values — price, specs, author and date, a list of job openings. It saves context: you get the fields, not the page. Do not use when: you need prose, or you do not know in advance what to look for — read_url (and 4× cheaper). Schema: a shorthand form is accepted — {"title":"string","price":"number?"}, where "?" marks a field optional and "[]" an array; full JSON Schema works too. Field descriptions noticeably improve extraction accuracy. Returns: one object per link, shaped by your schema. Up to 5 links per call, one schema applied to all. Cost: 4 credits per link (page read plus model parsing).
Inputs: url, urls, engine, schema, +1 more.
fetch_pageСкриншот и структура страницы / Page screenshot and structureARead-onlyIdempotentInspect
Открывает страницу полноценным браузером и возвращает скриншот картинкой прямо в ответе, ссылку на полноразмерный файл и текст страницы в markdown.
Когда: нужно УВИДЕТЬ страницу — раскладку, цвета, типографику, визуальную иерархию: «повтори дизайн как здесь», «что не так с вёрсткой». Когда не: нужен только текст — read_url (1 кредит против 3, и быстрее); нужны отдельные значения — extract. Возвращает: изображение плюс текст. Картинка занимает много контекста, поэтому для чтения этот инструмент избыточен. Цена: 3 кредита.
Opens the page in a full browser and returns a screenshot as an inline image, a link to the full-size file, and the page text in markdown.
Use when: you need to SEE the page — layout, colours, typography, visual hierarchy: "match this design", "what looks broken here". Do not use when: you only need text — read_url (1 credit vs 3, and faster); you need specific values — extract. Returns: an image plus text. The image consumes a lot of context, which makes this tool overkill for reading. Cost: 3 credits.
Inputs: url (required), maxChars.
get_usageБаланс и лимиты / Balance and limitsARead-onlyIdempotentInspect
Показывает остаток на счёте, расход суточной квоты, время сброса окна и цены всех инструментов в кредитах. Параметров не требует.
Когда: вызов упал с [rate_limited] и надо понять, ждать секунды или до следующих суток; пользователь спрашивает про баланс и расходы; планируется большой батч и надо убедиться, что кредитов хватит. Возвращает: баланс, использованную квоту, момент сброса и прайс-лист. Цена: бесплатно, квоту и лимит запросов этот вызов не расходует — его можно звать без опасений.
Shows the remaining balance, daily quota usage, when the window resets, and the price of every tool in credits. Takes no parameters.
Use when: a call failed with [rate_limited] and you need to know whether to wait seconds or until tomorrow; the user asks about balance or spending; you are about to run a large batch and want to confirm you have the credits. Returns: balance, quota used, reset time and the price list. Cost: free — this call consumes neither quota nor rate limit, so call it freely.
Inputs: no named parameters.
image_searchПоиск изображений / Image searchARead-onlyInspect
Ищет изображения по текстовому запросу и возвращает прямые ссылки на файлы, страницу-источник и разрешение.
Когда: нужны картинки, фотографии, логотипы, схемы. Когда не: нужен текст или факты — web_search; нужно увидеть, как выглядит конкретная страница, — fetch_page. Возвращает: только ссылки и метаданные — файлы не скачиваются и в ответе не появляются. Ставьте num: 1–3, если картинка нужна одна: по умолчанию 12, максимум 48, и полный список занимает десятки килобайт контекста. Цена: 1 кредит за вызов, независимо от num.
Searches for images by a text query and returns direct file links, the source page and resolution.
Use when: you need pictures, photos, logos or diagrams. Do not use when: you need text or facts — web_search; you need to see what a specific page looks like — fetch_page. Returns: links and metadata only — files are never downloaded or embedded in the response. Pass num: 1–3 when you need a single image: the default is 12, the maximum 48, and a full list costs tens of kilobytes of context. Cost: 1 credit per call regardless of num.
Inputs: query (required), num, safe, timeRange.
read_urlПрочитать страницу / Read a pageARead-onlyIdempotentInspect
Открывает одну страницу по известному адресу и возвращает её текст чистым markdown — без навигации, рекламы, скриптов и HTML. JavaScript выполняется на нашей стороне, поэтому SPA тоже читаются.
Когда: адрес известен и нужен текст — статья, документация, карточка товара. Когда не: адреса нет — сначала web_search; страниц несколько — read_urls (один вызов вместо пяти); нужны 2–5 конкретных полей — extract (в контекст придут только они); нужно увидеть вёрстку — fetch_page. Возвращает: заголовок и текст, по умолчанию первые 4000 символов. Если нужен весь текст, а не начало, поднимите maxChars — иначе документ придёт обрезанным. Цена: 1 кредит, самый дешёвый способ получить содержимое страницы (fetch_page — 3).
Opens a single page by a known URL and returns its text as clean markdown — no navigation, ads, scripts or HTML. JavaScript is executed on our side, so SPAs read fine too.
Use when: you have the URL and need the text — an article, documentation, a product page. Do not use when: you have no URL — start with web_search; you have several pages — read_urls (one call instead of five); you need a handful of specific fields — extract (only those reach your context); you need to see the layout — fetch_page. Returns: title and text, the first 4000 characters by default. Raise maxChars when you need the whole document, otherwise it arrives truncated. Cost: 1 credit — the cheapest way to get page content (fetch_page costs 3).
Inputs: url (required), engine, maxChars.
read_urlsПрочитать несколько страниц / Read several pagesARead-onlyIdempotentInspect
Читает пачку страниц (до 5 за вызов) параллельно и возвращает текст каждой чистым markdown. То же, что read_url, но одним вызовом вместо нескольких — заметно быстрее по общему времени.
Когда: на руках список ссылок, например топ выдачи web_search. Когда не: страница одна — read_url; нужны отдельные поля, а не текст, — extract (он тоже принимает список). Возвращает: текст по каждой странице. Частичный успех — норма: упавшие ссылки не рвут вызов, а перечисляются отдельным блоком «Не прочитано» с кодом ошибки. Дубликаты и ссылки сверх лимита отбрасываются, их число указано в ответе. Цена: 1 кредит за каждую ссылку — пять страниц стоят пять кредитов. Не отправляйте ссылки «на всякий случай».
Reads a batch of pages (up to 5 per call) in parallel and returns each one's text as clean markdown. Same as read_url but in a single call — markedly faster in total wall-clock.
Use when: you have a list of links, e.g. the top web_search results. Do not use when: there is only one page — read_url; you need specific fields rather than text — extract (it also accepts a list). Returns: text per page. Partial success is normal: failed links do not fail the call, they are listed in a separate "not read" block with an error code. Duplicates and links beyond the limit are dropped and the count is reported. Cost: 1 credit per link — five pages cost five credits. Do not pad the list.
Inputs: urls (required), engine, maxChars.
web_searchВеб-поиск / Web searchARead-onlyInspect
Ищет страницы в живом вебе по текстовому запросу и возвращает ранжированный список: заголовок, ссылка, фрагмент. Сильное покрытие русскоязычного веба.
Когда: нужны свежие факты, ссылки или данные новее вашей отсечки знаний. Когда не: адрес страницы уже известен — это read_url; нужны 2–5 конкретных значений — extract; нужен готовый разбор темы со сносками — deep_research. Возвращает: до 30 результатов текстом, без содержимого страниц. С excerpts: true добавляет реальный текст топ-страниц (+2–4 с), это часто экономит последующий вызов read_url. Цена: 1 кредит за вызов, независимо от num. Выдача живая, поэтому повтор того же запроса даёт другой результат и списывается снова.
Searches the live web by a text query and returns ranked results: title, link, snippet. Strong coverage of the Russian-language web.
Use when: you need fresh facts, links or data past your knowledge cutoff. Do not use when: you already know the page URL — that is read_url; you need a handful of specific values — extract; you need a written answer across many sources — deep_research. Returns: up to 30 results as text, without page content. With excerpts: true it also pulls the actual text of the top pages (+2–4 s), which often saves a follow-up read_url. Cost: 1 credit per call regardless of num. Results are live, so repeating the same query returns different results and is billed again.
Inputs: query (required), num, depth, category, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose: deep_research for synthesized multi-source answers, web_search for ranked results, image_search for images, read_url for single-page text, read_urls for batch reading, fetch_page for visual screenshots, extract for structured data, and get_usage for account info. No two tools overlap in a way that would confuse an agent.
Most tools follow a verb_noun snake_case pattern (web_search, read_url, read_urls, fetch_page, get_usage), but 'deep_research' is an adjective_noun compound and 'extract' is a bare verb. This is a minor deviation from an otherwise consistent and predictable convention.
With 8 tools, the server is well-scoped for its stated purpose of web research and data extraction. Each tool earns its place, covering search, reading, extraction, and account management without any redundant or bloated additions.
The tool surface covers the full research workflow: discovering sources (web_search, image_search), deep investigation (deep_research), reading content (read_url, read_urls, fetch_page), structured extraction (extract), and operational monitoring (get_usage). There are no obvious gaps within the domain.
Maintenance
Related MCP Connectors
Web search API and MCP server for developers building AI agents.
Free web search for AI agents. No API key required. Hosted MCP in active development.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP tool server that gives any AI agent the ability to search, scrape, and analyze content across the internet.42MIT
- AlicenseBqualityDmaintenanceMCP server providing search, extract, map, and crawl tools powered by Tavily for real-time web data access.410 npmMIT
- FlicenseNot gradedqualityDmaintenanceMCP server that enables AI agents to search the web and extract clean Markdown content, with support for JavaScript rendering, structured data extraction, and screenshots.2-
- AlicenseAqualityCmaintenanceMCP server that exposes SearXNG search and HTTP fetch tools for AI agents, enabling web search and clean page text extraction via natural language.4MIT