firecrawl-agent
작성자: firecrawl
AI 기반 자율 추출로 복잡한 다중 페이지 웹사이트에서 구조화된 데이터를 추출합니다. 사이트를 지능적으로 탐색하여 데이터를 찾고 추출하며, 선택적 스키마 검증을 통해 JSON 형식으로 결과를 반환합니다. 예측 가능한 구조화된 출력을 위한 사용자 정의 JSON 스키마를 지원하거나, 스키마가 제공되지 않은 경우 자유 형식 추출을 지원합니다. 크레딧 한도와 선택적 인라인 결과 대기를 제공하는 두 가지 모델 티어(spark-1-mini 및 spark-1-pro)를 제공합니다. 다중 페이지 추출 작업에 가장 적합하며, 단순 스크래핑이나...
npx skills add https://github.com/firecrawl/cli --skill firecrawl-agentfirecrawl agent
AI-powered autonomous extraction. The agent navigates sites and extracts structured data (takes 2-5 minutes).
When to use
- You need structured data from complex multi-page sites
- Manual scraping would require navigating many pages
- You want the AI to figure out where the data lives
Quick start
# Extract structured data
firecrawl agent "extract all pricing tiers" --wait -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 -o .firecrawl/products.json
# Focus on specific pages
firecrawl agent "get feature list" --urls "<url>" --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
--waitto get results inline. Without it, returns a job ID. - 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