firecrawl-agent

AI-powered autonomous extraction of structured data from complex multi-page websites. Navigates sites intelligently to locate and extract data, returning results as JSON with optional schema validation Supports custom JSON schemas for predictable structured output, or freeform extraction when schema is not provided Offers two model tiers (spark-1-mini and spark-1-pro) with credit limits and optional waiting for inline results Best suited for multi-page extraction tasks; use simpler scrape or crawl skills for single-page or bulk extraction without AI reasoning

INSTALLATION
npx skills add https://github.com/firecrawl/cli --skill firecrawl-agent
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2b

Focus on specific pages

firecrawl agent "get feature list" --urls "" --wait -o .firecrawl/features.json

## Options

| Option                 | Description                               |

| ---------------------- | ----------------------------------------- |

| `--urls <urls>`        | Starting URLs for the agent               |

| `--model <model>`      | Model to use: spark-1-mini or spark-1-pro |

| `--schema <json>`      | JSON schema for structured output         |

| `--schema-file <path>` | Path to JSON schema file                  |

| `--max-credits <n>`    | Credit limit for this agent run           |

| `--wait`               | Wait for agent to complete                |

| `--pretty`             | Pretty print JSON output                  |

| `-o, --output <path>`  | 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](../firecrawl-scrape/SKILL.md) — simpler single-page extraction

- [firecrawl-interact](../firecrawl-interact/SKILL.md) — scrape + interact for manual page interaction (more control)

- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extraction without AI
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card