# Web サイトのモニター

> スケジュールに沿って Web サイトをクロールし、見つかったすべてのページの変更を検出します

import CreateCrawlCURL from "/snippets/ja/v2/monitor/create/crawl/curl.mdx";
import CreateCrawlNode from "/snippets/ja/v2/monitor/create/crawl/js.mdx";
import CreateCrawlPython from "/snippets/ja/v2/monitor/create/crawl/python.mdx";
import TargetCrawl from "/snippets/ja/v2/monitor/target/crawl.mdx";

Web サイトモニターは、固定された URL のリストではなく、サイト全体を対象にします。各チェックでは対象の `url` に対してクロールを実行し、見つかったすべてのページをスクレイピングしたうえで、その結果を直近で保持されたスナップショットと照合します。これにより、あらかじめ指定したページへの編集だけでなく、追加・変更・削除されたページも検知できます。ドキュメントサイト、ブログ、更新履歴、ヘルプセンター、競合他社のサイトには最適な選択肢です。

このページでは `crawl` ターゲットを扱います。スケジューリング、ゴールと判定、変更追跡、通知、料金は、すべてのモニタータイプで共通です。[モニターの概要](/ja/features/monitoring) を参照してください。

<div id="create-a-website-monitor">
  ## Web サイトモニターを作成する
</div>

各チェック時にクロールで検出されたすべてのページの差分を取得するには、`crawl` ターゲットを持つモニターを作成します。

<CodeGroup>
  <CreateCrawlPython />

  <CreateCrawlNode />

  <CreateCrawlCURL />
</CodeGroup>

<div id="crawl-target">
  ## クロールターゲット
</div>

`crawl` ターゲットでは、`type` と 1 つの `url` が必要です。クロールの挙動は `crawlOptions`、検出された各ページをどのようにスクレイピングするかは `scrapeOptions` で指定します。

<TargetCrawl />

一般的な `crawlOptions` フィールド:

* `limit`: 1 回のチェックでクロールするページの最大数。
* `maxDiscoveryDepth`: 開始 `url` から何リンク先までページを検出するか。
* `maxDepth`: クロールの最大深度。
* `includePaths`: これらのパスパターンに一致する URL のみをモニターします (例: `/docs`) 。
* `excludePaths`: これらのパスパターンに一致する URL はスキップします。

ページ モニターと同様に、モニターによってトリガーされるスクレイピングでは `maxAge` のデフォルト値が `0` になるため、`scrapeOptions` で別の `maxAge` を設定しない限り、各チェックで検出されたページは毎回新たにスクレイピングされます。

<div id="what-each-check-reports">
  ## 各チェックで報告される内容
</div>

クロールチェックでは、検出されたすべてのページを前回のチェック結果と照合し、ページごとのステータスを記録します。

* `same`: ページが再度検出され、変更はありませんでした。
* `changed`: ページが再度検出され、変更がありました。
* `new`: ページが初めて検出されました。
* `removed`: 前回のチェックで検出されたページが、今回は検出されませんでした。
* `error`: ページをチェックできませんでした。

クロールされたページ全体の特定の構造化フィールドに対してアラートを出すには、`scrapeOptions` に `changeTracking` フォーマットを追加してください。[変更追跡](/ja/features/monitoring#change-tracking) を参照してください。

<div id="shared-configuration">
  ## 共通の構成
</div>

* [スケジュール](/ja/features/monitoring#schedules): cron または自然言語で設定する実行間隔。最短 5 分です。
* [ゴールと判定](/ja/features/monitoring#goals-and-judging): 意味のある変更があった場合にのみ通知します。
* [通知](/ja/features/monitoring#notifications): webhook とメールで配信します。
* [チェック結果](/ja/features/monitoring#check-results): 各チェックとページごとの差分を確認できます。
* [料金](/ja/features/monitoring#pricing): チェックごとに、検出された各ページにつき 1 クレジットを消費し、これに加えて任意の判定分が発生します。