| name | firecrawl-crawl |
| description | Bulk 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 extract", or needs content from many pages on the same site. Handles depth limits, path filtering, and concurrent extraction.
|
| allowed-tools | ["Bash(firecrawl *)","Bash(npx firecrawl *)"] |
firecrawl crawl
Bulk extract content from a website. Crawls pages following links up to a depth/limit.
When to use
- You need content from many pages on a site (e.g., all
/docs/)
- You want to extract an entire site section
- Step 4 in the workflow escalation pattern: search → scrape → map → crawl → interact
Quick start
firecrawl crawl "<url>" --include-paths /docs --limit 50 --wait -o .firecrawl/crawl.json
firecrawl crawl "<url>" --max-depth 3 --wait --progress -o .firecrawl/crawl.json
firecrawl crawl <job-id>
Options
| Option | Description |
|---|
--wait | Wait for crawl to complete before returning |
--progress | Show progress while waiting |
--limit <n> | Max pages to crawl |
--max-depth <n> | Max link depth to follow |
--include-paths <paths> | Only crawl URLs matching these paths |
--exclude-paths <paths> | Skip URLs matching these paths |
--delay <ms> | Delay between requests |
--max-concurrency <n> | Max parallel crawl workers |
--pretty | Pretty print JSON output |
-o, --output <path> | Output file path |
Tips
- Always use
--wait when you need the results immediately. Without it, crawl returns a job ID for async polling.
- Use
--include-paths to scope the crawl — don't crawl an entire site when you only need one section.
- Crawl consumes credits per page. Check
firecrawl credit-usage before large crawls.
See also
firecrawl-scrape — scrape individual pagesfirecrawl-map — discover URLs before deciding to crawlfirecrawl-download — download site to local files (uses map + scrape)
