firecrawl-download

Downloads websites as local markdown files and screenshots using the Firecrawl CLI.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/agents --skill firecrawl-download-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: firecrawl-download
Source: https://github.com/leonardoacosta/agents/tree/main/skills/firecrawl-download
Command: npx skills add https://github.com/leonardoacosta/agents --skill firecrawl-download-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Saving an entire website or documentation section for offline reference normally requires manual page-by-page copying. This Skill automates that by mapping a site's pages and scraping each one into local files under a .firecrawl/ directory. ## Core Features & Use Cases - Site Archiving: Maps the site origin to discover pages, then scrapes each into nested local directories as markdown, links, or screenshots. - Scoped Downloads: Uses --include-paths and --exclude-paths to limit downloads to specific sections or skip translated pages. - Multi-Format Output: Saves each page in multiple formats (e.g., index.md, links.txt, screenshot.png) per page. - Use Case: Download a product's documentation site with screenshots so your team has an offline reference copy for a migration project. ## Quick Start Ask the agent to download https://docs.example.com with screenshots and a page limit of 20 using the firecrawl download command.

Frequently Asked Questions about firecrawl-download

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download a website as markdown files with Firecrawl?

Run firecrawl x download with the target URL, for example firecrawl x download https://docs.example.com --screenshot --limit 20 -y. The command maps the site, scrapes each page, and saves files under the .firecrawl/ directory.

How to download only one section of a documentation site?

Use the --include-paths flag to scope the download, such as --include-paths "/features,/sdks". You can also pass --exclude-paths to skip sections like translated pages.

Does firecrawl download require authentication?

Yes, the download command requires authentication and has no keyless free tier. Without credentials the CLI prompts an interactive login before proceeding.

Why does firecrawl download hang in automated scripts?

Without the -y flag the command opens an interactive wizard that blocks on a prompt. Always pass -y in automated or non-interactive runs so the download proceeds without user input.

What is the difference between firecrawl download, crawl, and scrape?

Download saves pages as local files like markdown and screenshots under .firecrawl/. Scrape handles individual pages, while crawl bulk-extracts content as JSON rather than writing local files.