跳至主要內容
← 返回部落格

透過 PDFCraft MCP 將 PDF 轉為 Markdown

為 AI Agent 接入 PDFCraft MCP,用範例 PDF 完成 Markdown 轉換、檢查結果,再將文字用於摘要和文件處理。

OOMOL

自然光下翻閱書籍的讀者,配文讓閱讀超越 PDF

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 接入指南開始。