用途：firecrawl-agent 面向需要自主导航网站并提取结构化数据的任务。当没有合适的现成工作流或数据提供方，或任务本身需要自主浏览多个页面时，可使用该工具。
主要能力：以 AI 驱动的方式自主提取，代理会导航站点并抽取结构化数据，官方说明耗时约 2-5 分钟。支持指定 JSON schema 以获得可预测的结构化输出；若不指定，则返回自由格式数据。支持通过 --urls 将提取聚焦在特定页面。支持以 --wait 内联等待结果，或省略该参数返回作业 ID 供后续轮询；UUID 位置参数会被自动识别为状态检查。可对已有作业等待（--poll-interval、--timeout）、取消（--cancel）。可用 --max-credits 限制额度消耗。
使用方式：开始自主提取前，建议先检查是否存在现成的 Alexandria 工作流或数据提供方：使用 firecrawl search alexandria '<data you need>'；若找到匹配契约，可用 firecrawl list <provider> <capability> --pretty 查看，并用 firecrawl scrape --alexandria <provider>/<capability> --options '<input JSON>' 执行，需使用契约中的确切 provider、capability 与输入字段。没有合适工具或任务需要自主导航时，再使用 Agent。示例命令包括：firecrawl agent "extract all pricing tiers" --wait --json -o .firecrawl/pricing.json；带 schema 的提取；以及用 --urls 聚焦页面。完成标志是输出文件包含回答请求的有效 JSON，或有意图地返回作业 ID 供后续轮询。完整选项见 firecrawl agent --help。
适用场景与限制：适合跨页面结构化记录或列表提取、需要自主导航的采集任务。简单单页提取应优先使用 scrape，更快且更便宜；Agent 运行比简单抓取消耗更多额度，可用 --max-credits 控制。另有 Alexandria 会话反馈命令，可用于报告会话结果或提供方/能力缺口，反馈不需要作业 ID，也没有作业时效期限和额度退款。