firecrawl agent
AI-powered autonomous extraction. The agent navigates sites and extracts structured data (takes 2-5 minutes).
When to use
You need structured data from complex multi-page sites
Manual scraping would require navigating many pages
You want the AI to figure out where the data lives
Quick start
firecrawl agent
"extract all pricing tiers"
--wait
-o
.firecrawl/pricing.json
With a JSON schema for structured output
firecrawl agent
"extract products"
--schema
'{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}'
--wait
-o
.firecrawl/products.json
Focus on specific pages
firecrawl agent
"get feature list"
--urls
""
--wait
-o
.firecrawl/features.json
Options
Option
Description
--urls
Starting URLs for the agent
--model
Model to use: spark-1-mini or spark-1-pro
--schema
JSON schema for structured output
--schema-file
Path to JSON schema file
--max-credits
Credit limit for this agent run
--wait
Wait for agent to complete
--pretty
Pretty print JSON output
-o, --output
Output file path
Tips
Always use
--wait
to get results inline. Without it, returns a job ID.
Use
--schema
for predictable, structured output — otherwise the agent returns freeform data.
Agent runs consume more credits than simple scrapes. Use
--max-credits
to cap spending.
For simple single-page extraction, prefer
scrape
— it's faster and cheaper.
See also
firecrawl-scrape
— simpler single-page extraction
firecrawl-interact
— scrape + interact for manual page interaction (more control)
firecrawl-crawl
— bulk extraction without AI