# срезAI — Поисковый API для ИИ-агентов

> Поисковый API для ИИ-агентов: живой веб-поиск по Рунету, рендер страниц браузером и чистый Markdown/JSON для RAG и LLM-пайплайнов. Единый REST API и MCP-сервер.

срезAI — REST API, MCP-сервер и официальные SDK для Python и JavaScript: живой веб-поиск, поиск изображений, чтение страниц (read_url, fetch_page), извлечение по схеме (extract), проверка утверждения по источникам (verify_claim) и многошаговое исследование (DeepResearch). Инфраструктура в РФ, оплата в рублях, глубокий поиск по Рунету. Ответы очищены до Markdown/JSON, готового для RAG и LLM-пайплайнов.

Набор рассчитан на модели с любым окном контекста, включая небольшие локальные (32–64k). Черновая работа идёт вне контекста модели: read_url отдаёт длинную страницу окнами по offset, extract возвращает только поля вашей схемы вместо всего текста, verify_claim переваривает 4–5 источников на нашей стороне и отдаёт вердикт с цитатами — сотни токенов вместо десятков тысяч.

- Сайт: https://srezai.ru
- Документация: https://srezai.ru/docs
- MCP-эндпоинт: https://srezai.ru/api/mcp
- Python SDK: https://pypi.org/project/srezai/ (pip install srezai)
- JavaScript SDK: https://www.npmjs.com/package/srezai (npm install srezai)
- Исходники SDK: https://github.com/srezai-team/srezai-sdk
- Исходники MCP-сервера: https://github.com/srezai-team/srezai-mcp (npx srezai-mcp)
- Зеркало MCP-сервера на GitVerse: https://gitverse.ru/a1_ai_a4b/srezai-mcp
- Цены и тарифы: https://srezai.ru/pricing
- Поддержка: https://srezai.ru/support (support@srezai.ru)

## Документация

