SmartPDF API · MCP

PDF-операции для вашего кода и ИИ-агентов

47 операций через REST API и MCP: конвертация, сжатие, распознавание текста с русским, редактор PDF, скрытие персональных данных. Серверы в Москве, оплата в рублях за каждый запрос.

300 ₽ на баланс при регистрации — около 240 запросов. Без подписки и без карты.

Сожми договоры по ссылкам из задачи и пришли ссылки на результат
smartpdf · compress_pdfdogovor-01.pdf
4,2 МБ → 1,1 МБ1,25 ₽
smartpdf · compress_pdfdogovor-02.pdf
2,8 МБ → 0,9 МБ1,25 ₽
smartpdf · compress_pdfakt-sverki.pdf
12,6 МБ → 3,4 МБ2,50 ₽
Готово: 3 файла сжаты, с баланса API — 5,00 ₽. Ссылки ниже.
01 / Подключение

Четыре способа подключить

Один аккаунт и один баланс для всех: ключи API работают и в REST, и в MCP.

01

REST API

POST /v1/pdf/compress

Любой язык и фреймворк: загрузка → операция → статус → скачивание. Вебхуки с подписью — вместо опроса.

Быстрый старт
02

MCP-сервер

mcp.smartpdf.ru/mcp

47 операций для Claude Code, Cursor, VS Code, Codex и других агентов. Ключ — в заголовке запроса.

Подключить агента
03

n8n и Make

MCP Client · HTTP

PDF в сценариях без кода: узел MCP Client или HTTP-запрос к REST API.

Инструкции
04

Плагин Claude Code

/plugin install smartpdf@smartpdf

MCP и навык для файлов с компьютера — одной командой в Claude Code.

Установить
02 / Агенты

Подключите к агенту за минуту

MCP-сервер добавляет агенту 47 операций SmartPDF — он сам выбирает операцию. Файлы — по публичной ссылке, результат — ссылка на скачивание. Оплата — с того же баланса, что у API.

Попросите агента:

  • Сожми PDF по этим ссылкам и пришли ссылки на результат
  • Распознай текст в скане договора и сделай из него Word
  • Объедини три счёта в один PDF и пронумеруй страницы
  • Поставь водяной знак «КОПИЯ» на все страницы
  • Сколько осталось на балансе SmartPDF?

Файл с компьютера агент сначала загружает через REST API — как передать файл.

mcp.smartpdf.ru/mcp
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}'
Терминал. Одинарные кавычки обязательны: Claude Code подставит ключ из переменной при подключении, в настройки он не попадёт. Проверка — claude mcp list: smartpdf ✓ connected.
Все клиенты: Windsurf, Cline, n8n, Make
03 / Операции

47 операций с PDF и фото

Те же инструменты, что на smartpdf.ru, — для вашего кода. Каждая операция — один POST-запрос с параметрами в JSON.

04 / Код

Полный цикл — четыре запроса

Загрузите файл, запустите операцию, дождитесь статуса done и скачайте результат. Каждый пример проверен запуском против API.

Сжать PDF
#!/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)"
bash quickstart.sh — нужны curl и jq
05 / Почему SmartPDF

Сделано для работы в России

152-ФЗ

Данные в России

Серверы и резервные копии — в Москве. Обработка персональных данных — по 152-ФЗ.

₽

Рубли по факту

Карта или СБП, чек самозанятого. Без подписки: платите за запросы, баланс не сгорает.

1 ч

Файлы не копятся

Загруженные файлы удаляются через час, результаты — по сроку хранения тарифа.

HMAC

Вебхуки с подписью

Уведомление о готовности с подписью HMAC-SHA256 — не нужно опрашивать статус.

OCR

Распознавание с русским

Сканы становятся PDF с текстовым слоем: русский, английский, немецкий, французский.

лимит

Контроль трат

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

06 / Цены

Платите только за запросы

Один баланс в рублях для REST и MCP. Списание — до постановки в очередь, ошибка обработки возвращает оплату.

1,25 ₽за запрос — файл до 10 МБ
  • 300 ₽ на баланс при регистрации — около 240 запросов.
  • Пополнение от 100 ₽ картой или через СБП, чек самозанятого. Без подписки.
  • Бонус к пополнению: от 5 000 ₽ +25 %, от 20 000 ₽ +56 %, от 65 000 ₽ +92 %.
  • Баланс не сгорает и общий для всех ключей; у каждого ключа — свой лимит трат.
  • Тариф Бизнес: 500 обычных запросов в месяц включены.
Как считаются запросы — берётся большее
Большинство операцийкаждые начатые 10 МБ
Распознавание текста10 МБ или 10 страниц
PDF в Word, Excel, PowerPoint, JPG10 МБ или 50 страниц (JPG 300 dpi — 25)
Объединениепо сумме размеров файлов

Калькулятор

Запросов на файл
1
Запросов в месяц
1 000
В месяц
1 250 ₽
07 / Вопросы

Частые вопросы

Нужна ли подписка?

Нет. Каждый запрос оплачивается с баланса 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 обычных запросов в месяц уже включены и расходуются раньше баланса.

08 / Для компаний

Обсудим вашу задачу

Нужен большой объём, другие лимиты или помощь с интеграцией? Расскажите о задаче — менеджер свяжется и поможет подобрать условия.

smartpdf@yandex.ru