1---
2name: firecrawl-download
3description: |
4  Download an entire website as local files — markdown, screenshots, or multiple formats per page. Use this skill when the user wants to save a site locally, download documentation for offline use, bulk-save pages as files, or says "download the site", "save as local files", "offline copy", "download all the docs", or "save for reference". Combines site mapping and scraping into organized local directories.
5allowed-tools:
6  - Bash(firecrawl *)
7  - Bash(npx firecrawl *)
8---
9 
10# firecrawl download
11 
12> **Experimental.** Convenience command that combines `map` + `scrape` to save an entire site as local files.
13 
14Maps the site first to discover pages, then scrapes each one into nested directories under `.firecrawl/`. All scrape options work with download. Always pass `-y` to skip the confirmation prompt.
15 
16## When to use
17 
18- You want to save an entire site (or section) to local files
19- You need offline access to documentation or content
20- Bulk content extraction with organized file structure
21 
22## Quick start
23 
24```bash
25# Interactive wizard (picks format, screenshots, paths for you)
26firecrawl download https://docs.example.com
27 
28# With screenshots
29firecrawl download https://docs.example.com --screenshot --limit 20 -y
30 
31# Multiple formats (each saved as its own file per page)
32firecrawl download https://docs.example.com --format markdown,links --screenshot --limit 20 -y
33# Creates per page: index.md + links.txt + screenshot.png
34 
35# Filter to specific sections
36firecrawl download https://docs.example.com --include-paths "/features,/sdks"
37 
38# Skip translations
39firecrawl download https://docs.example.com --exclude-paths "/zh,/ja,/fr,/es,/pt-BR"
40 
41# Full combo
42firecrawl download https://docs.example.com \
43  --include-paths "/features,/sdks" \
44  --exclude-paths "/zh,/ja" \
45  --only-main-content \
46  --screenshot \
47  -y
48```
49 
50## Download options
51 
52| Option                    | Description                                              |
53| ------------------------- | -------------------------------------------------------- |
54| `--limit <n>`             | Max pages to download                                    |
55| `--search <query>`        | Filter URLs by search query                              |
56| `--include-paths <paths>` | Only download matching paths                             |
57| `--exclude-paths <paths>` | Skip matching paths                                      |
58| `--allow-subdomains`      | Include subdomain pages                                  |
59| `-y`                      | Skip confirmation prompt (always use in automated flows) |
60 
61## Scrape options (all work with download)
62 
63`-f <formats>`, `-H`, `-S`, `--screenshot`, `--full-page-screenshot`, `--only-main-content`, `--include-tags`, `--exclude-tags`, `--wait-for`, `--max-age`, `--country`, `--languages`
64 
65## See also
66 
67- [firecrawl-map](../firecrawl-map/SKILL.md) — just discover URLs without downloading
68- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — scrape individual pages
69- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extract as JSON (not local files)
70