Создан для AI-агентов, а не только для браузеров: как работает API

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

Каждая страница инструмента — это ещё и эндпоинт

Merge, разделение, сжатие, OCR, конвертация: каждый инструмент каталога отображается на /api/v1/…. Откройте страницу инструмента и прокрутите до Call this from code — там пример curl, собранный из реальных параметров этого инструмента, а не из общего шаблона. Анонимные вызовы на публичном сайте не требуют ни аккаунта, ни API-ключа; анонимные префиксы — /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ и /api/v1/filter/.

Пример для слияния конкретен:

curl -fsS -X POST "$API_BASE/api/v1/general/merge-pdfs" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o merged.pdf

OpenAPI лежит на /v1/openapi.json. Для многошаговой работы служит POST /api/v1/pipeline с упорядоченным списком steps. Отправляйте Idempotency-Key, когда повторная попытка не должна запустить изменяющую операцию второй раз. Ответы хостинга сообщают X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset; при HTTP 429 читайте Retry-After (анонимное ограничение частоты).

OCR через тот же каталог возвращает Markdown (text/markdown) из /api/v1/misc/ocr-pdf, а не PDF со скрытым текстовым слоем. Агент, ожидающий от этого эндпоинта PDF с распознанным текстом, обработает загрузку неправильно; контракт — извлечение текста для конвейеров, а не перезапись в стиле OCRmyPDF.

MCP для клиентов, которые его понимают

MCP (Model Context Protocol) позволяет клиентам-агентам обнаруживать инструменты и вызывать их как функции, вместо того чтобы разбирать документацию. Этот сайт предоставляет сервер MCP на /mcp рядом с REST API, так что совместимый клиент подключается один раз и получает весь каталог.

MCP и REST разделяют ожидания по аутентификации: анонимно там, где это допускают префиксы инструментов; API-ключи — для стабильной автоматизации и для закрытых self-hosted серверов. Направить агента на /mcp — это не другой продукт по сравнению с тем, чтобы направить curl на /api/v1/…. Документация: MCP для разработчиков.

Ошибки структурированы, а не описаны прозой

Сбои возвращают application/problem+json (в стиле RFC 7807), а не голый 500 или «что-то пошло не так». В каждом ответе есть стабильный код (rate_limited, bad_request, invalid_document, missing_dependency и подобные), читаемая подсказка и часто следующий шаг. Человек может просмотреть его глазами; агент может решить повторить, заменить файл или остановиться, не перекладывая разбор трассировки на человека.

Эта структура важнее, чем дружелюбная HTML-страница ошибки, когда вызывающий — скрипт. Справочник: Ошибки для разработчиков.

llms.txt — для инструментов, а не для рейтингов

/llms.txt — это текстовый индекс всех инструментов (название, описание, URL), сгенерированный из того же каталога, что управляет сайтом. Агенты-программисты и инструменты документации могут читать его как README. Это не рычаг для рейтинга в Google: поиск игнорирует /llms.txt (источники: руководство Google по оптимизации для ИИ). Поскольку файл генерируется, он не может незаметно устареть так, как это бывает с файлом, отредактированным вручную.

CLI и skill используют одни формы

pdfx умеет запускать локальный pdf-core или работать с --cloud против базового URL. Skill для агентов-программистов в dist/skills/pdf-toolbox/SKILL.md документирует формы curl для merge и pipeline, чтобы агенты не изобретали второй контракт. Четыре клиента, один каталог: Одна операция, четыре клиента.

Путь через браузер не изменился

Перетащить файл во вкладку по-прежнему просто. Дополнительная поверхность — те же эндпоинты для агента, скрипта или CI: та же обработка, без человека посередине. Self-host оставляет эту поверхность в вашей сети (Self-host); хостинг остаётся анонимным пробным путём.

Справочник API: Swagger. Основы для любого пути: Справка и Разработчикам.