Agent Skills
› firecrawl/cli
› firecrawl-agent
firecrawl-agent
GitHub用于自主导航网站并提取结构化数据的 Agent，支持多页面抓取、JSON Schema 约束输出及异步任务管理。适用于获取定价、产品列表等复杂数据场景。
触发场景
需要从多个网页提取结构化数据
需要按特定 JSON Schema 格式输出网页内容
安装
npx skills add firecrawl/cli --skill firecrawl-agent -g -y
SKILL.md
Frontmatter
{
"name": "firecrawl-agent",
"description": "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.\n",
"allowed-tools": [
"Bash(firecrawl *)",
"Bash(npx firecrawl-cli *)"
]
}
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
--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
版本历史
-
86aaf06
当前 2026-08-27 16:50
重构文档结构，移除过时选项表与重复说明，优化触发描述以减少Token消耗，新增完成标准。
-
253abde
2026-08-19 19:06
修复了之前版本中关于CLI命令、参数及行为描述的错误声明和示例。
- 6c50c5d 2026-07-24 11:49
