English Français العربية

SmartPDF

Registre officiel Productivité

24 PDF tools: convert to and from Office and JPG, compress, merge, split, OCR, sign, watermark

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http smartpdf 'https://mcp.smartpdf.ru/mcp' --header 'Authorization: <SmartPDF API key with the Bearer prefix>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "smartpdf": {
            "type": "http",
            "url": "https://mcp.smartpdf.ru/mcp",
            "headers": {
                "Authorization": "<SmartPDF API key with the Bearer prefix>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. SmartPDF для ИИ-агентов
  2. Ключ
  3. Claude Code — плагин
  4. Cursor
  5. Только MCP-сервер
  6. Навык в других агентах
  7. English
  8. Лицензия

SmartPDF для ИИ-агентов

47 операций с PDF и фото для Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code и других агентов: конвертация в PDF и из PDF (в том числе Markdown, DjVu, FB2, EPUB), сжатие, объединение и разделение, распознавание текста (в том числе русского), редактор PDF, поиск и удаление персональных данных, страницы, подпись, водяной знак, пароль, инструменты для фото. Серверы в Москве, оплата в рублях за запрос.

Портал для разработчиков · Документация · llms.txt

ЧтоГде
Плагин Claude Code: MCP-сервер и навык.claude-plugin/
Плагин Cursor: MCP-сервер и навык.cursor-plugin/, mcp.json
Навык (Agent Skill) для любого агента: инструкция, скрипт для файлов с диска, справочник параметровskills/smartpdf/
Описание для реестра MCPserver.json

Ключ

Зарегистрируйтесь на smartpdf.ru и подтвердите почту — на баланс API придёт 300 ₽. Ключ sk_live_… создаётся в личном кабинете, в разделе «API и MCP». Цена запроса и бонусы при пополнении — на dev.smartpdf.ru.

Claude Code — плагин

/plugin marketplace add kirmoz1997/smartpdf-agents
/plugin install smartpdf@smartpdf

Claude Code спросит ключ и сохранит его в защищённом хранилище системы. После установки агенту доступны инструменты SmartPDF для файлов по ссылкам и навык smartpdf для файлов с диска — ему нужна ещё переменная окружения SMARTPDF_API_KEY с тем же ключом.

Из терминала: claude plugin marketplace add kirmoz1997/smartpdf-agents, затем claude plugin install smartpdf@smartpdf --config api_key=sk_live_….

Cursor

Плагин для Cursor (MCP-сервер и навык) — в этом же репозитории (.cursor-plugin/, mcp.json); ключ задаётся в Plugins → Configure. Только MCP-сервер — одной ссылкой: Добавить в Cursor (ключ — из переменной окружения SMARTPDF_API_KEY).

Только MCP-сервер
Адресhttps://mcp.smartpdf.ru/mcp
ТранспортStreamable HTTP
КлючAuthorization: Bearer sk_live_… или X-API-Key: sk_live_…

Сервер есть в официальном реестре MCP под именем ru.smartpdf/smartpdf.

Готовые конфиги для Claude Desktop, Cursor, VS Code, Codex CLI, Gemini CLI, Windsurf, Cline, n8n и Make — в документации. Инструменты принимают публичные ссылки на файлы до 100 МБ и возвращают ссылку на результат.

Навык в других агентах

Навык работает и с MCP-инструментами, и без них: файлы с диска он обрабатывает скриптом scripts/smartpdf.py через REST API (нужен Python 3, ключ — в SMARTPDF_API_KEY). Скопируйте папку skills/smartpdf туда, где агент ищет навыки:

git clone https://github.com/kirmoz1997/smartpdf-agents
cp -R smartpdf-agents/skills/smartpdf ~/.agents/skills/
АгентПапка навыков
Codex CLI~/.agents/skills/ или .agents/skills/ в проекте
Gemini CLI.gemini/skills/ или .agents/skills/ в проекте
Cursor.cursor/skills/ или .agents/skills/ в проекте
VS Code (Copilot).github/skills/ или .agents/skills/ в проекте
Claude Code без плагина~/.claude/skills/ или .claude/skills/ в проекте

Скрипт можно запускать и самому:

export SMARTPDF_API_KEY=sk_live_…
python3 skills/smartpdf/scripts/smartpdf.py compress report.pdf -p level=high
python3 skills/smartpdf/scripts/smartpdf.py operations

English

SmartPDF is a Russian PDF service (servers in Moscow, billing in rubles per request). This repository contains a Claude Code plugin (remote MCP server + agent skill), a standalone Agent Skill with a stdlib-only Python script for local files, and server.json for the official MCP Registry.

  • MCP: https://mcp.smartpdf.ru/mcp, Streamable HTTP, Authorization: Bearer <API key>; 47 tools that take public file URLs and return a download link, plus get_balance. Official MCP Registry: ru.smartpdf/smartpdf.
  • Claude Code: /plugin marketplace add kirmoz1997/smartpdf-agents, then /plugin install smartpdf@smartpdf.
  • Cursor: plugin in .cursor-plugin/ + mcp.json (key in Plugins → Configure), or Add to Cursor.
  • API keys: smartpdf.ru — 300 ₽ of free balance after email confirmation.
  • Documentation (in Russian): dev.smartpdf.ru/docs, llms.txt. Contact: smartpdf@yandex.ru.

Лицензия

Файлы этого репозитория — MIT. Работа сервиса — по оферте.

Questions fréquentes

Qu'est-ce que SmartPDF ?

24 PDF tools: convert to and from Office and JPG, compress, merge, split, OCR, sign, watermark

Comment installer SmartPDF ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http smartpdf 'https://mcp.smartpdf.ru/mcp' --header 'Authorization: <SmartPDF API key with the Bearer prefix>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour SmartPDF ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

SmartPDF est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient SmartPDF ?

Il est publié par kirmoz1997. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.