web_search

Поиск актуальной информации в интернете. Возвращает список результатов (заголовок, ссылка, фрагмент) из нескольких источников. Используй, когда нужны свежие данные, факты или ссылки по теме. Не читает страницы целиком — для этого read_url. / Searches the web for current information. Returns a list of results (title, link, snippet) from several engines. Use it when you need fresh data, facts or links on a topic. It does not read full pages — use read_url for that.

Parameters9

query	string	required	Поисковый запрос / Search query
category	string	optional	Категория / Category: general, news, it, science
timeRange	string	optional	Свежесть / Recency: '', day, week, month, year
language	string	optional	Язык / Language: auto, ru, en
num	integer	optional	Сколько результатов (1–30) / How many results (1–30)
depth	string	optional	Глубина: auto (по умолчанию, больше движков и результатов) или flash (быстрее, узкая выдача — для одного факта). / Depth: auto (default, more engines and results) or flash (faster, narrow — for a single fact).
excerpts	boolean	optional	Забрать реальный текст топ-страниц под запрос (медленнее на пару секунд, но даёт готовый контент для ответа без доп. переходов). По умолчанию выкл. / Pull the actual text of the top pages for this query (a couple of seconds slower, but gives ready content without extra calls). Off by default.
includeDomains	array	optional	Искать только на этих сайтах, вместе с поддоменами: ["habr.com", "vc.ru"]. До 10 доменов. / Search only these sites, including subdomains. Up to 10 domains.
excludeDomains	array	optional	Исключить эти сайты и их поддомены: ["pinterest.com"]. До 10 доменов. / Exclude these sites and their subdomains. Up to 10 domains.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "Поисковый запрос / Search query"
    },
    "category": {
      "type": "string",
      "enum": [
        "general",
        "news",
        "it",
        "science"
      ],
      "description": "Категория / Category: general, news, it, science"
    },
    "timeRange": {
      "type": "string",
      "enum": [
        "",
        "day",
        "week",
        "month",
        "year"
      ],
      "description": "Свежесть / Recency: '', day, week, month, year"
    },
    "language": {
      "type": "string",
      "enum": [
        "auto",
        "ru",
        "en"
      ],
      "description": "Язык / Language: auto, ru, en"
    },
    "num": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Сколько результатов (1–30) / How many results (1–30)"
    },
    "depth": {
      "type": "string",
      "enum": [
        "flash",
        "auto"
      ],
      "description": "Глубина: auto (по умолчанию, больше движков и результатов) или flash (быстрее, узкая выдача — для одного факта). / Depth: auto (default, more engines and results) or flash (faster, narrow — for a single fact)."
    },
    "excerpts": {
      "type": "boolean",
      "description": "Забрать реальный текст топ-страниц под запрос (медленнее на пару секунд, но даёт готовый контент для ответа без доп. переходов). По умолчанию выкл. / Pull the actual text of the top pages for this query (a couple of seconds slower, but gives ready content without extra calls). Off by default."
    },
    "includeDomains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "description": "Искать только на этих сайтах, вместе с поддоменами: [\"habr.com\", \"vc.ru\"]. До 10 доменов. / Search only these sites, including subdomains. Up to 10 domains."
    },
    "excludeDomains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "description": "Исключить эти сайты и их поддомены: [\"pinterest.com\"]. До 10 доменов. / Exclude these sites and their subdomains. Up to 10 domains."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

image_search

Поиск изображений в интернете по текстовому запросу. Возвращает список картинок с прямыми ссылками, источником и разрешением. Сами картинки не скачивает и не показывает — только ссылки. / Searches the web for images by a text query. Returns a list of images with direct links, source page and resolution. It does not download or display the images — links only.

Parameters4

query	string	required	Что искать / What to search for
num	integer	optional	Сколько картинок вернуть (1–48, по умолчанию 12). Нужна одна картинка — просите 1–3, не тратьте контекст. / How many images to return (1–48, default 12). Need just one — ask for 1–3 and save context.
timeRange	string	optional	Свежесть / Recency: '', day, week, month, year
safe	boolean	optional	Безопасный поиск / Safe search (on by default)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "Что искать / What to search for"
    },
    "num": {
      "type": "integer",
      "minimum": 1,
      "maximum": 48,
      "description": "Сколько картинок вернуть (1–48, по умолчанию 12). Нужна одна картинка — просите 1–3, не тратьте контекст. / How many images to return (1–48, default 12). Need just one — ask for 1–3 and save context."
    },
    "timeRange": {
      "type": "string",
      "enum": [
        "",
        "day",
        "week",
        "month",
        "year"
      ],
      "description": "Свежесть / Recency: '', day, week, month, year"
    },
    "safe": {
      "type": "boolean",
      "description": "Безопасный поиск / Safe search (on by default)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

deep_research

Запускает агентное исследование по запросу: ищет в вебе, читает источники и возвращает связный ответ со ссылками. Занимает от 10 секунд до 2 минут — используй для сложных аналитических вопросов, а не для быстрых фактов. / Runs an agentic research task: searches the web, reads sources and returns a coherent answer with links. Takes 10 seconds to 2 minutes — use it for complex analytical questions, not for quick facts.

Parameters1

query

string

required

Вопрос или тема исследования / The question or research topic

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Вопрос или тема исследования / The question or research topic"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_url

Открывает страницу и возвращает её текст в чистом markdown — без навигации, рекламы и HTML. Используй, когда нужно ПРОЧИТАТЬ конкретную страницу по известной ссылке: статью, документацию, карточку товара. Дешевле и быстрее fetch_page, потому что не делает скриншот; если нужно именно УВИДЕТЬ вёрстку и дизайн — бери fetch_page. / Opens a page and returns its text as clean markdown — no navigation, ads or HTML. Use it when you need to READ a specific page by a known link: an article, documentation, a product page. Cheaper and faster than fetch_page because it takes no screenshot; if you need to SEE the layout and design, use fetch_page instead.

Parameters3

url	string	required	Полный URL страницы (http/https) / Full page URL
maxChars	integer	optional	Сколько символов текста вернуть (200–50000, по умолчанию 4000). Поднимите, если нужен полный текст, а не только начало. / How many characters of text to return (200–50000, default 4000). Raise it if you need the whole text, not just the beginning.
engine	string	optional	Как забирать страницу: auto (по умолчанию — начинает с быстрого способа и сам поднимается, если текста не оказалось), fast (быстро, для статики и документации), dynamic (ждёт отрисовки JS — для SPA), stealth (медленно, максимально браузерное поведение). Указывайте явно только если знаете сайт. / How to fetch the page: auto (default — starts with the fast path and escalates on its own if no text came back), fast (static sites and docs), dynamic (waits for JS rendering — for SPAs), stealth (slow, most browser-like). Set it explicitly only if you know the site.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Полный URL страницы (http/https) / Full page URL"
    },
    "maxChars": {
      "type": "integer",
      "minimum": 200,
      "maximum": 50000,
      "description": "Сколько символов текста вернуть (200–50000, по умолчанию 4000). Поднимите, если нужен полный текст, а не только начало. / How many characters of text to return (200–50000, default 4000). Raise it if you need the whole text, not just the beginning."
    },
    "engine": {
      "type": "string",
      "enum": [
        "auto",
        "fast",
        "dynamic",
        "stealth"
      ],
      "description": "Как забирать страницу: auto (по умолчанию — начинает с быстрого способа и сам поднимается, если текста не оказалось), fast (быстро, для статики и документации), dynamic (ждёт отрисовки JS — для SPA), stealth (медленно, максимально браузерное поведение). Указывайте явно только если знаете сайт. / How to fetch the page: auto (default — starts with the fast path and escalates on its own if no text came back), fast (static sites and docs), dynamic (waits for JS rendering — for SPAs), stealth (slow, most browser-like). Set it explicitly only if you know the site."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_urls

Читает сразу несколько страниц (до 5) и возвращает текст каждой в чистом markdown. Используй, когда нужно прочитать пачку ссылок — например топ результатов поиска: это один вызов вместо пяти. Страницы читаются параллельно; если какая-то не открылась, остальные всё равно вернутся, а неудачные перечислены в конце ответа. Каждая страница тарифицируется как отдельное чтение. / Reads several pages at once (up to 5) and returns each one's text as clean markdown. Use it when you need a batch of links — the top search results, say: one call instead of five. Pages are read in parallel; if one fails the rest still come back, and the failures are listed at the end of the response. Each page is billed as a separate read.

Parameters3

urls	array	required	Список URL (1–5). Дубликаты отбрасываются. / A list of URLs (1–5). Duplicates are dropped.
maxChars	integer	optional	Сколько символов текста вернуть с КАЖДОЙ страницы (200–50000, по умолчанию 4000). На батче ставьте скромнее: пять больших страниц вытеснят из контекста всё остальное. / How many characters to return from EACH page (200–50000, default 4000). Keep it modest on a batch: five large pages will crowd everything else out of your context.
engine	string	optional	Как забирать страницы: auto (по умолчанию), fast, dynamic, stealth. Применяется ко всем ссылкам батча. / How to fetch the pages: auto (default), fast, dynamic, stealth. Applies to every link in the batch.

Raw schema

{
  "type": "object",
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "minItems": 1,
      "maxItems": 5,
      "description": "Список URL (1–5). Дубликаты отбрасываются. / A list of URLs (1–5). Duplicates are dropped."
    },
    "maxChars": {
      "type": "integer",
      "minimum": 200,
      "maximum": 50000,
      "description": "Сколько символов текста вернуть с КАЖДОЙ страницы (200–50000, по умолчанию 4000). На батче ставьте скромнее: пять больших страниц вытеснят из контекста всё остальное. / How many characters to return from EACH page (200–50000, default 4000). Keep it modest on a batch: five large pages will crowd everything else out of your context."
    },
    "engine": {
      "type": "string",
      "enum": [
        "auto",
        "fast",
        "dynamic",
        "stealth"
      ],
      "description": "Как забирать страницы: auto (по умолчанию), fast, dynamic, stealth. Применяется ко всем ссылкам батча. / How to fetch the pages: auto (default), fast, dynamic, stealth. Applies to every link in the batch."
    }
  },
  "required": [
    "urls"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetch_page

Открывает страницу в реальном браузере и возвращает её скриншот (картинкой), ссылку на полноразмерный скриншот и текст страницы в markdown. Используй, когда нужно УВИДЕТЬ страницу — раскладку, цвета, типографику, визуальную иерархию (например «повтори дизайн как на этом сайте»), а не просто найти информацию. Стоит 3 кредита — если нужен только текст, дешевле read_url (1 кредит). / Opens the page in a real browser and returns its screenshot (as an image), a link to the full-size screenshot and the page text in markdown. Use it when you need to SEE the page — layout, colours, typography, visual hierarchy (e.g. «copy the design of this site») — not just find information. Costs 3 credits; if you only need the text, read_url is cheaper (1 credit).

Parameters2

url	string	required	Полный URL страницы (http/https) / Full page URL (http/https)
maxChars	integer	optional	Сколько символов текста вернуть (200–50000, по умолчанию 4000). Поднимите, если нужен полный текст страницы, а не только начало. / How many characters of text to return (200–50000, default 4000). Raise it if you need the whole page text, not just the beginning.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Полный URL страницы (http/https) / Full page URL (http/https)"
    },
    "maxChars": {
      "type": "integer",
      "minimum": 200,
      "maximum": 50000,
      "description": "Сколько символов текста вернуть (200–50000, по умолчанию 4000). Поднимите, если нужен полный текст страницы, а не только начало. / How many characters of text to return (200–50000, default 4000). Raise it if you need the whole page text, not just the beginning."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

extract

Читает страницу и возвращает структурированные данные строго по вашей схеме: только запрошенные поля, без текста страницы. Используй, когда нужны КОНКРЕТНЫЕ значения (цена, характеристики, автор и дата, список вакансий), а не содержание целиком — это экономит контекст по сравнению с read_url. Чего на странице нет, приходит как null: значения не выдумываются. Можно передать до 5 ссылок сразу — одна схема применится ко всем. / Reads the page and returns structured data strictly following your schema: only the requested fields, no page text. Use it when you need SPECIFIC values (price, specs, author and date, a list of job openings) rather than the whole content — it saves context compared to read_url. Anything absent from the page comes back as null: values are never invented. You can pass up to 5 links at once — one schema applies to all of them.

Parameters5

url	string	optional	URL страницы (http/https) / Page URL (http/https)
urls	array	optional	Список URL (1–5) вместо url — одна схема на все страницы. Каждая страница тарифицируется отдельно. / A list of URLs (1–5) instead of url — one schema for all pages. Each page is billed separately.
schema	any	optional	Схема результата. Проще всего — сокращённая форма: {"title":"string","price":"number?","tags":"string[]"}, где «?» помечает поле необязательным, а «[]» — массивом. Полный JSON Schema тоже принимается: {"type":"object","properties":{"price":{"type":"number","description":"цена в рублях"}},"required":["price"]}. Типы: string, number, integer, boolean, array, object. Описания полей заметно повышают точность. / The result schema. The simplest form is shorthand: {"title":"string","price":"number?","tags":"string[]"}, where «?» marks the field optional and «[]» marks an array. Full JSON Schema is accepted too. Types: string, number, integer, boolean, array, object. Field descriptions noticeably improve accuracy.
instruction	string	optional	Уточнение для разбора, если из схемы неочевидно: «бери цену со скидкой», «только вакансии удалённо». / A parsing hint when the schema alone is ambiguous: «use the discounted price», «remote positions only».
engine	string	optional	Как забирать страницу: auto (по умолчанию), fast, dynamic, stealth. / How to fetch the page: auto (default), fast, dynamic, stealth.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "URL страницы (http/https) / Page URL (http/https)"
    },
    "urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "minItems": 1,
      "maxItems": 5,
      "description": "Список URL (1–5) вместо url — одна схема на все страницы. Каждая страница тарифицируется отдельно. / A list of URLs (1–5) instead of url — one schema for all pages. Each page is billed separately."
    },
    "schema": {
      "description": "Схема результата. Проще всего — сокращённая форма: {\"title\":\"string\",\"price\":\"number?\",\"tags\":\"string[]\"}, где «?» помечает поле необязательным, а «[]» — массивом. Полный JSON Schema тоже принимается: {\"type\":\"object\",\"properties\":{\"price\":{\"type\":\"number\",\"description\":\"цена в рублях\"}},\"required\":[\"price\"]}. Типы: string, number, integer, boolean, array, object. Описания полей заметно повышают точность. / The result schema. The simplest form is shorthand: {\"title\":\"string\",\"price\":\"number?\",\"tags\":\"string[]\"}, where «?» marks the field optional and «[]» marks an array. Full JSON Schema is accepted too. Types: string, number, integer, boolean, array, object. Field descriptions noticeably improve accuracy."
    },
    "instruction": {
      "type": "string",
      "maxLength": 1000,
      "description": "Уточнение для разбора, если из схемы неочевидно: «бери цену со скидкой», «только вакансии удалённо». / A parsing hint when the schema alone is ambiguous: «use the discounted price», «remote positions only»."
    },
    "engine": {
      "type": "string",
      "enum": [
        "auto",
        "fast",
        "dynamic",
        "stealth"
      ],
      "description": "Как забирать страницу: auto (по умолчанию), fast, dynamic, stealth. / How to fetch the page: auto (default), fast, dynamic, stealth."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_usage

Показывает остаток на счёте, расход суточной квоты и цены инструментов в кредитах. Вызывай, когда запрос упал по лимиту или квоте, когда пользователь спрашивает про баланс и расходы, или перед большим батчем запросов. Сам вызов бесплатный и лимит не расходует. / Shows the remaining balance, daily quota usage and tool prices in credits. Call it when a request failed on a limit or quota, when the user asks about balance and spending, or before a large batch of requests. This call is free and does not consume the limit.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

срезAI — Search API for AI agents

ru.srezai/search MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

web_search

image_search

deep_research

read_url

read_urls

fetch_page

extract

get_usage

Install

Remote endpoint