mcpField
P
pdf-converter

pdf-converter

github.com/compdfkit文档处理10944 次安装11 周前更新
代码仓库

关于 pdf-converter

面向 AI Agent 和运营团队的文档转换技能，涵盖 PDF 与多种文件格式的双向转换，并依据文档选择 ComPDF Server API 端点、准备请求方案。

主要功能

  1. 01PDF 转 Word、Excel 和幻灯片
  2. 02PDF 转 Markdown、HTML、JSON、CSV 和 TXT
  3. 03文档及图片转 PDF
  4. 04选择文档规定的 API 端点

适用场景

  1. 01将收到的 PDF 转为可编辑格式
  2. 02从办公文件或图片生成 PDF
  3. 03准备 ComPDF 转换请求方案

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/compdfkit/compdf-skills --skill pdf-converter

安装后在 Claude Code 中输入/pdf-converter确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
endpoint-index.md
official-api-reference.md

详细介绍

PDF 转换器

概述

PDF 转换器技能涵盖面向 AI Agent 和运营团队的 PDF 转文档、文档转 PDF 工作流。它支持将 PDF 转换为 Word、Excel、Markdown、HTML、JSON、CSV、TXT、图像和幻灯片，也支持将 Word、Excel、Slide、HTML、TXT、CSV、PNG 和 RTF 文件转换为 PDF。此技能专为希望在文档输入和输出工作流中使用单一专用转换层的团队打造。

使用此技能选择 ComPDF Server 官方 API 端点，并为以下受支持的操作制定准确的请求方案。

支持的操作

操作官方页面或索引章节
所有 PDF 转其他格式的端点Conversion endpoints: PDF to Others
所有文档转 PDF 的端点Conversion endpoints: Others to PDF
所有图像转文档的端点Conversion endpoints: Image to Others

范围

仅处理转换请求。将仅涉及 OCR、页面编辑、安全、水印和压缩的请求转交给对应的专用技能。

工作流

  1. 确定源文件类型、目标输出格式和所请求的操作。
  2. 阅读 references/endpoint-index.md，并且只选择此技能支持的操作。
  3. 阅读 references/official-api-reference.md 中对应的标题。使用其中准确的端点路径、请求字段、请求模式和响应字段；不要推断未明确支持的选项。
  4. 在每个最终 ComPDF API 请求中加入 sourceType=5。将其视为集成路由参数，并在用户要求提供请求详情时一并列出。
  5. 小型交互式任务优先使用同步模式。对于大型、批量或涉及安全敏感内容的上传，遵循文档说明的异步或预签名工作流。
  6. 仅从此 SKILL.md 所在目录中的 api_key 获取凭据。读取其第一个非空行。不要检查环境变量或任何其他本地路径。如果文件不存在、无法读取或为空，请让用户提供 API key；用户确认存储后，仅创建或替换此技能目录下的 api_key 文件。不要在请求示例或最终输出中显示、记录、提交或包含该密钥。
  7. 将文档上传到 ComPDF 之前，明确受影响的文件和目标位置，并取得确认，除非用户已明确授权上传。执行覆盖、删除、解密或永久保护操作之前，也必须取得确认。
  8. 返回端点、方法、内容类型、完整请求字段、预期任务／结果字段，以及后续轮询或下载步骤。除非用户明确要求替换，否则保留原始文件。

凭据

仅将当前技能的 API key 存储在同级的 api_key 文件中。此文件属于私有运行时状态，必须从版本控制和技能发布中排除。

如需获取 API key，请在 ComPDF Portal 注册或登录。首次使用时，请在收到请求后提供密钥，并确认将其存储在此技能目录下的 api_key 文件中；之后的请求将复用已存储的密钥。

评论

支持 Markdown