changedetection.io README

The project's README from github.com/dgtlmoon/changedetection.io. As one markdown file: README.md.

Detect Website Changes Automatically — Monitor Web Page Changes in Real Time

Monitor websites for updates — get notified via Discord, Email, Slack, Telegram, Webhook and many more.

Detect web page content changes and get instant alerts.

Ideal for monitoring price changes, content edits, conditional changes and more.

Web site page change monitoring

Release Version Docker Pulls License

changedetection.io

Get started with website page change monitoring straight away. Don't have time? Try our $8.99/month subscription, use our proxies and support! , half the price of other website change monitoring services!

AI-powered website change detection — smart alerts and plain-language summaries

Stop drowning in noise. Connect any LLM (OpenAI, Gemini, Anthropic, Ollama and more) and go from "something changed" to "only the thing you care about changed".

AI change detection rules — write a plain-English intent once: "notify me only when the price drops below $50", "alert me when the item comes back in stock", "ignore navigation and footer changes". The AI evaluates every detected diff against your intent and silently suppresses everything irrelevant. Fewer false positives, zero noise.

AI change summaries — instead of staring at a raw diff, your notification reads "Price dropped from $89.99 to $67.00" or "3 new products added to the listing". Works globally or per-watch, with full control over the prompt.

Works with any model you already pay for — GPT-4o-mini and Gemini Flash handle this well at fractions of a cent per check. Or run it entirely locally with Ollama, vLLM, LM Studio, or any OpenAI-compatible self-hosted endpoint — pick the OpenAI-compatible (vLLM, LM Studio, llama.cpp) option in the provider dropdown and point it at your server's /v1 URL. Powered by LiteLLM, giving you seamless access to 100+ supported providers and models.

AI-powered website change detection — plain language change summaries and smart alert rules

Note: Available in our subscription/hosted service from June 2026

Target specific parts of the webpage using the Visual Selector tool.

Available when connected to a playwright content fetcher (included as part of our subscription service)

Select parts and elements of a web page to monitor for changes

Easily see what changed, examine by word, line, or individual character.

Self-hosted web page change monitoring context difference

Perform interactive browser steps

Fill in text boxes, click buttons and more, setup your changedetection scenario.

Using the Browser Steps configuration, add basic steps before performing change detection, such as logging into websites, adding a product to a cart, accept cookie logins, entering dates and refining searches.

Website change detection with interactive browser steps, detect changes behind login and password, search queries and more

After Browser Steps have been run, then visit the Visual Selector tab to refine the content you're interested in. Requires Playwright to be enabled.

Awesome restock and price change notifications

Enable the "Re-stock & Price detection for single product pages" option to activate the best way to monitor product pricing, this will extract any meta-data in the HTML page and give you many options to follow the pricing of the product.

Easily organise and monitor prices for products from the dashboard, get alerts and notifications when the price of a product changes or comes back in stock again!

Easily keep an eye on product price changes directly from the UI

Set price change notification parameters, upper and lower price, price change percentage and more. Always know when a product for sale drops in price.

Set upper lower and percentage price change notification values

Example use cases

Need an actual Chrome runner with Javascript support? We support fetching via WebDriver and Playwright!

Key Features

We recommend and use Bright Data global proxy services, Bright Data will match any first deposit up to $150 using our signup link.

Please :star: star :star: this project and help it grow! https://github.com/dgtlmoon/changedetection.io/

Conditional web page changes

Easily configure conditional actions, for example, only trigger when a price is above or below a preset amount, or when a web page includes (or does not include) a keyword

Conditional web page changes

Schedule web page watches in any timezone, limit by day of week and time.

Easily set a re-check schedule, for example you could limit the web page change detection to only operate during business hours. Or perhaps based on a foreign timezone (for example, you want to check for the latest news-headlines in a foreign country at 0900 AM),

How to monitor web page changes according to a schedule

Includes quick short-cut buttons to setup a schedule for business hours only, or weekends.

We have a Chrome extension!

Easily add the current web page to your changedetection.io tool, simply install the extension and click "Sync" to connect it to your existing changedetection.io install.

Chrome Extension to easily add the current web-page to detect a change.

Goto the Chrome Webstore to download the extension. ( Or check out the GitHub repo )

Installation

