REST API
POST /v1/pdf/compressЛюбой язык и фреймворк: загрузка → операция → статус → скачивание. Вебхуки с подписью — вместо опроса.
Быстрый старт47 операций через REST API и MCP: конвертация, сжатие, распознавание текста с русским, редактор PDF, скрытие персональных данных. Серверы в Москве, оплата в рублях за каждый запрос.
300 ₽ на баланс при регистрации — около 240 запросов. Без подписки и без карты.
Один аккаунт и один баланс для всех: ключи API работают и в REST, и в MCP.
POST /v1/pdf/compressЛюбой язык и фреймворк: загрузка → операция → статус → скачивание. Вебхуки с подписью — вместо опроса.
Быстрый стартmcp.smartpdf.ru/mcp47 операций для Claude Code, Cursor, VS Code, Codex и других агентов. Ключ — в заголовке запроса.
Подключить агентаMCP Client · HTTPPDF в сценариях без кода: узел MCP Client или HTTP-запрос к REST API.
Инструкции/plugin install smartpdf@smartpdfMCP и навык для файлов с компьютера — одной командой в Claude Code.
УстановитьMCP-сервер добавляет агенту 47 операций SmartPDF — он сам выбирает операцию. Файлы — по публичной ссылке, результат — ссылка на скачивание. Оплата — с того же баланса, что у API.
Попросите агента:
Файл с компьютера агент сначала загружает через REST API — как передать файл.
export SMARTPDF_API_KEY=sk_live_… # ключ из личного кабинета
claude mcp add --transport http smartpdf https://mcp.smartpdf.ru/mcp \
--scope user --header 'Authorization: Bearer ${SMARTPDF_API_KEY}'Те же инструменты, что на smartpdf.ru, — для вашего кода. Каждая операция — один POST-запрос с параметрами в JSON.
/word-to-pdfJPG в PDF/jpg-to-pdfФото в PDF/photo-to-pdfExcel в PDF/xlsx-to-pdfPowerPoint в PDF/pptx-to-pdfDjVu в PDF/djvu-to-pdfFB2 в PDF/fb2-to-pdfEPUB в PDF/epub-to-pdfHTML в PDF/html-to-pdf/to-wordPDF в JPG/to-jpgPDF в PNG/to-pngPDF в Excel/to-excelPDF в PowerPoint/to-pptxPDF в Markdown/to-markdownPDF в текст/to-txt/compress-imageHEIC в JPG/heic-to-jpgФото в текст/image-to-textPNG в JPG/png-to-jpgJPG в PNG/jpg-to-pngWEBP в JPG/webp-to-jpgИзменить размер фото/resize-imageОбрезать фото/crop-imageПовернуть фото/rotate-imageWord в JPG/word-to-jpg/editСжать PDF/compressPDF в ч/б/grayscalePDF в PDF/A/to-pdfaВосстановить PDF/repairОбъединить PDF/mergeРазделить PDF/splitРаспознать текст/ocrСгладить PDF/flattenЗагрузите файл, запустите операцию, дождитесь статуса done и скачайте результат. Каждый пример проверен запуском против API.
#!/usr/bin/env bash
# SmartPDF API — Сжать PDF: загрузка → операция → ожидание → скачивание.
# Нужны curl и jq.
# Ключ — в личном кабинете: https://smartpdf.ru/dashboard/api-keys
set -euo pipefail
API="https://api.smartpdf.ru/v1"
AUTH="X-API-Key: $SMARTPDF_API_KEY"
# 1. Загрузить файл
FILE_ID=$(curl -sS --fail-with-body -H "$AUTH" -F "file=@document.pdf" "$API/upload" | jq -r .file_id)
# 2. Запустить операцию
BODY=$(jq -n --arg file_id "$FILE_ID" '{file_id: $file_id, level: "medium"}')
TASK_ID=$(curl -sS --fail-with-body -H "$AUTH" -H "Content-Type: application/json" \
-d "$BODY" "$API/pdf/compress" | jq -r .task_id)
# 3. Дождаться результата
while :; do
TASK=$(curl -sS --fail-with-body -H "$AUTH" "$API/tasks/$TASK_ID")
STATUS=$(echo "$TASK" | jq -r .status)
[ "$STATUS" = done ] && break
[ "$STATUS" = failed ] && { echo "Ошибка обработки: $(echo "$TASK" | jq -r .error)" >&2; exit 1; }
sleep 2
done
# 4. Скачать результат
RESULT=$(curl -sS --fail-with-body -H "$AUTH" "$API/tasks/$TASK_ID/download")
curl -sS --fail-with-body -o "$(echo "$RESULT" | jq -r .filename)" "$(echo "$RESULT" | jq -r .download_url)"
echo "Готово: $(echo "$RESULT" | jq -r .filename)"Серверы и резервные копии — в Москве. Обработка персональных данных — по 152-ФЗ.
Карта или СБП, чек самозанятого. Без подписки: платите за запросы, баланс не сгорает.
Загруженные файлы удаляются через час, результаты — по сроку хранения тарифа.
Уведомление о готовности с подписью HMAC-SHA256 — не нужно опрашивать статус.
Сканы становятся PDF с текстовым слоем: русский, английский, немецкий, французский.
Лимит трат на каждый ключ: на день, неделю, месяц или всё время. Перевыпуск без смены настроек.
Один баланс в рублях для REST и MCP. Списание — до постановки в очередь, ошибка обработки возвращает оплату.
| Большинство операций | каждые начатые 10 МБ |
|---|---|
| Распознавание текста | 10 МБ или 10 страниц |
| PDF в Word, Excel, PowerPoint, JPG | 10 МБ или 50 страниц (JPG 300 dpi — 25) |
| Объединение | по сумме размеров файлов |
Нет. Каждый запрос оплачивается с баланса API аккаунта — пополняете, когда нужно. При регистрации на баланс зачисляется 300 ₽.
Запрос — каждые начатые 10 МБ входного файла: файл до 10 МБ — один запрос, 25 МБ — три. У распознавания текста и конвертации в Office и JPG считаются ещё и страницы — берётся большее. Цена списанного видна в кабинете и в ответе API.
MCP-инструменты принимают публичную ссылку на файл (до 100 МБ) и возвращают ссылку на результат. Файл с компьютера агент загружает через REST API: POST /v1/upload.
Загруженные — час. Результаты — по сроку тарифа аккаунта: час на бесплатном, 7 дней на Про, 30 дней на Бизнесе. Серверы — в Москве.
Нет: у результатов через API и MCP водяного знака нет.
До 10 запросов в секунду на ключ и 30 запросов операций в минуту с одного IP. Размер файла — по тарифу аккаунта: 50 МБ, на Про — 200 МБ, на Бизнесе — 500 МБ. Распознавание — до 100 страниц за раз.
Сейчас — картой или через СБП, с чеком самозанятого. Нужен большой объём или особые условия — оставьте заявку ниже.
Нет, API работает с любым тарифом. На Бизнесе 500 обычных запросов в месяц уже включены и расходуются раньше баланса.
Нужен большой объём, другие лимиты или помощь с интеграцией? Расскажите о задаче — менеджер свяжется и поможет подобрать условия.
smartpdf@yandex.ru