SmartPDF

面向 AI Agent 的 SmartPDF

为 Claude Code、Codex CLI、Gemini CLI、Cursor、VS Code 等 Agent 提供 47 种 PDF 和照片操作：转换为 PDF 和从 PDF 转换（包括 Markdown、DjVu、FB2、EPUB）、压缩、合并和拆分、文本识别（包括俄语）、PDF 编辑器、个人信息搜索和删除、页面、签名、水印、密码、照片工具。服务器位于莫斯科，按请求以卢布计费。

开发者门户 · 文档 · llms.txt

内容	位置
Claude Code 插件：MCP 服务和技能	.claude-plugin/
Cursor 插件：MCP 服务和技能	.cursor-plugin/、mcp.json
适用于任何 Agent 的技能（Agent Skill）：说明、处理磁盘文件的脚本、参数参考	skills/smartpdf/
MCP 注册表描述	server.json

密钥

在 smartpdf.ru 注册并验证邮箱，即可获得 300 ₽ 的 API 余额。sk_live_… 密钥可在个人账户的「API 和 MCP」部分创建。请求价格和充值奖励见 dev.smartpdf.ru。

Claude Code — 插件

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

Claude Code 会询问密钥，并将其保存到系统的安全存储中。安装后，Agent 即可使用 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 MB 的公开文件链接，并返回结果链接。

在其他 Agent 中使用技能

该技能可配合 MCP 工具使用，也可独立运行：处理磁盘文件时，它会通过 REST API 使用脚本 scripts/smartpdf.py（需要 Python 3，密钥需设置在 SMARTPDF_API_KEY 中）。将 skills/smartpdf 文件夹复制到 Agent 查找技能的位置：

git clone https://github.com/kirmoz1997/smartpdf-agents
cp -R smartpdf-agents/skills/smartpdf ~/.agents/skills/

Agent	技能文件夹
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 是一项俄罗斯 PDF 服务（服务器位于莫斯科，按请求以卢布计费）。此仓库包含一个 Claude Code 插件（远程 MCP 服务 + Agent 技能）、一个独立的 Agent 技能（附带一个仅使用 Python 标准库、用于处理本地文件的脚本），以及供官方 MCP Registry 使用的 server.json。

• MCP：https://mcp.smartpdf.ru/mcp，Streamable HTTP，Authorization: Bearer <API key>；提供 47 个工具，可接收公开文件 URL 并返回下载链接，另有 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 许可证。服务运营遵循服务条款。