Docker

With Docker composer, just clone this repository and..

$ docker compose up -d

Docker standalone

$ docker run -d --restart always -p "127.0.0.1:5000:5000" -v datastore-volume:/datastore --name changedetection.io dgtlmoon/changedetection.io

:latest tag is our latest stable release, :dev tag is our bleeding edge master branch.

Alternative docker repository over at ghcr - ghcr.io/dgtlmoon/changedetection.io

Windows

See the install instructions at the wiki https://github.com/dgtlmoon/changedetection.io/wiki/Microsoft-Windows

Python Pip

Check out our pypi page https://pypi.org/project/changedetection.io/

$ pip3 install changedetection.io
$ changedetection.io -d /path/to/empty/data/dir -p 5000

Then visit http://127.0.0.1:5000 , You should now be able to access the UI.

Now with per-site configurable support for using a fast built in HTTP fetcher or use a Chrome based fetcher for monitoring of JavaScript websites!

Updating changedetection.io

Docker

docker pull dgtlmoon/changedetection.io
docker kill $(docker ps -a -f name=changedetection.io -q)
docker rm $(docker ps -a -f name=changedetection.io -q)
docker run -d --restart always -p "127.0.0.1:5000:5000" -v datastore-volume:/datastore --name changedetection.io dgtlmoon/changedetection.io

docker compose

docker compose pull && docker compose up -d

See the wiki for more information https://github.com/dgtlmoon/changedetection.io/wiki

Different browser viewport sizes (mobile, desktop etc)

If you are using the recommended sockpuppetbrowser (which is in the docker-compose.yml as a setting to be uncommented) you can easily set different viewport sizes for your web page change detection, see more information here about setting up different viewport sizes.

Filters

XPath(1.0), JSONPath, jq, and CSS support comes baked in! You can be as specific as you need, use XPath exported from various XPath element query creation tools. (We support LXML re:test, re:match and re:replace.)

Notifications

ChangeDetection.io supports a massive amount of notifications (including email, office365, custom APIs, etc) when a web-page has a change detected thanks to the apprise library. Simply set one or more notification URL's in the [edit] tab of that watch.

Just some examples

discord://webhook_id/webhook_token
flock://app_token/g:channel_id
gitter://token/room
gchat://workspace/key/token
msteams://TokenA/TokenB/TokenC/
o365://TenantID:AccountEmail/ClientID/ClientSecret/TargetEmail
rocket://user:password@hostname/#Channel
mailto://user:[email protected][email protected]
json://someserver.com/custom-api
syslog://

And everything else in this list!

Self-hosted web page change monitoring notifications

Now you can also customise your notification content and use Jinja2 templating for their title and body!

JSON API Monitoring

Detect changes and monitor data in JSON API's by using either JSONPath or jq to filter, parse, and restructure JSON as needed.

image

This will re-parse the JSON and apply formatting to the text, making it super easy to monitor and detect changes in JSON API results

image

JSONPath or jq?

For more complex parsing, filtering, and modifying of JSON data, jq is recommended due to the built-in operators and functions. Refer to the documentation for more specific information on jq.

One big advantage of jq is that you can use logic in your JSON filter, such as filters to only show items that have a value greater than/less than etc.

See the wiki https://github.com/dgtlmoon/changedetection.io/wiki/JSON-Selector-Filter-help for more information and examples

Parse JSON embedded in HTML!

When you enable a json: or jq: filter, you can even automatically extract and parse embedded JSON inside a HTML page! Amazingly handy for sites that build content based on JSON, such as many e-commerce websites.

<html>
...
<script type="application/ld+json">

{
   "@context":"http://schema.org/",
   "@type":"Product",
   "offers":{
      "@type":"Offer",
      "availability":"http://schema.org/InStock",
      "price":"3949.99",
      "priceCurrency":"USD",
      "url":"https://www.newegg.com/p/3D5-000D-001T1"
   },
   "description":"Cobratype King Cobra Hero Desktop Gaming PC",
   "name":"Cobratype King Cobra Hero Desktop Gaming PC",
   "sku":"3D5-000D-001T1",
   "itemCondition":"NewCondition"
}
</script>

json:$..price or jq:..price would give 3949.99, or you can extract the whole structure (use a JSONpath test website to validate with)

