Пилот — ограниченный круг подключений


api.atomno-mcp.ru/sudact

API судебной практики: поиск решений и полный текст

Судебная практика нужна юристам и юридическим сервисам постоянно: найти похожие дела, собрать позицию по статье, посмотреть, как суд трактовал условие договора. Разница с ручным поиском по сайтам судов в том, что здесь поиск и полный текст приходят программе, а не человеку, и их можно передать языковой модели для разбора.

Что означает статус. Пилот означает ограниченный круг подключений и договорные условия под сценарий, а не открытую регистрацию. При этом это единственный из пяти доступов, у которого в документации описаны и пути, и поля тела запроса.

Строка из нашего реестра серверов: Hosted: пилот (api.atomno-mcp.ru/sudact)

Запросить ключ Справочник REST MCP-сервер для агентов

Что умеет API поиска по судебной практике

Сервис даёт две операции. Первая — полнотекстовый поиск по опубликованным актам Верховного Суда РФ: передаётся строка запроса не короче трёх символов, а сузить выдачу можно инстанцией, статьёй закона, диапазоном дат и количеством результатов от 1 до 50. Сейчас в выдаче — практика двух коллегий Верховного Суда: экономической (споры компаний) и административной (дела главы 12 КоАП — например, 1 977 постановлений по статье 12.8 и 1 353 по статье 12.26). Это акты по жалобам и в порядке пересмотра, а не решения первой инстанции — мировых и районных судов. Вторая операция — получение полного текста акта по ссылке на карточку или по идентификатору дела из выдачи поиска; по каждому акту видно, применил суд норму или только упомянул её, с цитатой из текста.

У выгрузки текста есть отдельная возможность, которой обычно нет у бесплатных поисковиков по практике: уровень обезличивания. Он принимает три значения — не обезличивать, скрыть физических лиц, скрыть всех участников. Это важно, если тексты уходят в вашу собственную базу или в языковую модель. Тексты судебных актов размещаются в интернете в силу статьи 15 Федерального закона № 262-ФЗ, а персональные данные из них исключают сами суды. Доступ на этапе пилота: путь проверки живости открыт, поиск и выгрузка требуют ключа.

Что сервис отдаёт

У сервиса две операции по HTTP — полнотекстовый поиск и выгрузка полного текста акта. Подбора дел по стороне спора (по ИНН или имени) в нём нет.

Возможность	Что делает	Что подаётся	Что приходит
search_decisions	Поиск актов Верховного Суда РФ по тексту, статьям и датам (экономколлегия и дела КоАП).	query: str, court_type?: "vs", norms?: str, date_from?: str, date_to?: str	list[CourtDecision]
get_decision	Полный текст акта по идентификатору или ссылке; показывает, применил суд норму или только упомянул, с цитатой.	decision_id: str	CourtDecision { id, court, date, text, articles[], norm_application }

Поиск принимает строку не короче трёх символов и до 50 результатов за раз, по умолчанию 10.
Фильтры: инстанция, статья закона, диапазон дат; в выдаче — акты Верховного Суда РФ.
Полный текст запрашивается по ссылке на карточку либо по идентификатору дела из выдачи поиска.
Обезличивание задаётся при запросе текста: не применять, скрыть физических лиц, скрыть всех участников.

Адреса запросов

Метод	Путь	Ключ	Что делает
GET	/sudact/health	не нужен	Проверка живости и версия сервиса
POST	/sudact/v1/search	ключ в заголовке X-API-Key	Полнотекстовый поиск актов Верховного Суда РФ
POST	/sudact/v1/citation	ключ	Полный текст решения по ссылке или идентификатору дела

Поля тела запроса описаны в документации по REST-доступу. Для поиска: query — текст запроса от трёх символов; court_type — тип суда, сейчас наполнены акты Верховного Суда (vs), значения arbitr, soyu, ks зарезервированы под будущие источники; instance — инстанция суда; norms — фильтр по статье закона; date_from и date_to — диапазон дат; limit — от 1 до 50, по умолчанию 10. Для выгрузки текста: url — ссылка на карточку или case_id из выдачи; include_full_text — включить текст, по умолчанию да; anonymize_level — none, physical_persons или all_persons.

Общие правила обмена Хост api.atomno-mcp.ru, формат JSON, серверы в России. Ошибки приходят в JSON с полями error, message и message_ru.

Ключ доступа Заголовок Authorization: Bearer или X-API-Key — способ зависит от сервиса и указан в примерах.

Примеры запросов

Где под примером написано, что ответ настоящий, — он снят с боевого сервера и приведён как есть. Выдуманных ответов на этой странице нет.

Поиск дел по тексту

Пример приведён в документации по REST-доступу. Обратите внимание на способ передачи ключа: здесь это заголовок X-API-Key, а не привычная схема с Bearer — у разных сервисов линейки она отличается. Формат ответа поиска в открытой документации не описан, поэтому мы его не приводим.


        curl -X POST https://api.atomno-mcp.ru/sudact/v1/search \
  -H "X-API-Key: <ваш-ключ>" \
  -H "Content-Type: application/json" \
  -d '{"query": "управление в состоянии опьянения", "court_type": "vs", "limit": 10}'

