Skip to content
Back to search

changedetection.io

Best and simplest tool for website change detection, web page monitoring, and website change alerts. Perfect for tracking content changes, price drops, restock alerts, and website defacement monitoring— MCP included! all for free or enjoy our SaaS plan!

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dgtlmoon/changedetection.io with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dgtlmoon/changedetection.io'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dgtlmoon--changedetection-io/badge.svg)](/listings/dgtlmoon--changedetection-io)

HTML

<a href="/listings/dgtlmoon--changedetection-io"><img src="/api/listings/dgtlmoon--changedetection-io/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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 docker.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](https://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!_

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 353 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [<img src="./docs/banner-wide.png" style="max-width:100%;" alt="AI LLM Web site page change monitoring" title="AI LLM Web site page change monitoring" />](https://changedetection.io?src=github)
  2. # Detect Website Changes Automatically — Monitor Web Page Changes in Real Time
  3. Monitor websites for updates — get notified via Discord, Email, Slack, Telegram, Webhook and many more — Ideal for monitoring price changes, content edits, conditional changes, LLM Change summaries and triggers just to name few features.
  4. [![Release Version][release-shield]][release-link] [![Docker Pulls][docker-pulls]][docker-link] [![License][license-shield]](LICENSE)
  5. [<img src="./docs/screenshot.png" style="max-width:100%;" alt="Web site page change monitoring" title="Web site page change monitoring" />](https://changedetection.io?src=github)
  6. ![changedetection.io](https://github.com/dgtlmoon/changedetection.io/actions/workflows/test-only.yml/badge.svg?branch=master)
  7. [**Get started with website page change monitoring straight away. Don't have time? Try our $8.99/month subscription, use our proxies and support!**](https://changedetection.io) , _Same open-source changedetection.io, minus the hard parts, No infrastructure to baby-sit._
  8. - Chrome browser included.
  9. - Nothing to install, access via browser login after signup.
  10. - Super fast, no registration needed setup.
  11. - Get started watching and receiving website change notifications straight away.
  12. - See our [tutorials and how-to page for more inspiration](https://changedetection.io/tutorials)
  13. ## AI-powered website change detection — smart alerts and plain-language summaries
  14. 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"_.
  15. **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.
  16. **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.
  17. 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](https://github.com/BerriAI/litellm), giving you seamless access to [100+ supported providers and models](https://docs.litellm.ai/docs/providers).
  18. We've got a quick tutorial here - [Bring your own LLM/AI Key to changedetection.io for change summaries and triggers.](https://changedetection.io/tutorial/ai-summary-and-change-detection-bring-your-own-key)
  19. [<img src="./docs/LLM-change-summary.jpeg" style="max-width:100%;" alt="AI-powered website change detection — plain language change summaries and smart alert rules" title="AI website change detection with LLM change summaries and intelligent alert filtering" />](https://changedetection.io?src=github)
  20. Yes - Even MCP is supported [https://changedetection.io/MCP](https://changedetection.io/MCP) - Easily connect Claude.AI / OpenAi and others to your changedetection.io dashboard - Now your web page changes become a resource for easily asking questions and building on.
  21. ### Target specific parts of the webpage using the Visual Selector tool.
  22. Available when connected to a <a href="https://github.com/dgtlmoon/changedetection.io/wiki/Playwright-content-fetcher">playwright content fetcher</a> (included as part of our subscription service)
  23. [<img src="https://raw.githubusercontent.com/dgtlmoon/changedetection.io/master/docs/visualselector-anim.gif" style="max-width:100%;" alt="Select parts and elements of a web page to monitor for changes" title="Select parts and elements of a web page to monitor for changes" />](https://changedetection.io?src=github)
  24. ### Easily see what changed, examine by word, line, or individual character.
  25. [<img src="https://raw.githubusercontent.com/dgtlmoon/changedetection.io/master/docs/screenshot-diff.png" style="max-width:100%;" alt="Self-hosted web page change monitoring context difference " title="Self-hosted web page change monitoring context difference " />](https://changedetection.io?src=github)
  26. ### Perform interactive browser steps
  27. Fill in text boxes, click buttons and more, setup your changedetection scenario.
  28. 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.
  29. [<img src="docs/browsersteps-anim.gif" style="max-width:100%;" alt="Website change detection with interactive browser steps, detect changes behind login and password, search queries and more" title="Website change detection with interactive browser steps, detect changes behind login and password, search queries and more" />](https://changedetection.io?src=github)
  30. After **Browser Steps** have been run, then visit the **Visual Selector** tab to refine the content you're interested in.
  31. Requires Playwright to be enabled.
  32. ### Awesome restock and price change notifications
  33. 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.
  34. 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!
  35. [<img src="docs/restock-overview.png" style="max-width:100%;" alt="Easily keep an eye on product price changes directly from the UI" title="Easily keep an eye on product price changes directly from the UI" />](https://changedetection.io?src=github)
  36. #### Monitor price change and restock trends over time as a graph, identify patterns, buy at the right time!
  37. [<img src="docs/price-tracking.jpeg" style="max-width:100%;" />](https://changedetection.io?src=github)
  38. Set price change notification parameters, upper and lower price, price change percentage and more.
  39. Always know when a product for sale drops in price.
  40. [<img src="docs/restock-settings.png" style="max-width:100%;" alt="Set upper lower and percentage price change notification values" title="Set upper lower and percentage price change notification values" />](https://changedetection.io?src=github)
  41. ### Example use cases
  42. - Products and services have a change in pricing
  43. - _Out of stock notification_ and _Back In stock notification_
  44. - Monitor and track PDF file changes, know when a PDF file has text changes.
  45. - Governmental department updates (changes are often only on their websites)
  46. - New software releases, security advisories when you're not on their mailing list.
  47. - Festivals with changes
  48. - Discogs restock alerts and monitoring
  49. - Realestate listing changes
  50. - Know when your favourite whiskey is on sale, or other special deals are announced before anyone else
  51. - COVID related news from government websites
  52. - University/organisation news from their website
  53. - Detect and monitor changes in JSON API responses
  54. - JSON API monitoring and alerting
  55. - Changes in legal and other documents
  56. - Trigger API calls via notifications when text appears on a website
  57. - Glue together APIs using the JSON filter and JSON notifications
  58. - Create RSS feeds based on changes in web content
  59. - Monitor HTML source code for unexpected changes, strengthen your PCI compliance
  60. - You have a very sensitive list of URLs to watch and you do _not_ want to use the paid alternatives. (Remember, _you_ are the product)
  61. - Get notified when certain keywords appear in Twitter search results
  62. - Proactively search for jobs, get notified when companies update their careers page, search job portals for keywords.
  63. - Get alerts when new job positions are open on Bamboo HR and other job platforms
  64. - Website defacement monitoring
  65. - Pokémon Card Restock Tracker / Pokémon TCG Tracker
  66. - RegTech - stay ahead of regulatory changes, regulatory compliance
  67. _Need an actual Chrome runner with Javascript support? We support fetching via WebDriver and Playwright!</a>_
  68. #### Key Features
  69. - Lots of trigger filters, such as "Trigger on text", "Remove text by selector", "Ignore text", "Extract text", also using regular-expressions!
  70. - Target elements with xPath 1 and xPath 2, CSS Selectors, Easily monitor complex JSON with JSONPath or jq
  71. - Switch between fast non-JS and Chrome JS based "fetchers"
  72. - Track changes in PDF files (Monitor text changed in the PDF, Also monitor PDF filesize and checksums)
  73. - Easily specify how often a site should be checked
  74. - Execute JS before extracting text (Good for logging in, see examples in the UI!)
  75. - Override Request Headers, Specify `POST` or `GET` and other methods
  76. - Use the "Visual Selector" to help target specific elements
  77. - Configurable [proxy per watch](https://github.com/dgtlmoon/changedetection.io/wiki/Proxy-configuration)
  78. - Send a screenshot with the notification when a change is detected in the web page
  79. We [recommend and use Bright Data](https://brightdata.grsm.io/n0r16zf7eivq) global proxy services, Bright Data will match any first deposit up to $150 using our signup link.
  80. Please :star: star :star: this project and help it grow! https://github.com/dgtlmoon/changedetection.io/
  81. ### Conditional web page changes
  82. Easily [configure conditional actions](https://changedetection.io/tutorial/conditional-actions-web-page-changes), 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](https://changedetection.io/tutorial/how-monitor-keywords-any-website)
  83. <img src="./docs/web-page-change-conditions.png" style="max-width:80%;" alt="Conditional web page changes" title="Conditional web page changes" />
  84. ### Schedule web page watches in any timezone, limit by day of week and time.
  85. Easily set a re-check schedule, for example you could limit the web page change detection to only operate during business hours.
  86. 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),
  87. <img src="./docs/scheduler.png" style="max-width:80%;" alt="How to monitor web page changes according to a schedule" title="How to monitor web page changes according to a schedule" />
  88. Includes quick short-cut buttons to setup a schedule for **business hours only**, or **weekends**.
  89. ### We have a Chrome extension!
  90. 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.
  91. [<img src="./docs/chrome-extension-screenshot.png" style="max-width:80%;" alt="Chrome Extension to easily add the current web-page to detect a change." title="Chrome Extension to easily add the current web-page to detect a change." />](https://chromewebstore.google.com/detail/changedetectionio-website/kefcfmgmlhmankjmnbijimhofdjekbop)
  92. [Goto the Chrome Webstore to download the extension.](https://chromewebstore.google.com/detail/changedetectionio-website/kefcfmgmlhmankjmnbijimhofdjekbop) ( Or check out the [GitHub repo](https://github.com/dgtlmoon/changedetection.io-browser-extension) )
  93. ## Installation
  94. ### Docker
  95. With Docker composer, just clone this repository and..
  96. ```bash
  97. $ docker compose up -d
  98. ```
  99. Docker standalone
  100. ```bash
  101. $ docker run -d --restart always -p "127.0.0.1:5000:5000" -v datastore-volume:/datastore --name changedetection.io docker.io/dgtlmoon/changedetection.io
  102. ```
  103. `:latest` tag is our latest stable release, `:dev` tag is our bleeding edge `master` branch.
  104. Alternative docker repository over at ghcr - [ghcr.io/dgtlmoon/changedetection.io](https://ghcr.io/dgtlmoon/changedetection.io)
  105. ### Windows
  106. See the install instructions at the wiki https://github.com/dgtlmoon/changedetection.io/wiki/Microsoft-Windows
  107. ### Python Pip
  108. Check out our pypi page https://pypi.org/project/changedetection.io/
  109. ```bash
  110. $ pip3 install changedetection.io
  111. $ changedetection.io -d /path/to/empty/data/dir -p 5000
  112. ```
  113. Then visit http://127.0.0.1:5000 , You should now be able to access the UI.
  114. _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!_
  115. ## Updating changedetection.io
  116. ### Docker
  117. ```
  118. docker pull dgtlmoon/changedetection.io
  119. docker kill $(docker ps -a -f name=changedetection.io -q)
  120. docker rm $(docker ps -a -f name=changedetection.io -q)
  121. docker run -d --restart always -p "127.0.0.1:5000:5000" -v datastore-volume:/datastore --name changedetection.io docker.io/dgtlmoon/changedetection.io
  122. ```
  123. ### docker compose
  124. ```bash
  125. docker compose pull && docker compose up -d
  126. ```
  127. See the wiki for more information https://github.com/dgtlmoon/changedetection.io/wiki
  128. ## Different browser viewport sizes (mobile, desktop etc)
  129. 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](https://github.com/dgtlmoon/sockpuppetbrowser?tab=readme-ov-file#setting-viewport-size).
  130. ## Filters
  131. 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.
  132. (We support LXML `re:test`, `re:match` and `re:replace`.)
  133. ## Notifications
  134. 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 <a href="https://github.com/caronc/apprise">apprise</a> library.
  135. Simply set one or more notification URL's in the _[edit]_ tab of that watch.
  136. Just some examples
  137. discord://webhook_id/webhook_token
  138. flock://app_token/g:channel_id
  139. gitter://token/room
  140. gchat://workspace/key/token
  141. msteams://TokenA/TokenB/TokenC/
  142. o365://TenantID:AccountEmail/ClientID/ClientSecret/TargetEmail
  143. rocket://user:password@hostname/#Channel
  144. mailto://user:pass@example.com?to=receivingAddress@example.com
  145. json://someserver.com/custom-api
  146. syslog://
  147. <a href="https://github.com/caronc/apprise#popular-notification-services">And everything else in this list!</a>
  148. <img src="https://raw.githubusercontent.com/dgtlmoon/changedetection.io/master/docs/screenshot-notifications.png" style="max-width:100%;" alt="Self-hosted web page change monitoring notifications" title="Self-hosted web page change monitoring notifications" />
  149. Now you can also customise your notification content and use <a target="_new" href="https://jinja.palletsprojects.com/en/3.0.x/templates/">Jinja2 templating</a> for their title and body!
  150. ## JSON API Monitoring
  151. Detect changes and monitor data in JSON API's by using either JSONPath or jq to filter, parse, and restructure JSON as needed.
  152. ![image](https://raw.githubusercontent.com/dgtlmoon/changedetection.io/master/docs/json-filter-field-example.png)
  153. 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
  154. ![image](https://raw.githubusercontent.com/dgtlmoon/changedetection.io/master/docs/json-diff-example.png)
  155. ### JSONPath or jq?
  156. 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](https://stedolan.github.io/jq/manual/) for more specific information on jq.
  157. 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.
  158. See the wiki https://github.com/dgtlmoon/changedetection.io/wiki/JSON-Selector-Filter-help for more information and examples
  159. ### Parse JSON embedded in HTML!
  160. 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.
  161. ```
  162. <html>
  163. ...
  164. <script type="application/ld+json">
  165. {
  166. "@context":"http://schema.org/",
  167. "@type":"Product",
  168. "offers":{
  169. "@type":"Offer",
  170. "availability":"http://schema.org/InStock",
  171. "price":"3949.99",
  172. "priceCurrency":"USD",
  173. "url":"https://www.newegg.com/p/3D5-000D-001T1"
  174. },
  175. "description":"Cobratype King Cobra Hero Desktop Gaming PC",
  176. "name":"Cobratype King Cobra Hero Desktop Gaming PC",
  177. "sku":"3D5-000D-001T1",
  178. "itemCondition":"NewCondition"
  179. }
  180. </script>
  181. ```
  182. `json:$..price` or `jq:..price` would give `3949.99`, or you can extract the whole structure (use a JSONpath test website to validate with)
  183. The application also supports notifying you that it can follow this information automatically
  184. ## Proxy Configuration
  185. See the wiki https://github.com/dgtlmoon/changedetection.io/wiki/Proxy-configuration , we also support using [Bright Data proxy services where possible](https://github.com/dgtlmoon/changedetection.io/wiki/Proxy-configuration#brightdata-proxy-support) and [Oxylabs](https://oxylabs.go2cloud.org/SH2d) proxy services.
  186. ## Raspberry Pi support?
  187. Raspberry Pi and linux/arm/v6 linux/arm/v7 arm64 devices are supported! See the wiki for [details](https://github.com/dgtlmoon/changedetection.io/wiki/Fetching-pages-with-WebDriver)
  188. ## Import support
  189. Easily [import your list of websites to watch for changes in Excel .xslx file format](https://changedetection.io/tutorial/how-import-your-website-change-detection-lists-excel), or paste in lists of website URLs as plaintext.
  190. Excel import is recommended - that way you can better organise tags/groups of websites and other features.
  191. ## API Support
  192. Full REST API for programmatic management of watches, tags, notifications and more.
  193. - **[Interactive API Documentation](https://changedetection.io/docs/api_v1/index.html)** - Complete API reference with live testing
  194. - **[OpenAPI Specification](docs/api-spec.yaml)** - Generate SDKs for any programming language
  195. ## Commercial Support
  196. 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 dgtlmoon@gmail.com 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
  197. [release-shield]: https://img.shields.io:/github/v/release/dgtlmoon/changedetection.io?style=for-the-badge
  198. [docker-pulls]: https://img.shields.io/docker/pulls/dgtlmoon/changedetection.io?style=for-the-badge
  199. [test-shield]: https://github.com/dgtlmoon/changedetection.io/actions/workflows/test-only.yml/badge.svg?branch=master
  200. [license-shield]: https://img.shields.io/github/license/dgtlmoon/changedetection.io.svg?style=for-the-badge
  201. [release-link]: https://github.com/dgtlmoon/changedetection.io/releases
  202. [docker-link]: https://hub.docker.com/r/dgtlmoon/changedetection.io
  203. ## Disclaimer
  204. **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.**
  205. ### Website content monitoring
  206. 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 of this software accept no liability whatsoever for how you choose to use it or for any consequences arising from that use.
  207. ### AI / LLM features
  208. If you choose to enable AI / LLM features, content detected on monitored websites — including page diffs and extracted text — will be transmitted to a third-party AI provider of your choosing, outside of this installation. You are solely responsible for:
  209. - Ensuring such transmission is permitted by the terms of service of every website you monitor.
  210. - Compliance with all applicable data-protection and privacy laws (including but not limited to GDPR) with respect to any personal data that may appear in monitored content.
  211. - All API costs and charges levied by your chosen AI provider. This software has no visibility into or control over those charges.
  212. - Any consequences arising from acting on AI-generated output.
  213. **AI and LLM models are known to hallucinate** — producing plausible-sounding but factually incorrect, incomplete, or entirely fabricated output with apparent confidence. By design, LLMs may also omit or silently truncate relevant information during summarisation. **AI output must never be relied upon as complete or accurate.**
  214. By using this software, and in particular any AI / LLM features, you personally indemnify and hold harmless the author(s), contributor(s), and any associated parties from and against any and all claims, damages, losses, costs, and expenses (including reasonable legal fees) arising out of or in connection with your use of this software.
  215. ## Third-party licenses
  216. See [docs/THIRD-PARTY-LICENSES.md](docs/THIRD-PARTY-LICENSES.md) for every bundled package and its licence, and [NOTICE](NOTICE) for attribution and licence elections.
  217. ## Contributors
  218. <a href="https://github.com/dgtlmoon/changedetection.io/graphs/contributors">
  219. <img src="https://contrib.rocks/image?repo=dgtlmoon/changedetection.io&max=300&columns=20" alt="changedetection.io contributors" />
  220. </a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.