Agent Skills › firecrawl/cli › firecrawl-download

firecrawl-download

GitHub

将网站完整下载为本地文件，支持Markdown、截图等多格式。适用于离线保存文档或批量抓取内容。需认证，通过firecrawl x download命令执行，结合站点映射与抓取生成目录结构。

skills/firecrawl-download/SKILL.md firecrawl/cli

Trigger Scenarios

用户希望将网站保存到本地文件需要离线访问文档或内容批量提取内容并整理为文件结构

Install

npx skills add firecrawl/cli --skill firecrawl-download -g -y

More Options

Use without installing

npx skills use firecrawl/cli@firecrawl-download

指定 Agent (Claude Code)

npx skills add firecrawl/cli --skill firecrawl-download -a claude-code -g -y

安装 repo 全部 skill

npx skills add firecrawl/cli --all -g -y

预览 repo 内 skill

npx skills add firecrawl/cli --list

SKILL.md

Frontmatter

{
    "name": "firecrawl-download",
    "description": "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.\n",
    "allowed-tools": [
        "Bash(firecrawl *)",
        "Bash(npx firecrawl-cli *)"
    ]
}

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

firecrawl-download