About firecrawl-download
firecrawl-download is a Firecrawl CLI skill for mapping a site and saving its pages as files in nested directories. It supports multiple output formats and screenshots, with path filtering for downloads.
Key features
- 01Map a site to discover pages
- 02Save pages in nested directories
- 03Write multiple formats per page
- 04Capture screenshots
- 05Filter by URL paths
Use cases
- 01Save a documentation site locally
- 02Download selected sections of a site
- 03Keep page text, links, and screenshots together
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ firecrawl/ firecrawl-claude-plugin --skill firecrawl-downloadAfter installing, type/firecrawl-downloadin Claude Code to confirm it loaded.
Details
From the project READMEfirecrawl download (invoked as firecrawl x download)
Experimental.
downloadis available under thefirecrawl xcommand group.
Prerequisite: download requires authentication (no keyless free tier); without credentials the CLI prompts an interactive login.
Maps the site origin first to discover pages, then scrapes each one into nested directories under .firecrawl/. Use --include-paths to scope a non-root URL to one section. Automated runs always pass -y — without it the command opens an interactive wizard that blocks on a prompt.
Quick start
# With screenshots
firecrawl x download https://docs.example.com --screenshot --limit 20 -y
# Multiple formats (each saved as its own file per page)
firecrawl x download https://docs.example.com --format markdown,links --screenshot --limit 20 -y
# Creates per page: index.md + links.txt + screenshot.png
# Filter to specific sections
firecrawl x download https://docs.example.com --include-paths "/features,/sdks" -y
# Skip translations
firecrawl x download https://docs.example.com --exclude-paths "/zh,/ja,/fr,/es,/pt-BR" -y
Run firecrawl x download --help for the full option list, including which scrape options download supports.
Done when: the command exits successfully and the expected files exist under .firecrawl/.
See also
- firecrawl-map — just discover URLs without downloading
- firecrawl-scrape — scrape individual pages
- firecrawl-crawl — bulk extract as JSON (not local files)
- firecrawl-build-scrape — building bulk extraction into an app instead of running it here