1---
2name: firecrawl-agent
3description: |
4  AI-powered autonomous data extraction that navigates complex sites and returns structured JSON. Use this skill when the user wants structured data from websites, needs to extract pricing tiers, product listings, directory entries, or any data as JSON with a schema. Triggers on "extract structured data", "get all the products", "pull pricing info", "extract as JSON", or when the user provides a JSON schema for website data. More powerful than simple scraping for multi-page structured extraction.
5allowed-tools:
6  - Bash(firecrawl *)
7  - Bash(npx firecrawl *)
8---
9 
10# firecrawl agent
11 
12AI-powered autonomous extraction. The agent navigates sites and extracts structured data (takes 2-5 minutes).
13 
14## When to use
15 
16- You need structured data from complex multi-page sites
17- Manual scraping would require navigating many pages
18- You want the AI to figure out where the data lives
19 
20## Quick start
21 
22```bash
23# Extract structured data
24firecrawl agent "extract all pricing tiers" --wait -o .firecrawl/pricing.json
25 
26# With a JSON schema for structured output
27firecrawl agent "extract products" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait -o .firecrawl/products.json
28 
29# Focus on specific pages
30firecrawl agent "get feature list" --urls "<url>" --wait -o .firecrawl/features.json
31```
32 
33## Options
34 
35| Option                 | Description                               |
36| ---------------------- | ----------------------------------------- |
37| `--urls <urls>`        | Starting URLs for the agent               |
38| `--model <model>`      | Model to use: spark-1-mini or spark-1-pro |
39| `--schema <json>`      | JSON schema for structured output         |
40| `--schema-file <path>` | Path to JSON schema file                  |
41| `--max-credits <n>`    | Credit limit for this agent run           |
42| `--wait`               | Wait for agent to complete                |
43| `--pretty`             | Pretty print JSON output                  |
44| `-o, --output <path>`  | Output file path                          |
45 
46## Tips
47 
48- Always use `--wait` to get results inline. Without it, returns a job ID.
49- Use `--schema` for predictable, structured output — otherwise the agent returns freeform data.
50- Agent runs consume more credits than simple scrapes. Use `--max-credits` to cap spending.
51- For simple single-page extraction, prefer `scrape` — it's faster and cheaper.
52 
53## See also
54 
55- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — simpler single-page extraction
56- [firecrawl-interact](../firecrawl-interact/SKILL.md) — scrape + interact for manual page interaction (more control)
57- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extraction without AI
58