English Français العربية

SmartPDF

السجل الرسمي الإنتاجية

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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>'
إعداد 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>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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. Работа сервиса — по оферте.

الأسئلة الشائعة

ما هو SmartPDF؟

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

كيف أثبّت SmartPDF؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http smartpdf 'https://mcp.smartpdf.ru/mcp' --header 'Authorization: <SmartPDF API key with the Bearer prefix>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج SmartPDF إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل SmartPDF مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون SmartPDF؟

ينشره kirmoz1997. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.