SmartPDF

AI エージェント向け SmartPDF

Claude Code、Codex CLI、Gemini CLI、Cursor、VS Code などのエージェント向けに、PDF と写真を操作する 47 種類の機能を提供します。PDF への変換と PDF からの変換（Markdown、DjVu、FB2、EPUB など）、圧縮、結合と分割、テキスト認識（ロシア語を含む）、PDF エディター、個人情報の検索と削除、ページ、署名、ウォーターマーク、パスワード、写真用ツールに対応しています。サーバーはモスクワにあり、リクエストごとにルーブルでお支払いいただけます。

開発者ポータル · ドキュメント · llms.txt

内容	場所
Claude Code プラグイン：MCP サーバーとスキル	.claude-plugin/
Cursor プラグイン：MCP サーバーとスキル	.cursor-plugin/、mcp.json
あらゆるエージェント向けスキル（Agent Skill）：説明、ディスク上のファイル用スクリプト、パラメーターリファレンス	skills/smartpdf/
MCP レジストリ向けの説明	server.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_…

サーバーは、ru.smartpdf/smartpdf という名前でMCP 公式レジストリに登録されています。

Claude Desktop、Cursor、VS Code、Codex CLI、Gemini CLI、Windsurf、Cline、n8n、Make 向けの設定例は、ドキュメントにあります。ツールは最大 100 MB の公開リンクを受け付け、処理結果へのリンクを返します。

その他のエージェントでのスキル

このスキルは MCP ツールの有無にかかわらず動作します。ディスク上のファイルは、REST API を介して scripts/smartpdf.py スクリプトで処理します（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

英語

SmartPDF はロシアの PDF サービスです（サーバーはモスクワにあり、リクエストごとにルーブルで課金されます）。このリポジトリには、Claude Code プラグイン（リモート MCP サーバー＋エージェントスキル）、ローカルファイル用の標準ライブラリのみを使用する Python スクリプトを含む単体のエージェントスキル、公式 MCP Registry 用の server.json が含まれています。

• MCP：https://mcp.smartpdf.ru/mcp、Streamable HTTP、Authorization: Bearer <API key>。公開ファイル URL を受け取り、ダウンロードリンクを返す 47 個のツールと、get_balance を提供します。公式 MCP Registry：ru.smartpdf/smartpdf。
• Claude Code：/plugin marketplace add kirmoz1997/smartpdf-agents を実行し、その後 /plugin install smartpdf@smartpdf を実行します。
• Cursor：.cursor-plugin/ 内のプラグイン＋mcp.json（キーは Plugins → Configure で設定）、またはCursor に追加。
• API キー：smartpdf.ru — メールアドレス確認後、300 ₽ 分の無料残高が付与されます。
• ドキュメント（ロシア語）：dev.smartpdf.ru/docs、 llms.txt。お問い合わせ：[email protected]。

ライセンス

このリポジトリのファイルは MIT ライセンスです。サービスの利用には利用規約が適用されます。