firecrawl-crawl
작성자: firecrawl
전체 웹사이트 또는 사이트 섹션에서 깊이 및 경로 필터링을 통해 대량으로 콘텐츠를 추출합니다. 링크를 따라 페이지를 크롤링하며, 설정 가능한 깊이 제한과 페이지 수 제한, 경로 포함/제외 필터를 통해 추출 범위를 조정합니다. --wait 및 --progress 플래그를 통해 비동기 작업 폴링 또는 진행률 표시와 함께 동기 대기를 지원합니다. 에이전트 워크플로우 통합을 위해 동시성 제어, 요청 지연 및 JSON 출력 형식을 제공합니다. 검색 → 스크래핑 → ...의 4단계 에스컬레이션 패턴의 일부입니다.
npx skills add https://github.com/firecrawl/cli --skill firecrawl-crawlfirecrawl 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
# 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>
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
--waitwhen you need the results immediately. Without it, crawl returns a job ID for async polling. - Use
--include-pathsto scope the crawl — don't crawl an entire site when you only need one section. - Crawl consumes credits per page. Check
firecrawl credit-usagebefore large crawls.
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)