ChangeDetection.io MCP Server

ChangeDetection.io MCP サーバー

AI エージェントが ChangeDetection.io にネイティブにアクセスできるようにする MCP（Model Context Protocol）サーバーです。ChangeDetection.io は、オープンソースのウェブサイト変更検知・監視プラットフォームです。

機能

• 監視管理 — 監視対象の作成、一覧表示、更新、削除、および再チェックの実行
• 変更履歴 — スナップショット履歴の閲覧と、任意の2つの時点間の差分の取得
• 監視対象ごとのアクションヒューズ — get_snapshot_diff は、後続の変更アクションに対して設定可能な上限を監視対象ごとに設定します。これにより、通知の多いページが無制限の再チェックや編集を連鎖的に引き起こすのを防ぎます
• タグ管理 — タグ／グループで監視対象を整理
• 検索 — URL またはタイトルで監視対象を全文検索
• システム情報 — ヘルス状態と統計情報をすばやく確認

このサーバーを作った理由

ChangeDetection.io は最も人気のあるセルフホスト型ツールの1つ（GitHub のスター数は31,000以上）であるにもかかわらず、MCP サーバーが存在しませんでした。このサーバーがその不足を補い、AI エージェントで次のことができるようにします。

• 「この商品ページを監視して、変更があったら知らせて」
• 「失敗した監視対象をすべて表示して」
• 「昨日、このページで何が変わった？」
• 「この求人情報の監視を設定して」

クイックスタート

前提条件

• 稼働中の ChangeDetection.io インスタンス（セルフホスト型または SaaS）
• Settings → API で取得した API キー

インストール

pip install changedetection-mcp

設定

MCP クライアントの設定（Claude Desktop、Cursor、Hermes Agent など）に追加します。

{
  "mcpServers": {
    "changedetection": {
      "command": "changedetection-mcp",
      "env": {
        "CHANGEDETECTION_BASE_URL": "http://localhost:5000",
        "CHANGEDETECTION_API_KEY": "your-api-key-here"
      }
    }
  }
}

Hermes Agent での使用

~/.hermes/skills/changedetection/SKILL.md を作成するか（skill/ ディレクトリを参照）、MCP サーバーとして設定します。

hermes mcp add changedetection --command "changedetection-mcp"
hermes config set changedetection.base_url "http://localhost:5000"
hermes config set changedetection.api_key "your-api-key"

API 対応状況

ツール	説明
list_watches	すべての監視対象を一覧表示します（オプションでタグによる絞り込み、件数とオフセットを指定）
get_watch	単一の監視対象の詳細をすべて取得します
create_watch	URL から新しい監視対象を作成します
update_watch	既存の監視対象を更新します（一時停止、名前の変更、スケジュールの変更など）
delete_watch	監視対象とその履歴をすべて削除します
recheck_watch	すぐに再チェックを実行します
get_watch_history	監視対象の変更履歴スナップショットを一覧表示します
get_snapshot_diff	2つのスナップショット間の差分を取得します
search_watches	URL またはタイトルで全文検索します
list_tags	すべてのタグ／グループを一覧表示します
create_tag	整理用のタグを作成します
get_system_info	サーバーの統計情報（監視対象数、稼働時間、バージョン）を取得します

安全ヒューズ：監視対象ごとのアクション上限

エージェントがページの差分を要求すると、その差分を受けて、すぐに再チェックする、監視対象を編集する、削除するといった後続アクションが行われることがあります。通知の多いサイトが連鎖的なアクションを引き起こすのを防ぐため、get_snapshot_diff は差分を返す前に監視対象ごとのヒューズを設定します。

デフォルトでは、各差分につき、その監視対象に対して変更を伴う MCP アクションを3回実行できます。ヒューズは次のツールに適用されます。

• recheck_watch
• update_watch
• delete_watch

上限に達すると、これらのツールは ChangeDetection.io API を呼び出す代わりに、ブロックされたことを明示するメッセージを返します。ヒューズはプロセス内で監視対象の UUID ごとに管理されます。ヒューズが設定されていない監視対象には影響しません。

設定：

# Default: 3. Set 0 to disable the fuse globally.
export CHANGEDETECTION_MCP_ACTION_LIMIT_PER_WATCH=3

呼び出しごとに、get_snapshot_diff のオプション引数 action_limit を使ってデフォルト値を上書きできます。

get_snapshot_diff(uuid="...", from_timestamp="previous", to_timestamp="latest", action_limit=1)

action_limit=0 を指定すると、その監視対象のヒューズを無効にできます。または、より大きな値を指定して get_snapshot_diff を再度呼び出すと、ヒューズを再設定できます。

開発

git clone https://github.com/rusty4444/changedetection-mcp.git
cd changedetection-mcp
uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

ライセンス

MIT — LICENSE を参照してください。