About firecrawl-crawl
firecrawl crawl is a skill in the Firecrawl CLI for bulk extracting content from a website by following links up to a depth or page limit. It requires authentication, and is aimed at users who need many pages from one site saved locally.
Key features
- 01Crawls pages by depth and page limit
- 02Scopes crawls with include-paths
- 03Waits for results with a wait flag
- 04Returns a job ID for asynchronous polling
- 05Saves output to local files
Use cases
- 01Extracting a documentation section in bulk
- 02Checking credit usage before large crawls
- 03Saving site content locally for later processing
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ firecrawl/ cli --skill firecrawl-crawlAfter installing, type/firecrawl-crawlin Claude Code to confirm it loaded.
Details
From the project READMEfirecrawl crawl
Bulk extract content from a website. Crawls pages following links up to a depth/limit.
Prerequisite: crawl requires authentication (no keyless free tier); without credentials the CLI prompts an interactive login.
Quick start
# Crawl a docs section
firecrawl crawl "<url>" --include-paths /docs --limit 50 --wait -o .firecrawl/crawl.json
# Full crawl with depth limit
firecrawl crawl "<url>" --max-depth 3 --wait --progress -o .firecrawl/crawl.json
# Check status of a running crawl
firecrawl crawl <job-id>
Run firecrawl crawl --help for the full option list.
Done when: the crawl reaches a terminal status and the saved output under .firecrawl/ contains the expected pages.
Tips
- Use
--waitwhen you need the results immediately. It has no default timeout; use--timeout <seconds>to bound polling. Without--wait, crawl returns a job ID for async polling. - Scope crawls with
--include-pathswhenever the request names a section — crawl only the pages you need. - Crawl consumes credits per page. Check
firecrawl credit-usagebefore large crawls (credit-usagerequires authentication).
See also
- firecrawl-scrape — scrape individual pages
- firecrawl-map — discover URLs before deciding to crawl
- firecrawl-download — download site to local files (uses map + scrape)
- firecrawl-build-scrape — building bulk extraction into an app instead of running it here
Comments
Markdown supported