
firecrawl-agent
โ Officialโ 7by firecrawl ยท part of firecrawl/firecrawl-cursor-plugin
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.
This is the playbook your agent receives when the skill activates โ you don't need to read it to use the skill, but it's here to audit before installing.
firecrawl agent
AI-powered autonomous extraction. The agent navigates sites and extracts structured data (takes 2-5 minutes).
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>" --cancelTips
- Use
--waitfor inline results; omit it only when you want a job ID to poll later (see Job IDs). - Use
--schemafor predictable, structured output โ otherwise the agent returns freeform data. - Agent runs consume more credits than simple scrapes. Use
--max-creditsto 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
- firecrawl-build-scrape โ building structured extraction into an app instead of running it here
npx skills add firecrawl/firecrawl-cursor-plugin --skill "firecrawl-agent" --full-depthRun this in your project โ your agent picks the skill up automatically.
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.jsonRun 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.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.