curl -X POST https://api.atomno-mcp.ru/sudact/v1/search \
  -H "X-API-Key: <ваш-ключ>" \
  -H "Content-Type: application/json" \
  -d '{"query": "управление в состоянии опьянения", "court_type": "vs", "limit": 10}'

Правовое основание и источник данных

Публикация судебных актов — обязанность судов по федеральному закону, и объём открытых сведений определяем не мы.

Судебные акты Верховного Суда РФ Ведёт: Верховный Суд Российской Федерации

Федеральный закон от 22.12.2008 № 262-ФЗ, части 1 и 2 статьи 15: тексты судебных актов размещаются в интернете в полном объёме. Часть 3 той же статьи: персональные данные, кроме фамилий и инициалов участников, исключают из публикуемых текстов сами суды.

Мы не восстанавливаем данные, которые суд убрал из публикуемого текста, и не пытаемся определить участников по косвенным признакам. Своей трактовки судебного акта мы тоже не даём: ни о виновности, ни об исходе спора — читатель видит те же реквизиты и тот же текст, что опубликовал суд.

По каждому реестру — норма, которая делает сведения открытыми, перечень полей и то, чего мы сознательно не берём: источники данных и правовые основания . Первоисточник этого сервиса — Верховный Суд РФ (vsrf.ru) и наш архив актов . Atomno MCP не аффилирован с ним.

Чем это отличается от MCP-сервера

Данные одни и те же, отличается способ обращения. Обмен по HTTP разбирает ваш код, MCP-сервер — языковая модель внутри вашего продукта или редактора.

Берите обмен по HTTP, если

Поиск по практике встроен в ваш юридический сервис как функция интерфейса.
Нужно наполнить собственную базу решений по теме и обновлять её по расписанию.
Тексты уходят в вашу поисковую систему, а не в диалог с моделью.

Берите MCP-сервер, если

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

Для второго сценария полезно обезличивание при выгрузке текста: можно скрыть участников до того, как текст уйдёт в модель.

Страница mcp-sudact Когда нужен MCP, а когда обычный обмен

Чего пока нет

Мы предпочитаем назвать пробел, чем показать красивую страницу и подвести вас на этапе интеграции. Здесь и то, чего нет в документации, и то, что не работает в самом сервисе.

Формат ответа поиска и выгрузки текста в открытой документации не описан.
Способ передачи ключа отличается от других сервисов линейки: здесь заголовок X-API-Key.
Пока наполнены только акты Верховного Суда РФ (экономическая и административная коллегии). Судов общей юрисдикции, арбитража и Конституционного суда в выдаче сейчас нет.

Вопросы и ответы

Чем это отличается от бесплатного поиска на сайтах судов? +

Тем, что ответ приходит программе, а не человеку: его можно встроить в свой сервис, сохранить в базу или передать языковой модели для разбора. Плюс единый поиск по практике Верховного Суда с фильтрами по инстанции, статье и датам, и возможность обезличить текст при выгрузке.

Сколько результатов вернёт поиск? +

От одного до пятидесяти за запрос, по умолчанию десять — это указано в описании поля limit. Строка запроса должна быть не короче трёх символов. Сузить выдачу можно инстанцией, статьёй закона и диапазоном дат.

Можно ли скрыть персональные данные в выгруженном тексте? +

Да, для этого есть отдельное поле уровня обезличивания с тремя значениями: не применять, скрыть физических лиц, скрыть всех участников. Это полезно, когда текст уходит во внешнюю языковую модель или в вашу базу. Напомним: сами суды уже исключают персональные данные при публикации.

Что означает статус «пилот»? +

Ограниченный круг подключений и договорные условия под конкретный сценарий вместо открытой регистрации. Сервис при этом рабочий, и это единственный из пяти наших доступов, у которого в документации описаны и пути, и поля тела запроса. Формат ответа пока приходит вместе с ключом.

Арбитражные дела и суды общей юрисдикции доступны? +

Пока нет. Сейчас в выдаче — практика Верховного Суда РФ: экономическая коллегия и административная коллегия по делам главы 12 КоАП. Арбитраж, суды общей юрисдикции и Конституционный суд добавим отдельно, когда по ним будет живой ответ, и не обещаем их до этого.

Подключиться к пилоту по судебной практике

Опишите задачу: подбор практики в юридическом сервисе, наполнение собственной базы решений или разбор текстов моделью. Выдадим ключ, машинное описание интерфейса и обсудим объём и условия под ваш сценарий. Почта для писем: sales@atomno.com .

Запросить ключ

Ответ сервиса — сводка сведений из открытых государственных реестров на момент запроса, а не юридическое заключение. Недоступность источника мы не выдаём за отсутствие записей.