$npx -y skills add firecrawl/cli --skill firecrawl-crawlBulk extract content from an entire website or site section. Use this skill when the user wants to crawl a site, extract all pages from a docs section, bulk-scrape multiple pages following links, or says "crawl", "get all the pages", "extract everything under /docs", "bulk extrac
| 1 | # firecrawl crawl |
| 2 | |
| 3 | Bulk extract content from a website. Crawls pages following links up to a depth/limit. |
| 4 | |
| 5 | ## When to use |
| 6 | |
| 7 | - You need content from many pages on a site (e.g., all `/docs/`) |
| 8 | - You want to extract an entire site section |
| 9 | - Step 4 in the [workflow escalation pattern](firecrawl-cli): search → scrape → map → **crawl** → interact |
| 10 | |
| 11 | ## Quick start |
| 12 | |
| 13 | ```bash |
| 14 | # Crawl a docs section |
| 15 | firecrawl crawl "<url>" --include-paths /docs --limit 50 --wait -o .firecrawl/crawl.json |
| 16 | |
| 17 | # Full crawl with depth limit |
| 18 | firecrawl crawl "<url>" --max-depth 3 --wait --progress -o .firecrawl/crawl.json |
| 19 | |
| 20 | # Check status of a running crawl |
| 21 | firecrawl crawl <job-id> |
| 22 | ``` |
| 23 | |
| 24 | ## Options |
| 25 | |
| 26 | | Option | Description | |
| 27 | | ------------------------- | ------------------------------------------- | |
| 28 | | `--wait` | Wait for crawl to complete before returning | |
| 29 | | `--progress` | Show progress while waiting | |
| 30 | | `--limit <n>` | Max pages to crawl | |
| 31 | | `--max-depth <n>` | Max link depth to follow | |
| 32 | | `--include-paths <paths>` | Only crawl URLs matching these paths | |
| 33 | | `--exclude-paths <paths>` | Skip URLs matching these paths | |
| 34 | | `--delay <ms>` | Delay between requests | |
| 35 | | `--max-concurrency <n>` | Max parallel crawl workers | |
| 36 | | `--pretty` | Pretty print JSON output | |
| 37 | | `-o, --output <path>` | Output file path | |
| 38 | |
| 39 | ## Tips |
| 40 | |
| 41 | - Always use `--wait` when you need the results immediately. Without it, crawl returns a job ID for async polling. |
| 42 | - Use `--include-paths` to scope the crawl — don't crawl an entire site when you only need one section. |
| 43 | - Crawl consumes credits per page. Check `firecrawl credit-usage` before large crawls. |
| 44 | |
| 45 | ## See also |
| 46 | |
| 47 | - [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — scrape individual pages |
| 48 | - [firecrawl-map](../firecrawl-map/SKILL.md) — discover URLs before deciding to crawl |
| 49 | - [firecrawl-download](../firecrawl-download/SKILL.md) — download site to local files (uses map + scrape) |