用途:对已知 URL 做周期性检查,检测内容变化并通过 webhook 或邮件通知,适合“监控/关注/追踪/有变化时提醒我”类需求。相比反复一次性抓取,同一 URL 需要多次检查时应优先使用监控。
主要能力:每次检查会把页面标记为 same、new、changed、removed 或 error。四种目标模式:单页用 --page <url>;URL 批量用 --scrape-urls <url,url,...>;整站用 --crawl-url <root-url>;网络搜索用 --queries <q,...> 加 --goal,每次运行查询并对未见过的结果告警(首次标 new,之后标 same),--goal 为必填。
使用方式:创建示例:firecrawl monitor create --name "Blog" --schedule "every 30 minutes" --goal "Alert when a new blog post is published." --page https://example.com/blog --email alerts@example.com。子命令包括 create、list、get、update、delete、run、checks、check。用 firecrawl monitor run <monitorId> 立即触发检查,便于创建后冒烟测试;用 --page-status changed 过滤检查页面。
限制与提示:每次检查消耗抓取、爬取或搜索及可选判断的额度;最小计划间隔 5 分钟;零数据保留团队不可用。外部邮件收件人需确认后才接收告警。遇到 HTTP 429 限流应退避约 30 秒重试一次,仍失败则停止并报告,不要循环重试。监控触发的抓取默认 maxAge 为 0,除非在 JSON 中显式设置 scrapeOptions.maxAge。可用 update --state paused 暂停,永久结束才删除。--retention-days 控制快照保留时长。编写或优化 --goal 时参考 goals.md,关注结构化字段差异时参考 json-tracking.md。