firecrawl download (invoked as firecrawl x download )

Experimental. download is available under the firecrawl x command 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. Supported scrape options are listed below. Always pass -y to skip the confirmation prompt.

When to use

• You want to save an entire site (or section) to local files

• You need offline access to documentation or content

• Bulk content extraction with organized file structure

Quick start

# Interactive wizard (humans at a TTY only — agents must pass -y or the command blocks on a prompt)

firecrawl x download https://docs.example.com

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

Full combo

firecrawl x download https://docs.example.com

--include-paths "/features,/sdks"

--exclude-paths "/zh,/ja"

--only-main-content

--screenshot

-y

## Download options

| Option                    | Description                                              |

| ------------------------- | -------------------------------------------------------- |

| `--limit <n>`             | Max pages to download                                    |

| `--search <query>`        | Filter URLs by search query                              |

| `--include-paths <paths>` | Only download matching paths                             |

| `--exclude-paths <paths>` | Skip matching paths                                      |

| `--allow-subdomains`      | Include subdomain pages                                  |

| `-y`                      | Skip confirmation prompt (always use in automated flows) |

## Supported scrape options

Only the options listed below are supported:

`-f <formats>`, `-H`, `-S`, `--lockdown`, `--screenshot`, `--full-page-screenshot`, `--only-main-content`, `--include-tags`, `--exclude-tags`, `--wait-for`, `--max-age`, `--country`, `--languages`

## See also

- [firecrawl-map](../firecrawl-map/SKILL.md) — just discover URLs without downloading

- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — scrape individual pages

- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extract as JSON (not local files)