About firecrawl-parse
firecrawl-parse is a skill for converting local documents into Markdown files, with an option to create an AI summary. It is intended for workflows that need to inspect extracted content without sending a large document directly to the terminal.
Key features
- 01Convert PDF, DOCX, ODT, RTF, XLSX, and HTML files
- 02Write parsed Markdown to disk
- 03Generate an AI summary
- 04Inspect output with bounded reads
Use cases
- 01Extract text from a local PDF for review
- 02Create a Markdown summary of a document
- 03Read large parsed files incrementally
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ firecrawl/ firecrawl-claude-plugin --skill firecrawl-parseAfter installing, type/firecrawl-parsein Claude Code to confirm it loaded.
Details
From the project READMEfirecrawl parse
Turn a local document into clean markdown on disk. Supports PDF, DOCX, DOC, ODT, RTF, XLSX, XLS, HTML/HTM.
Quick start
Always save to .firecrawl/ with -o — parsed docs can be hundreds of KB and blow up context if streamed to stdout. Add .firecrawl/ to .gitignore.
mkdir -p .firecrawl
# File → markdown
firecrawl parse ./paper.pdf -o .firecrawl/paper.md
# AI summary
firecrawl parse ./paper.pdf -S -o .firecrawl/paper-summary.md
# Ask a question about the doc
firecrawl parse ./paper.pdf -Q "What are the main conclusions?" \
-o .firecrawl/paper-qa.md
Then read the output incrementally with head, grep, or rg.
Run firecrawl parse --help for the full option list.
Done when: the markdown, summary, or answer is written under .firecrawl/ and you have inspected it with bounded reads.
Tips
- Quote paths with spaces:
firecrawl parse "./My Doc.pdf" -o .firecrawl/mydoc.md. - Max upload size: 50 MB per file.
- Credits: ~1 per PDF page; HTML is 1 flat.
- Check
.firecrawl/before re-parsing the same file. - To check your credit balance (recommended for batch processing and similar workflows), use
firecrawl credit-usage(requires authentication).
See also
- firecrawl-scrape — same idea for URLs
- firecrawl-build-scrape — building document extraction into an app instead of running it here