The application also supports notifying you that it can follow this information automatically

Proxy Configuration

See the wiki https://github.com/dgtlmoon/changedetection.io/wiki/Proxy-configuration , we also support using Bright Data proxy services where possible and Oxylabs proxy services.

Raspberry Pi support?

Raspberry Pi and linux/arm/v6 linux/arm/v7 arm64 devices are supported! See the wiki for details

Import support

Easily import your list of websites to watch for changes in Excel .xslx file format, or paste in lists of website URLs as plaintext.

Excel import is recommended - that way you can better organise tags/groups of websites and other features.

API Support

Full REST API for programmatic management of watches, tags, notifications and more.

Support us

Do you use changedetection.io to make money? does it save you time or money? Does it make your life easier? less stressful? Remember, we write this software when we should be doing actual paid work, we have to buy food and pay rent just like you.

Consider taking out an officially supported website change detection subscription , even if you don't use it, you still get the warm fuzzy feeling of helping out the project. (And who knows, you might just use it!)

Commercial Support

I offer commercial support, this software is depended on by network security, aerospace , data-science and data-journalist professionals just to name a few, please reach out at [email protected] for any enquiries, I am more than glad to work with your organisation to further the possibilities of what can be done with changedetection.io

Disclaimer

This software is provided "as-is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.

Website content monitoring

You are solely responsible for ensuring that your use of this software complies with the terms of service, robots.txt directives, access policies, and all applicable laws of any website or service you choose to monitor. The authors and contributors

changedetection.io (dgtlmoon/changedetection.io)

Searching Database…

这是什么?changedetection.io 用于监控网站变化,当内容更新、价格下降、商品补货或页面被篡改时,向你发送提醒。
它是浏览器插件,还是需要我自己运行的独立应用?它是一个自托管的网页应用,有自己的界面(可通过 Docker 或 pip 运行)。另外还有一个可选的 Chrome 插件,可以把当前页面添加到你正在运行的实例中。
怎样才能让它跑起来?最简单的方法是使用 Docker Compose(克隆仓库后运行),或通过 pip 从 PyPI 安装,然后访问本地界面;Windows 在 wiki 中有单独的安装说明。
处理依赖大量 JavaScript 的网站时,我需要 Chrome 或 Playwright 吗?对于普通 HTML 页面,它可以使用内置的快速 HTTP 抓取器工作;但依赖 JavaScript 渲染的网站,需要启用基于 Chrome/Playwright 的抓取器(通过 WebDriver 或 Playwright)。
浏览器步骤(登录、点击、填写表单)无需额外设置就能用吗?交互式浏览器步骤(登录、点击、填写表单)需要启用 Playwright,基础抓取器默认不开启这一功能。
除了追踪价格的爱好者,还有谁在用它?安全、航空航天、数据科学和数据新闻领域的专业人士都在使用它,人们也用它追踪补货、价格下降、法律文件变动和招聘信息。
能在树莓派上运行吗?可以,支持树莓派以及其他 ARM 设备(arm/v6、arm/v7、arm64)。
我可以用 AI 过滤掉变更提醒中的无关信息吗?可以,你可以接入任意大语言模型(OpenAI、Gemini、Anthropic、Ollama、vLLM、LM Studio,或通过 LiteLLM 接入的任何 OpenAI 兼容接口),并用一条通俗的规则设置条件,例如「只在价格跌破 $50 时通知我」。这样无关的差异会被屏蔽,通知中还会附上通俗易懂的摘要。
它能监控 JSON API,而不只是 HTML 页面吗?可以,它支持使用 JSONPath 和 jq 过滤器来解析、重组 JSON API 响应并检测其中的变化,甚至可以提取 HTML 页面中嵌入的 JSON。
它能自动追踪价格下降和补货吗?可以,有一个「Re-stock & Price detection」选项,它会从页面中提取商品元数据,让你设置价格上下限和涨跌幅提醒,并在商品重新有货时收到通知。
如果我不想自己托管,有付费的托管版本吗?有,提供 SaaS 订阅服务,每月 $8.99 起,包含 Chrome 浏览器和代理,无需安装。
Creator
dgtlmoon
Size
50.1 MB
Stars
35.1K
Age
5y
Commits · 90 Days