PDF4me 经纪人技能入门
PDF4me 特工技能 可从公共渠道安装的技能包 pdf4me-skills 存储库 GitHub他们教 AI 编码助手 如何使用 PDF4me REST API：正确配置端点、有效负载形状、身份验证标头，以及跨转换、合并、拆分的功能路由 OCR提取、生成 Excel， Word图像、表单和安全操作。
这是 将产品表面与 PDF4me MCP。 MCP 连接实时工具服务器（uvx pdf4me-mcp因此客户端可以调用 PDF4me 在聊天过程中，操作可作为工具使用。代理技能负载 结构化的 API 指导 将代理程序加载到内存中，以便它可以写入和运行。 REST API 代码正确。
| PDF4me 特工技能 | PDF4me MCP | |
|---|---|---|
| 它是什么 | 技能包 API 参考和路由规则 | MCP 暴露的服务器 PDF4me 作为可调用工具 |
| 安装 | npx skills add … 或者 Claude Code /plugin 命令 | uvx pdf4me-mcp 在客户 MCP 配置 |
| 最适合 | 针对以下情况编写脚本、curl 或应用程序代码的代理： REST API | 直接从聊天窗口调用工具的代理 UI |
| 仓库 | github.com/pdf4me/pdf4me-skills | github.com/pdf4me/pdf4me-mcp |
先决条件
- A PDF4me 账户和 API 钥匙
- 获得 PDF4me REST API 在
https://api.pdf4me.com - 一个支持 AI 客户端（参见下方安装路径）
仓库里有哪些船只
第一个发布的技能是 pdf4me-api它遵循…… 特工技能 格式：
| 小路 | 目的 |
|---|---|
skills/pdf4me-api/SKILL.md | 技能显现、何时使用以及 API 类别路由 |
skills/pdf4me-api/references/ | 按功能分组的端点备注（转换、编辑、提取、生成……） |
skills/pdf4me-api/examples/ | 常见流程的小示例脚本 |
当用户请求转换时 PDF合并文件，运行 OCR填写表格或致电任何 PDF4me 终端，代理应加载此技能并遵循匹配类别的参考文件。
选择安装路径
- Claude Code (plugin marketplace)
- npx skills (Cursor, Copilot, Codex, …)
当你在工作时，请使用此路径 Claude Code （基于终端的） Claude 编码代理）。安装用途 Claude是内置插件命令，而不是 npx skills。
步骤 1：添加 PDF4me 技能市场
在项目目录中运行：
/plugin marketplace add pdf4me/pdf4me-skills
从 GitHub 添加 pdf4me-skills 市场。
当市场注册成功后， Claude Code 确认：
Successfully added marketplace: pdf4me-skills
确认市场已添加。
步骤 2：安装 pdf4me-api 插件
启动安装命令。您可以输入 /plugin install pdf 然后从自动完成选项中选择匹配项：
/plugin install pdf4me-api@pdf4me-skills
从插件列表中选择 pdf4me-api@pdf4me-skills。
Claude Code 显示插件详细信息并要求提供 安装范围：
- 为您安装（用户范围）可在您的所有项目中使用
- 为该仓库的所有协作者安装（项目范围）通过仓库配置共享
- 仅在此仓库中为您安装（本地范围）仅限本次结账
选择符合你工作方式的范围。例如，对于个人沙盒环境， 本地范围 或者 用户范围 很常见。
选择用户、项目或本地安装范围。
步骤三：重新加载插件
安装完成后：
✓ Installed pdf4me-skills. Run /reload-plugins to apply.
跑步：
/reload-plugins
重新加载插件，以便 Claude Code 能够获得新技能。
该技能目前处于活跃状态 Claude Code 就此范围而言。
使用此路径 Cursor， GitHub Copilot， OpenAI Codex， Cline， Gemini CLI， Windsurf， Zed， 和 70多位其他经纪人 由……支持 skills 命令行界面。
步骤 1：运行安装命令
从您的项目目录中：
npx skills add https://github.com/pdf4me/pdf4me-skills.git --skill pdf4me-api
一条命令即可克隆仓库并启动交互式安装程序。
这 CLI 克隆体 pdf4me-skills找到 pdf4me-api 技能，并开启代理选择器。
步骤二：选择目标代理商
通用代理商 （例如 Cursor， Cline， Codex， GitHub Copilot， Gemini CLI， Warp， Zed）被预先选入 .agents/skills使用可搜索列表添加或删除代理商，例如： Claude Code， OpenClaw， 或者 IBM Bob。
选择你日常使用的每一位代理人。
使用 空间 切换代理， ↑↓ 移动， 进入 确认一下。
步骤 3：选择安装范围
| 范围 | 何时使用 |
|---|---|
| 项目 | 技能存在于当前代码库中（例如）。 .agents/skills/pdf4me-api）并且可以为您的团队做出承诺 |
| 全球的 | 该技能已安装到您的用户帐户，并适用于所有项目。 |
项目范围将技能与您的代码库结合起来。
第四步：选择安装方式
| 方法 | 行为 |
|---|---|
| 符号链接（推荐） | 单一真理来源 .agents/skills易于更新 |
| 抄送所有代理人 | 将文件复制到每个特工的技能文件夹中 |
建议默认使用符号链接。
步骤五：确认并完成
查看摘要（安装路径、通用代理、符号链接） Claude Code 如果选中），确认 是的然后等待 安装完成。
该技能已添加到您的项目中，并与每个选定的代理关联。
安装程序会提醒您在使用前查看技能，因为它们以完整的代理权限运行。
步骤 6：向您的代理人核实
打开你的代理并开始输入 PDF与此相关的请求。例如，在 OpenAI Codex打字 pdf 表面 pdf4me-api [Skill] 建议结合技能描述进行描述。
Codex 识别已安装的 pdf4me-api 技能。
按 进入 首先插入技能背景，然后描述你的任务（例如“转换此内容”）。 DOCX 到 PDF 使用 PDF4me）。
请提供您的 API 代理人的关键
技能文件 如何 进行身份验证（Authorization: Basic <your_api_key>但它不会存储密钥。当代理生成代码或 curl 命令时，请安全地将您的密钥提供给它：
- 出口
PDF4ME_API_KEY（或者在代理请求运行时配置时粘贴密钥） - 永远不要承诺 API git 的密钥
看 连接到 PDF4me V2 API 完整的身份验证和请求格式。
安装后的示例提示
技能安装完成后，尝试以下提示：
- “使用 PDF4me 将这两个合并 PDFs 并返回 base64 输出。
- 转换此 Word 模板 PDF 使用生成文档端点。
- 从此表中提取数据 PDF 和 PDF4me“
- “哪个 PDF4me 我应该使用哪个端点来添加 QR Code 一个 PDF？
代理应加载 pdf4me-api选择正确的参考文件（例如）。 references/merge-split.md 或者 references/barcode.md），并产生一个有效的 REST 称呼。
故障排除
我的代理中没有显示该技能。
- Claude Code： 跑步
/reload-plugins安装完成后，请确认您已选择正确的范围（用户、项目或本地）。 - npx技能： 重新运行安装命令并确认已选择您的代理。检查一下。
.agents/skills/pdf4me-api/SKILL.md存在于您的项目中。 - 重新启动 IDE 或首次安装后的代理会话。
Claude Code 和 npx 技能：我应该使用哪一个？
- Claude Code 仅有的： 使用
/plugin marketplace路径 Claude Code 上方标签页。 - Cursor， Copilot， Codex， Cline或多个代理人： 使用
npx skills add …即使 Claude Code 是入选的代理人之一。
这与 PDF4me MCP 有何不同？
MCP 电线通电 PDF4me 将工具服务器集成到支持模型上下文协议的客户端中。 特工技能 教 REST API 在支持技能格式的代理程序中使用。您可以同时使用这两种方法： MCP 用于聊天工具调用、代码生成和脚本编写的技能。
下一步
- 浏览 PDF4me API 参考 终点详情：技能点数
- 设置 PDF4me MCP 如果你想直接调用工具 MCP 客户
- 星形或叉形
pdf4me-skills在 GitHub 获取更新和新技能