firecrawl scrape
Scrape one or more URLs. Returns clean, LLM-optimized markdown. Multiple URLs are scraped concurrently.
When to use
- You have a specific URL and want its content
- The page is static or JS-rendered (SPA)
- Step 2 in the workflow escalation pattern: search → scrape → map → crawl → interact
Quick start
# Basic markdown extraction
firecrawl scrape "<url>" -o .firecrawl/page.md
# Main content only, no nav/footer
firecrawl scrape "<url>" --only-main-content -o .firecrawl/page.md
# Wait for JS to render, then scrape
firecrawl scrape "<url>" --wait-for 3000 -o .firecrawl/page.md
# Multiple URLs (each saved to .firecrawl/)
firecrawl scrape https://example.com https://example.com/blog https://example.com/docs
# Get markdown and links together
firecrawl scrape "<url>" --format markdown,links -o .firecrawl/page.json
# Ask a question about the page
firecrawl scrape "https://example.com/pricing" --query "What is the enterprise plan price?"
Options
| Option |
Description |
-f, --format <formats> |
Output formats: markdown, html, rawHtml, links, screenshot, json |
-Q, --query <prompt> |
Ask a question about the page content (5 credits) |
-H |
Include HTTP headers in output |
--only-main-content |
Strip nav, footer, sidebar — main content only |
--wait-for <ms> |
Wait for JS rendering before scraping |
--include-tags <tags> |
Only include these HTML tags |
--exclude-tags <tags> |
Exclude these HTML tags |
-o, --output <path> |
Output file path |
Tips
- Prefer plain scrape over
--query. Scrape to a file, then use grep, head, or read the markdown directly — you can search and reason over the full content yourself. Use --query only when you want a single targeted answer without saving the page (costs 5 extra credits).
- Try scrape before interact. Scrape handles static pages and JS-rendered SPAs. Only escalate to
interact when you need interaction (clicks, form fills, pagination).
- Multiple URLs are scraped concurrently — check
firecrawl --status for your concurrency limit.
- Single format outputs raw content. Multiple formats (e.g.,
--format markdown,links) output JSON.
- Always quote URLs — shell interprets
? and & as special characters.
- Naming convention:
.firecrawl/{site}-{path}.md
See also
1---2name: firecrawl-scrape3description: Extracts clean, LLM-optimized markdown from any URL, including JavaScript-rendered SPAs, with support for concurrent scraping of multiple URLs and options like main-content-only extraction and custom output formats.4---56# firecrawl scrape78Scrape one or more URLs. Returns clean, LLM-optimized markdown. Multiple URLs are scraped concurrently.910## When to use1112- You have a specific URL and want its content13- The page is static or JS-rendered (SPA)14- Step 2 in the [workflow escalation pattern](firecrawl-cli): search → **scrape** → map → crawl → interact1516## Quick start1718```bash19# Basic markdown extraction20firecrawl scrape "<url>" -o .firecrawl/page.md2122# Main content only, no nav/footer23firecrawl scrape "<url>" --only-main-content -o .firecrawl/page.md2425# Wait for JS to render, then scrape26firecrawl scrape "<url>" --wait-for 3000 -o .firecrawl/page.md2728# Multiple URLs (each saved to .firecrawl/)29firecrawl scrape https://example.com https://example.com/blog https://example.com/docs3031# Get markdown and links together32firecrawl scrape "<url>" --format markdown,links -o .firecrawl/page.json3334# Ask a question about the page35firecrawl scrape "https://example.com/pricing" --query "What is the enterprise plan price?"36```3738## Options3940| Option | Description |41| ------------------------ | ---------------------------------------------------------------- |42| `-f, --format <formats>` | Output formats: markdown, html, rawHtml, links, screenshot, json |43| `-Q, --query <prompt>` | Ask a question about the page content (5 credits) |44| `-H` | Include HTTP headers in output |45| `--only-main-content` | Strip nav, footer, sidebar — main content only |46| `--wait-for <ms>` | Wait for JS rendering before scraping |47| `--include-tags <tags>` | Only include these HTML tags |48| `--exclude-tags <tags>` | Exclude these HTML tags |49| `-o, --output <path>` | Output file path |5051## Tips5253- **Prefer plain scrape over `--query`.** Scrape to a file, then use `grep`, `head`, or read the markdown directly — you can search and reason over the full content yourself. Use `--query` only when you want a single targeted answer without saving the page (costs 5 extra credits).54- **Try scrape before interact.** Scrape handles static pages and JS-rendered SPAs. Only escalate to `interact` when you need interaction (clicks, form fills, pagination).55- Multiple URLs are scraped concurrently — check `firecrawl --status` for your concurrency limit.56- Single format outputs raw content. Multiple formats (e.g., `--format markdown,links`) output JSON.57- Always quote URLs — shell interprets `?` and `&` as special characters.58- Naming convention: `.firecrawl/{site}-{path}.md`5960## See also6162- [firecrawl-search](../firecrawl-search/SKILL.md) — find pages when you don't have a URL63- [firecrawl-interact](../firecrawl-interact/SKILL.md) — when scrape can't get the content, use `interact` to click, fill forms, etc.64- [firecrawl-download](../firecrawl-download/SKILL.md) — bulk download an entire site to local files
Scoheart