firecrawl-monitor

firecrawl monitor

ウェブサイト上のコンテンツの変更を検知し、Webhook またはメールで通知を受け取ります。Firecrawl がサーバー側で取得、差分検出、判定、通知を処理します。チェック内の各ページには、same、new、changed、removed、error のいずれかが付与されます。

監視対象に応じて、対象モードを選択してください。

モード	フラグ	監視対象
単一ページ	--page <url>	変更のある1つのURL
URLの一括指定	--scrape-urls <url,url,...>	変更のある複数のURL
サイト全体	--crawl-url <root-url>	クロールで検出された変更のあるすべてのページ
Web検索	--queries <q,...> + --goal	目標に一致する新しい検索結果をウェブ全体から検索

最初の3つは、すでに把握しているURLを監視します。Web検索では、チェックのたびにクエリを実行し、これまでに見つかっていない結果を通知します（初回は new、以降のチェックでは same とラベル付けされます）。--queries を指定する場合は --goal が必須です。

クイックスタート

# Single page, natural-language schedule, email alert
firecrawl monitor create --name "Blog" --schedule "every 30 minutes" \
  --goal "Alert when a new blog post is published." \
  --page https://example.com/blog \
  --email [email protected]

# Web monitor — search the whole web for NEW results matching a goal
firecrawl monitor create --name "Competitor launches" --schedule "daily at 9:00" \
  --queries "competitor product launch,competitor funding round" \
  --goal "Alert when a competitor announces a new product or raises funding." \
  --search-window 7d --max-results 20 \
  --email [email protected]

# Webhook notifications
firecrawl monitor create --name "Docs webhook" --schedule "every 30 minutes" \
  --goal "Alert when docs content changes." \
  --page https://example.com/docs \
  --webhook-url https://example.com/hook \
  --webhook-events monitor.page,monitor.check.completed

# Manage and inspect
firecrawl monitor list --limit 20
firecrawl monitor get <monitorId>
firecrawl monitor run <monitorId>             # trigger a check now
firecrawl monitor checks <monitorId>          # list all checks
firecrawl monitor check <monitorId> <checkId> --page-status changed
firecrawl monitor update <monitorId> --state paused
firecrawl monitor delete <monitorId>

サブコマンド：create | list | get | update | delete | run | checks | check。すべてのオプションを確認するには、firecrawl monitor <subcommand> --help を実行してください。

完了条件： create がモニターIDを返し、スモークテストとして run と check を実行して、想定どおりの対象、状態、通知設定であることを確認します。

--goal の作成や調整（Webモニターの場合は --queries も含む）については、goals.md を参照してください。ユーザーが特定の構造化フィールド（価格、見出し、在庫フラグなど）を重視し、フィールドごとの差分を必要とする場合は、json-tracking.md を参照してください。

制約とヒント

• 各チェックでは、基盤となるスクレイプ、クロール、または検索に加えて、任意の判定にもクレジットが使用されます。モニタリングの料金を参照してください。
• スケジュールの最小間隔は5分です。データ保持ゼロのチームではモニタリングを利用できません。
• 同じURLを複数回チェックしたい場合は、その都度スクレイプするのではなく、1つのモニターを使用してください。
• 一時的に停止するには update --state paused を使用してください。delete はモニターが完全に不要になった場合に限って使用します。（--state は更新用のフラグで、--status はCLIのグローバルステータスフラグです。）
• --page-status changed（または new、removed、error）でチェック対象のページを絞り込み、same のページによるノイズを省けます。
• firecrawl monitor run <id> はチェックを即座に実行します。モニター作成直後のスモークテストに便利です。
• --retention-days は差分検出用スナップショットの保存期間を制御します。高頻度で監視する場合は、ストレージを節約するために値を小さくしてください。
• 外部のメール受信者はオプトインが必要です。 初めて追加された際に、Firecrawl から確認メールが送信され、受信者は確認後にのみ通知を受け取ります。チーム所有のアドレスは自動的に確認済みになります。受信登録を解除した受信者に確認メールを再送信するには、オーナーがその受信者を再度追加する必要があります。
• HTTP 429／レート制限エラーが発生した場合は、一度だけ待機して再試行してください。約30秒待ってから一度だけ再試行します。解消しない場合は中止し、作業を妨げている理由としてレート制限を報告して、この作業で作成したモニターを削除してください。繰り返し再試行してはいけません。
• モニターによって実行されるスクレイプでは、maxAge のデフォルト値は 0 です。JSONペイロードで scrapeOptions.maxAge を明示的に設定しない限り、チェックのたびに新しいスクレイプが実行されます。

関連項目

• firecrawl-scrape — 単発のスクレイプ。定期的なチェックが必要になったら monitor に切り替えます
• firecrawl-crawl — 単発のクロール。クロールの差分を定期的に確認するには、こちらと --crawl-url を組み合わせます
• firecrawl — ワークフローの概要ガイド
• firecrawl-build-scrape — ここで実行するのではなく、アプリに定期チェックを組み込む方法