通过 PDFCraft MCP 将 PDF 转为 Markdown
为 AI Agent 接入 PDFCraft MCP,用示例 PDF 完成 Markdown 转换、检查结果,再将文本用于摘要和文档处理。

PDF 报告可以成为 AI Agent 的参考材料。先将它转为 Markdown,你就能检查、编辑并复用其中的文本,再让 Agent 整理摘要或提取信息。
PDFCraft 提供处理 PDF 和 EPUB 的远程 MCP 服务。本文用一个小型公开 PDF,说明从接入到检查下载结果的完整流程。转换会消耗 PDFCraft credits。
为 Agent 接入 PDFCraft
在 OOMOL Console 创建 API key,再按照 PDFCraft MCP 接入指南添加服务器。PDFCraft 使用独立的 MCP 地址;如果已经接入 OOMOL Apps,需要另外添加这个服务器。
开始前,核对客户端是否支持接入指南列出的传输方式、协议版本和 Bearer 认证请求头。将密钥保存在客户端的凭据设置中。客户端还需要能够读取并上传文件内容:把本地文件名告诉远程服务器,并不会上传文档。
让 Agent 调用 get_capabilities,说明当前支持的转换格式。如果它无法发现工具,先解决连接问题,再上传文件或启动付费任务。
从一页 PDF 开始
下载并打开 PDFCraft 示例 PDF。文件包含 Paper to structured text.,可以用这句话检查转换结果。这是用于练习的小型输入文件,不能用来评估扫描书籍、表格或公式的识别质量。
通过客户端的附件入口提供 PDF,或将它放在 Agent 能读取的工作目录中,然后提出请求:
使用 PDFCraft,准备将附件中的示例 PDF 转成 Markdown。先检查支持的选项和我的余额,估算转换费用,在开始处理前把估算结果给我看。保留任务 UUID,方便之后继续查询同一个任务。
查看费用估算,确认后再授权开始处理:
开始转成 Markdown,间隔查询进度直到完成,然后把完整结果下载到当前工作目录。告诉我任务 UUID 和文件保存位置。如果失败,先展示错误,不要直接创建另一个任务。
服务的处理流程是创建任务、上传文件、启动处理、查询进度,再获取下载链接。能发现工具,并不代表上传或转换已经成功。在保存并检查结果前,请保留任务 UUID。
先检查结果,再生成摘要
打开下载结果。如果是压缩包,先解压,再检查 Markdown 和附带的资源文件。可以让 Agent 执行:
打开转换后的 Markdown,检查是否包含“Paper to structured text.”。展示对应段落,并与示例 PDF 对照。如果缺少文字,请指出,不要自行补全。
找到这句话,只能初步确认输出对应预期的输入。处理自己的文档时,还应对照原文检查标题、段落顺序、表格、数字和脚注。摘要读起来通顺,也可能掩盖数字或公式的识别错误。
检查转换结果后,再让 Agent 使用保存的文本:
根据这份 Markdown 整理五点摘要。每一点附上一小段原文作为依据,有标题时注明来源标题。保留原始 Markdown,不要修改。
摘要由 Agent 根据转换结果生成,PDFCraft 提供文档处理工具。保存 Markdown 后,后续提问可以复用这份文本,无需每次重新转换同一个 PDF。
中断后继续查询原任务
如果处理过程中对话或客户端中断,把保存的任务 UUID 交给新的会话,让它查询原任务。不要因为看不到原会话的进度,就重新启动一次转换。
下载链接过期时,只要任务文件仍然可用,就可以为同一个任务重新获取链接。如果余额不足阻止了完整下载,充值后再请求结果。具体状态与恢复方式见 PDFCraft 的任务生命周期与恢复指南。请在文件过期前保存完成的结果。
转成 EPUB 或翻译文档
PDFCraft 还支持 PDF 转 EPUB,以及 PDF 或 EPUB 翻译。如果要把书放到电子阅读器中阅读,可以选择 EPUB 输出。需要翻译时,让 Agent 通过 get_capabilities 检查支持的语言,确认目标语言,并在处理前估算费用。
按接下来的用途选择格式:检查和复用文本时选择 Markdown,阅读书籍时选择 EPUB。处理大型文档前,先用一份有代表性的小文档检查效果。
将文本用于工作应用
检查 Markdown 后,你可能想把摘要保存到工作应用,或附在某个项目中。通过 OOMOL Agent 快速开始接入对应应用,并在让 Agent 写入前明确保存位置。PDFCraft 转换服务器与 OOMOL 已连接的 Apps 需要分别配置。
如果只想在浏览器中压缩、合并或拆分 PDF,可以打开 PDFCraft 在线 PDF 工具。需要由 Agent 执行转换时,从 PDFCraft MCP 接入指南开始。