Skip to main content

webchanges PyPI downloads

webchanges anonymously checks web content (including images) and commands for changes, delivering instant notifications and AI-powered summaries to your favorite platform.

Highlights

  • AI-powered change summaries via Gemini (ai_google differ, BETA).

  • Structural diffs for JSON and XML via the deepdiff differ.

  • Visual diffs for images via the image differ (BETA).

  • Bypass TLS/JA3 fingerprinting with the optional curl_cffi HTTP client.

  • JSON-Schema-validated jobs.yaml and config.yaml for editor autocompletion and inline validation.

Requirements

webchanges requires Supported Python versions. For the best experience, use the current version of Python; older Python versions are supported for 3 years after they’re replaced. Free-threaded Python is supported, though some optional dependencies may not be.

For Generative AI summaries (BETA), you need a free API Key from Google Cloud AI Studio (see here).

Installation

PyPI version Kit format Package stability

Install webchanges with uv (recommended):

uv pip install webchanges

or with pip:

pip install webchanges

On Windows with Python 3.15, first run set PYYAML_FORCE_LIBYAML=0 (in PowerShell: $env:PYYAML_FORCE_LIBYAML = "0"), as explained here.

Other ways to run

Documentation Documentation status

The documentation is hosted on Read the Docs.

Quick Start

Initialize

  1. Run the following command to create the default config.yaml (configuration) and jobs.yaml (jobs) files and open an editor to add your jobs:

    webchanges --edit-jobs
  2. Run the following command to change the default configuration, e.g. to receive change notifications (”reports”) by email and/or one of many other methods:

    webchanges --edit-config

Run

To check the sources in your jobs and report on (e.g. display or via email) any changes found from the last time the program ran, just run:

webchanges

Schedule

webchanges leverages the power of a system scheduler:

Code

Code coverage by Coveralls Issues at https://github.com/mborsetti/webchanges/issues Code style ruff OpenSSF Scoreard

The code, issues tracker, and discussions are hosted on GitHub.

Contributing

We welcome any contribution no matter how small, both as pull requests or issue reports.

More information for code and documentation contributors is here, and our wishlist is here.

License

License at https://pypi.org/project/webchanges/

See the complete licenses (released under the MIT License but redistributing modified source code, dated 30 July 2020, from urlwatch 2.21 licensed under a BSD 3-Clause License).

Relationship with urlwatch

This project is a fork of urlwatch 2.21 and has since added many features; see the comparison.

Metadata

Release files for webchanges 3.38.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for webchanges 3.38.0
File Size Uploaded Provenance Actions
webchanges-3.38.0.tar.gz 234.5 kB With provenance Details for webchanges-3.38.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for webchanges 3.38.0
File Interpreter ABI Platform Actions
webchanges-3.38.0-py3-none-any.whl Python 3 none any Details for webchanges-3.38.0-py3-none-any.whl

Total release size: 488.5 kB

Release files / webchanges-3.38.0.tar.gz

Download URL webchanges-3.38.0.tar.gz
Size 234.5 kB
Tags Source
SHA-256 checksum
How to use checksums
d3222c8780bc09421707011f82359bd73a960eb7b2f20862455623849c3f7718
BLAKE2b-256 checksum
How to use checksums
e296d9902c0131dc9ad753cd230ea0d84c09686a35c53544f7941110725bcd96
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / webchanges-3.38.0-py3-none-any.whl

Download URL webchanges-3.38.0-py3-none-any.whl
Size 254.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
da5bd46b56e0bc4802d247f3454b42c393aca364a4c105ab2e72e674300322bb
BLAKE2b-256 checksum
How to use checksums
5b73faa566fdef2d22bac1ceedf328b4a7b38f25e308e603c902ad36a65df314
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Security for webchanges 3.38.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for webchanges-3.38.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.38.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page