Skip to content

changedetection.io

changedetection.io watches web pages for changes. This shows each watch with what it last saw and when it changed, puts failures first, and lets the assistant read, add, check and remove watches.

config.yaml
integrations:
changedetection:
type: changedetection
url: http://changedetection:5000
key: ${CHANGEDETECTION_KEY}
href: https://watch.example.com
layout:
- title: Apps
widgets:
- changedetection.status
OptionTypeDefaultWhat it does
urlURLrequiredWhere the service answers, from Valet’s side.
hrefstringoptionalWhere the card links to, when that differs from url.
keystringrequiredIts API key. Use ${VAR}.
limitwhole number8Rows on the card. Each reads its latest snapshot once. Range 1 to 50.

2 widgets. Each key starts with your instance name, here changedetection.

changedetection.status · stats card · refreshes every 5 minutes while the page is open.

changedetection.io, changedetection.io, small size
Small
changedetection.io, changedetection.io, wide size
Wide
changedetection.io, changedetection.io, medium size
Medium
changedetection.io, changedetection.io, large size
Large
changedetection.io, changedetection.io, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

changedetection.io changedetection.io: Can't reach it
Can't reach it

changedetection.watches · list card · refreshes every minute while the page is open.

changedetection.io, Watching, small size
Small
changedetection.io, Watching, wide size
Wide
changedetection.io, Watching, medium size
Medium
changedetection.io, Watching, tall size
Tall
changedetection.io, Watching, large size
Large
changedetection.io, Watching, in chat
In chat
changedetection.io Watching: A watch failing
A watch failing
changedetection.io Watching: Nothing watched yet
Nothing watched yet
changedetection.io Watching: Can't reach it
Can't reach it

What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.

ToolAccessWhat it does
watches_listreadEvery page changedetection.io watches: title, URL, when it was last checked and last changed, whether the change is unseen, and any error.
watch_readreadOne watch by id (watches_list finds it): what it last saved and what was added in its latest change.
watch_addwriteStart watching a web page for changes.
watch_recheckcontrolCheck one watch now rather than at its next turn.
watch_removecontrolStop watching a page and delete its history.

What the page’s own buttons and controls can do. They need a signed-in person or a trusted network.

ActionWhat it does
recheckCheck every watch now

Slides this integration adds to the recap.

Recap slide: You are keeping an eye on 3 pages. If any of them change, you hear about it first.
You are keeping an eye on 3 pages