Скачать PDF судебного акта — kad.arbitr.ru и ras.arbitr.ru — MCP arbitr_pdf_skachat
Инструмент arbitr_pdf_skachat(url) получает конкретный PDF-документ по исходной ссылке КАД или РАС. Доступен в версии 0.7.0 MCP-сервера СУДиДЕЛО для арбитражных судов. Теперь сервер предоставляет десять инструментов.
Первичный источник данных
Картотека арбитражных дел — kad.arbitr.ru и Банк решений арбитражных судов — ras.arbitr.ru. Конкретный источник определяется переданной ссылкой на документ. MCP получает исходный PDF через API СУДиДЕЛО из кеша или после запуска загрузки источника. Прямого обращения MCP к сайту суда нет.
Как пользоваться
- Получите карточку дела или результаты поиска судебных актов через связанные инструменты ниже.
- Выберите исходную ссылку именно на PDF. Ссылка на карточку дела или HTML-страницу не подходит.
- Попросите помощника вызвать
arbitr_pdf_skachat, передав ссылку целиком. Если клиент запрашивает подтверждение, проверьте документ и URL. - Дождитесь результата. При успехе сохраните переданный PDF средствами клиента или обработайте полный результат отдельно.
Если после обновления инструмент не появился, переподключите sudodelo-arbitr и обновите каталог инструментов в клиенте. Адреса подключения и способы авторизации прежние; настройка описана в основной статье сервера.
Параметр url
Обязательная строка длиной до 8192 символов — исходная HTTPS-ссылка на PDF с домена kad.arbitr.ru или ras.arbitr.ru. Поддерживаются пути:
/Document/Pdf/{UUID_ДЕЛА}/{UUID_ДОКУМЕНТА}/{ИМЯ}.pdf
/Kad/PdfDocument/{UUID_ДЕЛА}/{UUID_ДОКУМЕНТА}/{ИМЯ}.pdf
Значения в фигурных скобках обозначают структуру адреса, а не готовую ссылку. Используйте настоящий URL из источника. Сохраняйте все query-параметры, включая isAddStamp, если он присутствует. Дополнительно кодировать URL или заменять & на текст & в аргументе не нужно.
Форма аргумента:
{"url":"ВСТАВЬТЕ_ПОЛНУЮ_HTTPS_ССЫЛКУ_НА_PDF"}
Замените плейсхолдер целиком. Ссылки на посторонние домены, HTTP, ссылки с логином и паролем, фрагментом после #, нестандартным портом или некорректным путём отклоняются до обращения к API. Номер дела, HTML карточки и текст документа не заменяют URL PDF.
Пример запроса в чате
Скачай через arbitr_pdf_skachat PDF по этой исходной ссылке: [ссылка на PDF из КАД или РАС]. Сохрани файл, если клиент поддерживает запись файлов. Покажи имя, размер и SHA-256 из результата.
Это пример формулировки, а не отчёт о получении документа. Проверяйте фактический вызов инструмента и его ответ. Поиск актов и получение карточки сами по себе возвращают ссылки; для скачивания PDF нужен отдельный вызов.
Что возвращает инструмент
При успехе — разрешено: true, пояснение итог и объект данные:
имя_файла— имя переданного файла.content_type—application/pdf.размер_байт— размер исходного PDF до кодирования.sha256— контрольная сумма исходных байтов.soderzhimoe_base64— содержимое PDF в base64.
Сервер проверяет MIME-тип, сигнатуру %PDF- и совпадение SHA-256 с заголовком X-Content-SHA256 Public API. HTML вместо PDF или повреждённый ответ не выдаются за успешное скачивание.
Как сохранить PDF
MCP передаёт содержимое документа клиенту. Сохранение на компьютер или кнопка скачивания зависят от возможностей клиента. Успешная передача файла и запись файла на диск — отдельные действия.
Если клиент позволяет выгрузить полный результат инструмента в tool-result.json, его можно обработать следующим образом. Файл должен содержать объект с полями разрешено и данные, извлечённый из structuredContent либо JSON-текста результата, а не пересказ модели или всю транспортную оболочку MCP.
import base64
import hashlib
import json
from pathlib import Path
result = json.loads(Path("tool-result.json").read_text(encoding="utf-8"))
if result.get("разрешено") is not True:
raise RuntimeError(result.get("итог", "PDF не получен"))
data = result["данные"]
pdf = base64.b64decode(data["soderzhimoe_base64"], validate=True)
if data.get("content_type") != "application/pdf" or not pdf.startswith(b"%PDF-"):
raise ValueError("Получен не PDF")
if len(pdf) != data["размер_байт"]:
raise ValueError("Размер PDF не совпадает")
if hashlib.sha256(pdf).hexdigest() != data["sha256"]:
raise ValueError("SHA-256 PDF не совпадает")
Path("sudebny-akt.pdf").write_bytes(pdf)
Не просите модель восстанавливать обрезанный base64. В инструкции LM Studio на примере ЕГРЮЛ зафиксировано обрезание длинного результата в версии 0.4.28+2. Это ограничение клиента нужно учитывать и при получении судебных PDF; новая проверка этой версии с данным инструментом здесь не заявляется. Для полного файла нужен клиент, который принимает весь результат и умеет его сохранять.
Ожидание и размер файла
- Public API может запустить загрузку и ждать до 15 минут. Тайм-аут MCP по умолчанию — 960 секунд; рекомендуемое ожидание клиента — от 1100 секунд. Прокси и внешние клиенты могут прервать запрос раньше.
- Лимит MCP по умолчанию — 5 МиБ (5242880 байт), настройка
MCP_MAX_DOWNLOAD_BYTES. Он проверяется при чтении потока до base64; при превышении возвращается отказ без частичного файла. - Public API допускает PDF до 50 МиБ. Если файл превышает лимит MCP, используйте прямой API согласно Swagger. Base64 увеличивает объём результата примерно на треть.
- Вызов может запускать загрузку, хотя используется GET. MCP выполняет один запрос, не повторяет его автоматически, не следует редиректам и не запускает собственный опрос задания. Данные CRM не изменяются.
Тайм-аут и ошибки
При отказе возвращается разрешено: false и пояснение в итог. При HTTP 504 возможны http_status: 504, error: KD_PDF_WAIT_TIMEOUT, documentId, statusUrl и допустимые taskId/state, если API вернул корректные метаданные. Файл в таком ответе отсутствует.
Задание может продолжать работу после 504, сетевого тайм-аута или отмены. Не запускайте загрузку повторно автоматически. statusUrl указывает путь проверки состояния в Public API без ключа; API-клиент использует его относительно базового адреса Public API и добавляет текущий apiKey. MCP самостоятельно по этой ссылке не переходит; отдельного MCP-инструмента проверки состояния в версии 0.7.0 нет.
HTTP 409 означает ошибку или неопределённый результат задания и не сбрасывается повтором; состояние quarantined требует отдельной проверки сервиса. При неверном URL исправьте ссылку; при отказе доступа проверьте ключ и право арбитражного раздела. При превышении размера или обрезанном ответе не считайте PDF полученным.
Для программистов
GET /api/KadArbitr/pdf?url={ИСХОДНЫЙ_URL}&apiKey={КЛЮЧ_ПОЛЬЗОВАТЕЛЯ}
Контракт: Swagger — KadArbitr. Исходный URL передаётся значением query-параметра url и кодируется HTTP-клиентом один раз. Для MCP ключ поступает с текущим запросом: через X-Sudodelo-Api-Key при ручном подключении или через браузерную авторизацию. Требуется право menu.monitoringresultlistarbitrcases; отдельный служебный токен не нужен.
В Python MCP SDK для длительного вызова задайте ClientSession(read_timeout_seconds=timedelta(seconds=1100)) и соответствующий тайм-аут вызова инструмента. Настройка сервера для этого инструмента — SUDODELO_KAD_PDF_TIMEOUT_SEC.
Связанные инструменты
- Карточка дела и ссылки на документы — kad.arbitr.ru.
- Поиск судебных актов и ссылок — ras.arbitr.ru.
- Поиск дел по ИНН — kad.arbitr.ru.
Все инструменты и подключение сервера · Раздел «КАД АРБИТР».