firecrawl-parse
熱門高效提取並轉換任何本機檔案（如 PDF、DOCX、DOC、ODT、RTF、XLSX、XLS 或 HTML）的內容，轉換為乾淨、格式良好的 Markdown 並儲存至磁碟。當使用者要求解析、讀取或從電腦上的檔案中提取資訊時，包括「解析這個 PDF」、「轉換這份文件」、「讀取這個檔案」、「從中提取文字」等用語，或提供本機檔案路徑（非網址）時，請使用此技能。此技能提供進階選項，例如生成 AI 驅動的摘要以及根據檔案內容回答問題。處理本機檔案時，優先使用此工具而非 `scrape`，以便為後續任務提供精確、結構化的輸出。
Efficiently extract and convert the contents of any local file—such as PDF, DOCX, DOC, ODT, RTF, XLSX, XLS, or HTML—into clean, well-formatted markdown saved to disk. Use this skill whenever the user requests to parse, read, or extract information from a file on their computer, including phrases like “parse this PDF”, “convert this document”, “read this file”, “extract text from”, or when a local file path (not a URL) is provided. This skill offers advanced options like generating AI-powered summaries and answering questions based on the file's content. Prefer this tool over `scrape` when handling local files to deliver precise, structured outputs for downstream tasks.
firecrawl parse
將本機文件轉換為乾淨的 Markdown 並儲存至磁碟。支援 PDF、DOCX、DOC、ODT、RTF、XLSX、XLS、HTML/HTM/XHTML。
使用時機
- 您有磁碟上的檔案（非網址）並希望將其文字轉為 Markdown
- 使用者丟出 PDF/DOCX 並詢問內容，或要求摘要
- 當來源是網址時，請改用
scrape
快速開始
務必使用 -o 儲存至 .firecrawl/ 目錄 — 解析後的文件可能達數百 KB，若直接輸出至 stdout 會佔用大量上下文。將 .firecrawl/ 加入 .gitignore。
mkdir -p .firecrawl
# 檔案 → markdown
firecrawl parse ./paper.pdf -o .firecrawl/paper.md
# AI 摘要
firecrawl parse ./paper.pdf -S -o .firecrawl/paper-summary.md
# 詢問關於文件的問題
firecrawl parse ./paper.pdf -Q "主要結論是什麼？" \
-o .firecrawl/paper-qa.md
接著使用 head、grep、rg 等指令，或逐步讀取檔案 — 不要一次載入整個檔案。
選項
| 選項 | 說明 |
|---|---|
-S, --summary |
AI 生成的摘要 |
-Q, --query <prompt> |
針對解析內容提出問題 |
-o, --output <path> |
輸出檔案路徑 — 務必使用此選項 |
-f, --format <fmt> |
markdown（預設）、html、summary |
--timeout <ms> |
解析工作的逾時時間 |
--timing |
顯示請求持續時間 |
提示
- 路徑含空格時請用引號：
firecrawl parse "./My Doc.pdf" -o .firecrawl/mydoc.md。 - 最大上傳大小：每個檔案 50 MB。
- 點數消耗：PDF 每頁約 1 點；HTML 固定 1 點。
- 重新解析相同檔案前，請先檢查
.firecrawl/目錄。 - 若要查詢點數餘額（建議用於批次處理等類似工作流程），請使用
firecrawl credit-usage指令。
另請參閱
- firecrawl-scrape — 相同概念但用於網址
