PDF 提取

通过 ComPDF Cloud REST API 处理 PDF 文件，支持 50 多种文档处理操作。

官方文档：https://www.compdf.com/guides/api-reference/v2/overview?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_extract&ref_platform_id=clawhub_skills

何时运行

• 用户请求转换文件格式（例如：“将这个 PDF 转为 Word”，“将 Excel 转为 PDF”）
• 用户请求编辑 PDF 页面（例如：“合并这两个 PDF”，“删除第 3 页”，“旋转 PDF”）
• 用户请求添加或移除水印
• 用户请求压缩 PDF 文件
• 用户请求对扫描文档或图像中的文字进行 OCR 识别
• 用户请求使用 AI 提取或解析文档内容
• 用户请求从图像中提取表格
• 用户请求批量处理多个文档文件
• 用户请求对比两个 PDF 文件的差异
• 用户提及 ComPDF、compdf 或相关关键词

工作流程

步骤 1 — 获取 API 密钥

检查 config/public_key.txt 文件是否存在且内容非空。

• 若文件存在且内容不为空：使用存储的密钥（去除首尾空白字符）。
• 若文件缺失或为空：向用户索取其 ComPDF API 公共密钥。告知用户可通过以下链接获取：

https://www.compdf.com/compdf-portal/signin?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_extract&ref_platform_id=clawhub_skills

用户提供密钥后，询问是否希望将其本地保存以供后续会话使用：

- 若用户同意，将密钥写入 config/public_key.txt。

- 若用户拒绝，仅在当前会话中使用该密钥，不进行本地保存。

密钥文件 不会包含在发布的技能包中。它仅在用户明确选择后于运行时创建。用户可随时删除 config/public_key.txt 以撤销本地存储。

步骤 2 — 确认外部上传意图

在上传任何文件前，必须明确告知用户：

⚠️ 外部上传确认要求

您的文件将被上传至 ComPDF 服务器（api-server.compdf.com 或 api-server.compdf.cn）进行处理。请确认以下事项：

1. 您已同意将此文件上传至外部服务器。
2. 该文件不包含高度敏感或机密信息，或您已接受相关风险。
3. 您已阅读 ComPDF 的隐私政策：

https://www.compdf.com/privacy-policy/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_extract&ref_platform_id=clawhub_skills

仅在获得用户明确确认后，方可继续上传。

步骤 3 — 确定基础 URL

根据用户的网络环境判断应使用的服务器地址：

步骤 4 — 选择工具

在 references/tool-list.md 中查找用户任务对应的 executeTypeUrl。

常见操作快速参考：

完整 50+ 工具列表请参见 references/tool-list.md。

步骤 5 — 构建参数（可选）

若所选工具支持自定义参数，请在 references/parameters.md 中查找其 JSON Schema。参数以 JSON 字符串 形式作为 parameter 表单字段传入。若省略，则使用服务器默认值。

步骤 6 — 发送请求

在用户明确确认文件可上传至 ComPDF 云服务后执行以下操作：

1. 向 {baseUrl}/process/{executeTypeUrl} 发送 POST 请求。
2. 在请求头中包含用户提供的 API 密钥（x-api-key），仅限本次会话使用。
3. 将选定文件以多部分表单数据（multipart form-data）形式发送。
4. 仅当所选工具支持自定义参数时，才包含 parameter 字段。
5. 使用同步 /process/ 接口，确保结果在一次响应中返回。

在用户确认允许文件传输前，不得发送请求。

步骤 7 — 处理响应

**1. 检查 code 字段** — "200" 表示成功；其他值均为错误。

**2. 检查 taskStatus**（同步调用应为 TaskFinish）：

**3. 从 fileInfoDTOList[].downloadUrl 提取下载链接。**

4. 提醒用户：下载链接将在 次日 24:00 过期。

5. 出现失败时：读取 failureCode 和 failureReason，并参考 references/error-codes.md 查找解决方案。

6. 若因配额耗尽导致失败（code = "06001"）：告知用户：

如需更多积分，请访问：

https://api.compdf.com/api/pricing-old/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_extract&ref_platform_id=clawhub_skills

辅助接口

输出格式

成功时：

处理完成！

文件：{fileName} → {downFileName}
状态：{taskStatus}
耗时：{convertTime}ms
原始大小：{fileSize} 字节
结果大小：{convertSize} 字节
下载链接：{downloadUrl}

⚠️ 下载链接将于明日 24:00 过期，请及时保存。

失败时：

处理失败。

错误码：{failureCode}
原因：{failureReason}
建议：{来自 references/error-codes.md 的排查建议}

关键规则

1. HTTP 200 ≠ 成功 — 必须检查响应体中的 code 和 taskStatus。
2. 每项任务最多处理 5 个文件 — 若需处理更多文件，请拆分为多个任务。
3. 免费套餐限制 — 30 天内最多处理 200 个文件。
4. 文件类型自动识别 — API 可自动检测上传文件类型，无需更改扩展名。
5. 加密 PDF — 若文件受密码保护，请在 password 表单字段中提供密码（与 parameter 分离）。
6. 中国域名 — 中国大陆用户必须将 compdf.com 替换为 compdf.cn。
7. 用户可控的 API 密钥存储 — 密钥文件（config/public_key.txt）不会随技能包发布。仅在用户明确同意后于运行时创建。用户可随时删除该文件。
8. 外部上传确认 — 上传前必须获得用户的明确同意。

许可证与版权

版权所有 © 2014–2026 PDF Technologies, Inc.，一家 KDAN 公司。保留所有权利。

ComPDF 和 ComPDFKit 是 [PDF Technologies, Inc.](https://www.compdf.com/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_toolkit&ref_platform_id=clawhub_skills)（KDAN 公司）的商标。

本技能包采用 Apache License 2.0 许可。完整许可文本请见 LICENSE.txt。

ComPDF Cloud API 是由 PDF Technologies, Inc. 提供的商业服务。使用该 API 需遵守 [ComPDF 服务条款](https://www.compdf.com/terms-of-service/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_extract&ref_platform_id=clawhub_skills) 与 [隐私政策](https://www.compdf.com/privacy-policy/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_extract&ref_platform_id=clawhub_skills)。