AGENT SKILL

wigolo-watch

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
最近更新
2026-10-08
Stars
★ 11
Forks
3

01 前言 Front Matter

name
wigolo-watch
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" }
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.

03 SKILL.md 正文

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

04 同仓库更多 Skills