firecrawl agent

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

基于AI的自动提取工具。该Agent可浏览网站并提取结构化数据（耗时2-5分钟）。

Quick start

快速开始

bash

undefined

bash

undefined

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.

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


运行`firecrawl agent --help`查看完整选项列表。

**完成标志：** 输出文件包含符合请求的有效JSON，或者已返回可用于后续轮询的任务ID。

Job IDs

任务ID

Omitting

--wait

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

bash

undefined

省略

--wait

参数会返回任务ID。系统会自动将UUID识别为状态检查请求：

bash

undefined

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

undefined

firecrawl agent "<job-id>" --cancel

undefined

Tips

小贴士

Use
```
--wait
```
for inline results; omit it only when you want a job ID to poll later (see 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.

使用
```
--wait
```
参数获取即时结果；仅当需要任务ID以便后续轮询时才省略该参数（详见任务ID）。
使用
```
--schema
```
参数获取可预测的结构化输出——否则Agent会返回自由格式数据。
Agent运行消耗的积分比简单爬取更多。使用
```
--max-credits
```
参数限制花费。
对于简单的单页面提取，优先使用
```
scrape
```
——速度更快且成本更低。

另请参阅

firecrawl-scrape — simpler single-page extraction
firecrawl-interact — scrape + interact for manual page interaction (more control)
firecrawl-crawl — bulk extraction without AI

firecrawl-scrape — 更简单的单页面提取工具
firecrawl-interact — 爬取+交互工具，支持手动页面操作（控制度更高）
firecrawl-crawl — 无AI的批量提取工具

firecrawl-agent

Original

Translation

firecrawl agent

firecrawl agent

Quick start

快速开始

Extract structured data

Extract structured data

With a JSON schema for structured output

With a JSON schema for structured output

Focus on specific pages

Focus on specific pages

Job IDs

任务ID

Check once (equivalent to adding --status)

Check once (equivalent to adding --status)

Wait on an existing job, polling every 10 seconds for up to 5 minutes

Wait on an existing job, polling every 10 seconds for up to 5 minutes

Cancel an active job

Cancel an active job

Tips

小贴士

See also

另请参阅