firecrawl/cli · Official

firecrawl-agent

Autonomous multi-page extraction into structured JSON. Use when the user wants website data matching a schema — pricing tiers, product listings — beyond a single-page scrape.

All-time #366 Trending #2236 Hot #6079 First seen Mar 10, 2026
8-week activity · all time api

Installation

$ npx skills add firecrawl/cli --skill firecrawl-agent

Summary

  • 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

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Apr 9, 2026

This skill is safe and provides a legitimate interface for using the Firecrawl CLI to perform autonomous data extraction from websites. All external resources and tools identified are associated with the skill's author and represent standard functionality.

snyk MEDIUM

Analyzed Apr 9, 2026

[MEDIUM] W011: Third-party content exposure detected (indirect prompt injection risk).

socket Score 0.9000 · 0 alerts

Analyzed Apr 9, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from firecrawl/cli · top by installs.

npx skills add firecrawl/cli

Browse all from firecrawl/cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 626
Default branch main
Open issues 16
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsBash(firecrawl *), Bash(npx firecrawl-cli *)

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,366 B
  • docs SUMMARY.md 201 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 79,066 installs

Videos

Tutorials, guides, and showcases specifically about this skill.

SKILL.md

firecrawl agent

AI-powered autonomous extraction. The agent navigates sites and extracts structured data (takes 2-5 minutes).

Quick start

# Extract structured data
firecrawl agent "extract all pricing tiers" --wait --json -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 --json -o .firecrawl/products.json

# Focus on specific pages
firecrawl agent "get feature list" --urls "<url>" --wait --json -o .firecrawl/features.json

Run firecrawl agent --help for the full option list.

Done when: the output file contains valid JSON answering the request — or a job ID was intentionally returned for later polling.

Job IDs

Omitting --wait returns a job ID. A UUID positional argument is auto-detected as a status check:

# Check once (equivalent to adding --status)
firecrawl agent "<job-id>"

# Wait on an existing job, polling every 10 seconds for up to 5 minutes
firecrawl agent "<job-id>" --wait --poll-interval 10 --timeout 300

# Cancel an active job
firecrawl agent "<job-id>" --cancel

Tips

  • Use --wait for inline results; omit it only when you want a job ID to poll later (see [Job IDs](#job-ids)).
  • 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
  • firecrawl-build-scrape — building structured extraction into an app instead of running it here