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


api.atomno-mcp.ru/sudact

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

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

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

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

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

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

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

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

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

В реестре наших серверов у сервиса три возможности, и они шире, чем два пути обмена по HTTP: помимо поиска и полного текста заявлен подбор дел по стороне спора — по идентификационному номеру или по имени.

Возможность	Что делает	Что подаётся	Что приходит
search_decisions	Поиск судебных решений по тексту/сторонам/статьям.	query: str, court_type?: "general"\|"arbitration"\|"vs"\|"ks", date_from?: str, date_to?: str	list[CourtDecision]
get_decision	Полный текст решения по идентификатору.	decision_id: str	CourtDecision { id, court, parties, date, text, articles[] }
get_party_cases	Дела стороны по ИНН/ФИО.	identifier: str	list[CourtDecision]

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

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

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

Поля тела запроса описаны в документации по REST-доступу. Для поиска: query — текст запроса от трёх символов; court_type — vs, arbitr, soyu, ks или any; 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": "arbitr", "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": "arbitr", "limit": 10}'

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

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

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

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

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

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

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

По каждому реестру — норма, которая делает сведения открытыми, перечень полей и то, чего мы сознательно не берём: источники данных и правовые основания . Первоисточник этого сервиса — sudact.ru / kad.arbitr.ru . Atomno MCP не аффилирован с ним.

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

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

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

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

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

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

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

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

Чего пока нет

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

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

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

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

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

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

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

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

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

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

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

Арбитражные дела доступны? +

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

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

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

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

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