### Начало работы
- [Введение](https://srezai.ru/docs): Обзор API: возможности, форматы ответа, с чего начать.
- [Быстрый старт](https://srezai.ru/docs/quickstart): Первый запрос за пару минут: ключ, установка SDK (pip install srezai / npm install srezai), первый вызов и разбор ответа. Есть пример на cURL.
- [Аутентификация](https://srezai.ru/docs/authentication): Bearer-ключи srz_live_*, заголовок Authorization, ротация.

### API
- [Веб-поиск](https://srezai.ru/docs/search): Веб-поиск: категории, фильтры, языки, фильтр по доменам (includeDomains / excludeDomains), чистый Markdown/JSON для LLM.
- [Поиск изображений](https://srezai.ru/docs/media): Поиск изображений с прямыми ссылками и метаданными; число картинок задаётся параметром num (1–48).
- [Чтение страницы](https://srezai.ru/docs/read): read_url / read_urls: текст страницы в чистом Markdown без скриншота, одна ссылка или батч до 5. Длинная страница читается окнами: параметр offset и meta.nextOffset в ответе, поэтому документ любого объёма доступен модели с окном 32k. Повторное чтение той же ссылки в течение 15 минут отдаётся из кеша (meta.cached) — быстрее, цена та же.
- [Скриншот страницы](https://srezai.ru/docs/fetch): fetch_page: рендер страницы в браузере, Markdown + скриншот.
- [Извлечение по схеме](https://srezai.ru/docs/extract): extract: страница + схема → готовый объект с нужными полями, без текста страницы. Схема принимается сокращённо ({"title":"string"}) и полным JSON Schema. До 5 ссылок за вызов, ненайденное приходит как null.
- [Проверка утверждения](https://srezai.ru/docs/verify): verify_claim: проверка утверждения по источникам. На входе одно утверждение, на выходе вердикт (supported / refuted / mixed / unverified), уверенность и дословные цитаты с указанием домена. Источники находим и читаем сами (2–5 независимых доменов); каждая цитата сверяется с текстом страницы, не найденная отбрасывается вместе с доводом. mixed и unverified — нормальный результат, а не ошибка.
- [DeepResearch](https://srezai.ru/docs/deep-research): DeepResearch: многошаговое исследование с источниками.

### Справочник
- [Лимиты и квоты](https://srezai.ru/docs/rate-limits): Лимиты, квоты и заголовки rate-limit.
- [Ошибки](https://srezai.ru/docs/errors): Машинные коды ошибок (bad_request, rate_limited, search_unavailable и др.), HTTP-статусы и что повторять, а что исправлять.
- [MCP-сервер](https://srezai.ru/docs/mcp): MCP-сервер: подключение из Cursor, Claude, ChatGPT и Codex; инструменты web_search, image_search, read_url, read_urls, fetch_page, extract, verify_claim, deep_research, get_usage.

## SDK

Официальные клиенты, лицензия MIT. Ключ читается из аргумента apiKey или переменной окружения SREZAI_API_KEY. Семь методов: search, image_search, read_url, read_urls, fetch_page, extract, deep_research (в JavaScript — camelCase: imageSearch, readUrl, readUrls, fetchPage, deepResearch). Проверка утверждения (verify_claim) пока доступна только через REST POST /api/v1/verify и MCP — метода в SDK для неё нет. Инструмент get_usage доступен только через MCP-сервер: REST-эндпоинта и метода в SDK для него нет. Клиент сам повторяет запрос при rate_limited, service_unavailable, search_unavailable и upstream_timeout; на каждый код ошибки поднимается свой класс исключения с общим базовым SrezAIError.

Python:

```python
# pip install srezai
from srezai import SrezAI

client = SrezAI()  # или SrezAI(api_key="srz_live_...")

res = client.search("новости ИИ", language="ru", num=5)
for item in res["results"]:
    print(item["title"], item["url"])
```

JavaScript / TypeScript:

```javascript
// npm install srezai
import { SrezAI } from "srezai";

const client = new SrezAI();

const { results } = await client.search("новости ИИ", { language: "ru", num: 5 });
for (const item of results) console.log(item.title, item.url);
```

## Интеграции с ИИ-агентами

- [Cursor](https://srezai.ru/integrations/cursor): Чтобы дать агенту в Cursor доступ к интернету, добавьте MCP-сервер срезAI в ~/.cursor/mcp.json и перезапустите редактор: инструменты веб-поиска, чтения страниц и проверки утверждений появятся у агента без написания кода.
- [Claude Code](https://srezai.ru/integrations/claude-code): Веб-поиск в Claude Code и Claude Desktop подключается одним блоком mcpServers в claude_desktop_config.json: адрес https://srezai.ru/api/mcp и Bearer-ключ. Инструменты появятся у агента после перезапуска клиента.
- [n8n](https://srezai.ru/integrations/n8n): Чтобы подключить веб-поиск к агенту в n8n, добавьте ноду MCP Client Tool с типом HTTP Streamable, адресом https://srezai.ru/api/mcp и Bearer-аутентификацией — парсить HTML самостоятельно больше не нужно.
- [Codex CLI](https://srezai.ru/integrations/codex): Веб-поиск в Codex CLI включается секцией [mcp_servers.srezai] в ~/.codex/config.toml: адрес https://srezai.ru/api/mcp и имя переменной окружения с ключом. Ключ в файл прописывать не нужно.
- [Cline и Roo Code](https://srezai.ru/integrations/cline): Cline и Roo Code используют совместимый формат mcpServers: добавьте сервер срезAI с адресом https://srezai.ru/api/mcp и Bearer-ключом через иконку MCP Servers или в cline_mcp_settings.json.
- [Antigravity](https://srezai.ru/integrations/antigravity): В Antigravity адрес MCP-сервера указывается в поле serverUrl, а не url: с ключом url сервер молча не подключится. Файл открывается через Settings → Customizations → Open MCP Config.
- [Qwen Code](https://srezai.ru/integrations/qwen-code): В Qwen Code адрес MCP-сервера указывается в поле httpUrl файла ~/.qwen/settings.json — поле url в этом клиенте означает SSE и для нашего сервера не подходит.
- [Kimi CLI](https://srezai.ru/integrations/kimi-cli): В Kimi CLI веб-поиск подключается командой kimi mcp add --transport http с адресом https://srezai.ru/api/mcp и заголовком Authorization, либо вручную через ~/.kimi/mcp.json.
- [ZCode](https://srezai.ru/integrations/zcode): В ZCode удалённый MCP-сервер добавляется через Settings → MCP Servers → New MCP Server с типом HTTP: режим Form предназначен только для stdio и для нашего сервера не подойдёт.
- [DeepSeek](https://srezai.ru/integrations/deepseek): Чтобы дать DeepSeek доступ к вебу, добавьте MCP-сервер срезAI в блок mcpServers того клиента, где выбрана модель DeepSeek, либо вызывайте REST API напрямую из своего кода.
- [Trae](https://srezai.ru/integrations/trae): В Trae MCP-сервер добавляется через настройки → MCP → Add manually вставкой JSON с адресом https://srezai.ru/api/mcp и заголовком Authorization.
- [Qoder](https://srezai.ru/integrations/qoder): В Qoder адрес MCP-сервера вводится в то же поле, что и SSE — транспорт клиент определяет сам. MCP работает только в режиме Agent, лимит — десять серверов.
- [MiMo Code](https://srezai.ru/integrations/mimo-code): В MiMo Code ключ верхнего уровня называется mcp, а не mcpServers, тип сервера — remote, и обязателен параметр oauth: false: иначе клиент уйдёт в OAuth-флоу и проигнорирует Bearer-ключ.
- [OpenClaw](https://srezai.ru/integrations/openclaw): В OpenClaw сервер добавляется в блок mcpServers файла openclaw.json или командой openclaw mcp add — с адресом https://srezai.ru/api/mcp и Bearer-ключом.
- [Hermes](https://srezai.ru/integrations/hermes): В Hermes сервер описывается в секции mcp_servers файла ~/.hermes/config.yaml с типом streamable-http, адресом https://srezai.ru/api/mcp и заголовком Authorization.

## Сравнения

- [срезAI vs Tavily: поисковый API для ИИ-агентов в России](https://srezai.ru/compare/tavily): срезAI — прямой аналог Tavily для российского рынка: тот же формат «поиск → чистый контекст для LLM», но с оплатой в рублях, данными в РФ и поиском по Рунету, тогда как Tavily ориентирован на англоязычный веб и оплату в USD.
- [срезAI vs Exa (Metaphor): семантический поиск для LLM в РФ](https://srezai.ru/compare/exa): срезAI — российский аналог Exa: живой веб-поиск с выдачей чистого контекста для LLM, но с оплатой в рублях, инфраструктурой в РФ и поиском по Рунету, тогда как Exa заточен под англоязычные источники.
- [срезAI vs Serper: SERP и веб-поиск API для ИИ в России](https://srezai.ru/compare/serper): срезAI отличается от Serper тем, что отдаёт не сырой SERP, а готовый к LLM контекст (Markdown/JSON), работает на инфраструктуре в РФ, принимает оплату в рублях и глубоко ищет по Рунету.
- [срезAI vs Yandex Search API: поиск для ИИ-агентов](https://srezai.ru/compare/yandex-search-api): срезAI отличается от Яндекс Search API тем, что заточен под LLM-пайплайны: отдаёт готовый Markdown/JSON вместо XML-выдачи, имеет MCP-сервер и DeepResearch, а стоимость запроса ниже.

## Статьи

- [Exa Instant vs срезAI: кто быстрее доставляет данные для AI?](https://srezai.ru/blog/exa-instant-vs-srezai-2026-latency-benchmark): Сравнение Exa Instant (<200мс) и срезAI (0,10₽) по скорости, цене и качеству в Рунете. Узнайте, какое поисковое API выбрать для вашего ИИ-агента в 2026 году.
- [Agentic RAG и проблема бесконечного цикла: как 'Search Budget' экономит токены](https://srezai.ru/blog/agentic-rag-search-budget-optimization): Узнайте, как оптимизировать Agentic RAG с помощью лимитов поиска (Search Budget). Экономьте токены и время, избегая бесконечных циклов поиска для ИИ-агентов.
- [n8n 2.37.0: Подключаем срезAI через MCP для автономных агентов](https://srezai.ru/blog/n8n-2-37-0-mcp-integration-for-ai-agents): Пошаговый туториал по интеграции срезAI в n8n 2.37.0 через MCP. Настраиваем поисковые инструменты для AI-агентов и автоматизируем работу с данными из Рунета.
- [Tavily vs срезAI: качество поиска в Рунете 2026](https://srezai.ru/blog/tavily-vs-srezai-2026-language-boost): Сравниваем Tavily с обновлением Language Boost и срезAI. Анализ цен, поддержки русского языка и работы с динамическим контентом.
- [n8n + MCP: Подключаем 500+ инструментов к ИИ-агенту через срезAI](https://srezai.ru/blog/n8n-mcp-srezai-tutorial): Пошаговый гайд по интеграции n8n-MCP сервера и срезAI. Настройте Claude Desktop или LangChain для выполнения сложных сценариев автоматизации.
- [Как подключить срезAI к Claude Code через MCP: пошаговый гайд](https://srezai.ru/blog/claude-code-mcp-srezai-integration): Настройте MCP-сервер срезAI для Claude Code за 5 минут. Инструкция по установке, командам и использованию поиска в реальном времени для ИИ-агентов.
- [Search Index 2026: Кто лидирует в бенчмарке поисковых API для ИИ-агентов?](https://srezai.ru/blog/search-index-2026-kto-pobedil-v-pervom-nezavisimom-benchmarke-poiskovyh-api): Artificial Analysis опубликовал первый независимый бенчмарк Search Index 2026. Сравниваем лидеров: Parallel, Exa, Firecrawl, You.com и срезAI по качеству, скорости и стоимости.
- [Tavily vs Exa vs срезAI: какой поисковый API выбрать в 2026 году?](https://srezai.ru/blog/tavily-vs-exa-vs-srezai-2026): Сравниваем Tavily, Exa и срезAI по цене, функциям, качеству поиска по Рунету и интеграциям. Таблица, расчёты стоимости, рекомендации для AI-агентов.
- [Tavily vs срезAI: кто лидирует в бенчмарках SealQA и SimpleQA 2026?](https://srezai.ru/blog/tavily-vs-srezai-sealqa-simpleqa-2026): Сравниваем Tavily и срезAI по результатам бенчмарков SealQA и SimpleQA 2026. Кто лучше справляется с фактической точностью и сложными запросами?
- [Как дать агенту в n8n доступ к вебу: нода MCP Client за 10 минут](https://srezai.ru/blog/n8n-mcp-client-dostup-k-vebu-dlya-agenta): Пошаговая настройка ноды MCP Client Tool в n8n: подключаем к ИИ-агенту веб-поиск, чтение страниц и извлечение данных. Разбираем ошибку «Authentication failed» и что она значит на самом деле.
- [Как подключить веб-поиск к ИИ-агенту: MCP и REST на практике](https://srezai.ru/blog/kak-podklyuchit-web-poisk-k-ii-agentu): Два способа дать агенту доступ к живому вебу: MCP-сервер и REST API. Разбираем, чем они отличаются, какой инструмент выбирать под задачу и как не сжечь контекст модели.

Все статьи: https://srezai.ru/blog

## Оплата, поддержка и документы

- [Цены и тарифы](https://srezai.ru/pricing): кредитная модель, 1 кредит = 0,10 ₽, калькулятор месячных расходов. Оплата банковскими картами РФ и через СБП.
- [Поддержка](https://srezai.ru/support): контакты (support@srezai.ru), время ответа, вопросы об оплате, возвратах и лимитах.
- [Пользовательское соглашение](https://srezai.ru/legal/terms): условия оказания услуг, порядок оплаты и возвратов, ограничения использования.
- [Политика конфиденциальности](https://srezai.ru/legal/privacy): состав обрабатываемых данных, сроки хранения, права пользователя.