本地文档转 Markdown 或问答时用…

当输入是本地文件路径（PDF、DOCX、XLSX、HTML 等）而非 URL 时，将其解析为 Markdown 或就内容提问。

适用场景

解决思路

1. 始终用 `-o` 把结果保存到 `.firecrawl/` 目录，避免解析结果（可能数百 KB）直接输出到 stdout 撑爆上下文。
2. 先执行 `mkdir -p .firecrawl` 创建输出目录，并把 `.firecrawl/` 加入 `.gitignore`。
3. 文件转 Markdown：`firecrawl parse ./paper.pdf -o .firecrawl/paper.md`。
4. 生成 AI 摘要：`firecrawl parse ./paper.pdf -S -o .firecrawl/paper-summary.md`。
5. 就文档提问：`firecrawl parse ./paper.pdf -Q "What are the main conclusions?" -o .firecrawl/paper-qa.md`。
6. 解析后用 `head`、`grep` 或 `rg` 增量读取输出文件，而不是一次性全读。
7. 运行 `firecrawl parse --help` 查看完整选项列表。
8. 路径含空格时加引号：`firecrawl parse "./My Doc.pdf" -o .firecrawl/mydoc.md`。
9. 注意单文件最大上传 50 MB。
10. 注意额度消耗：约每页 PDF 1 credit，HTML 固定 1 credit。
11. 重新解析同一文件前先检查 `.firecrawl/` 是否已有结果。
12. 批量处理等场景下可用 `firecrawl credit-usage` 查看额度余额（需认证）。

适用边界 · 注意事项

• 输入是 URL 而非本地文件路径时（应改用 firecrawl-scrape）。
• 需要把文档提取能力集成进应用而非本地运行时（应改用 firecrawl-build-scrape）。