wigolo-watch

name	wigolo-watch
description	Monitor a page for changes over time. Create lazy watch jobs on one or many URLs, list them, and check for changes on demand — with optional SSRF-guarded webhook delivery when a change is detected. Use when the user says "monitor this page", "watch this URL for changes", "tell me when this updates", "track this changelog", "notify me if this changes", or wants recurring change detection on web content.
license	AGPL-3.0-only
metadata	{"author":"KnockOutEZ","version":"0.1.43-beta.2","homepage":"https://github.com/KnockOutEZ/wigolo","repository":"https://github.com/KnockOutEZ/wigolo"}

wigolo watch

Track a page over time. Register a watch job on a URL (or many), then check it to see whether the content changed since the last snapshot. Optionally deliver a webhook when a change fires.

Lazy execution model — there is no background daemon. A job's check runs when you call action: "check", or opportunistically when another tool runs and the job is overdue. Set realistic interval_seconds (minimum 60).

Quick Reference

// Create a single-URL watch (checks no more than once every 6 hours)
{ "action": "create", "url": "https://nodejs.org/en/blog", "interval_seconds": 21600 }

// Batch create across several URLs
{ "action": "create", "urls": ["https://a.example.com", "https://b.example.com"], "interval_seconds": 3600 }

// Scope the diff to a subtree
{ "action": "create", "url": "https://example.com/pricing", "interval_seconds": 86400, "selector": "#pricing-table" }

// Deliver a webhook on change (SSRF-guarded)
{ "action": "create", "url": "https://example.com/status", "interval_seconds": 300, "notification": "https://hooks.example.com/wigolo" }

// List all jobs
{ "action": "list" }

// Check one job now
{ "action": "check", "job_id": "job_abc123" }

// Pause / resume / delete
{ "action": "pause", "job_id": "job_abc123" }
{ "action": "resume", "job_id": "job_abc123" }
{ "action": "delete", "job_id": "job_abc123" }

Parameters

Parameter	Type	Default	When to use
action	string	required	"create", "list", "check", "pause", "resume", "delete"
url	string	none	Single-URL create. Mutually exclusive with urls
urls	string[]	none	Batch create. Response carries jobs[] only
interval_seconds	number	none	Required for create. Minimum check interval (min 60)
selector	string	none	Create-only CSS selector to scope the diff to a subtree
notification	string	"inline"	"inline" (return on next check) or a webhook URL
job_id	string	none	Required for check, pause, resume, delete

Single-URL create returns job (singular) plus jobs: [job] (legacy). Batch create returns jobs[] only.

How It Works

1. create — registers the job and takes a baseline snapshot of the page (or the selector subtree).
2. check — re-fetches, diffs against the last snapshot, and reports changed/unchanged. On change it advances the snapshot and, if a webhook is configured, delivers it.
3. list / pause / resume / delete — manage the job set.

Webhook delivery is SSRF-guarded: the server validates the destination before posting, so a job cannot be pointed at internal or loopback addresses.

Anti-Patterns

• DON'T set interval_seconds below 60 — the minimum is enforced.
• DON'T expect checks to fire on their own — this is a lazy model; call check (or rely on overdue opportunistic runs).
• DON'T pass both url and urls — they are mutually exclusive.

When NOT to use wigolo-watch

• One-off comparison of two versions — use diff instead.
• Bulk change detection across the whole cache on demand — use cache with check_changes: true.

See Also

• wigolo-diff — one-shot version comparison
• wigolo-cache — on-demand bulk change detection
• wigolo-fetch — the fetch each check runs under the hood