page-update-monitor 1.0.0

CLI tool to monitor web page updates

Page Update Monitor

A simple CLI tool to monitor web page updates.

Register any web page and check whether it has changed since the last time you checked. You can monitor the entire page or specific elements using CSS selectors.

• Page Update Monitor
  • Features
  • Installation
  • Setup (Recommended)
  • Usage
  • Commands
    • See help
    • Check for updates
    • Add a website
    • List websites
    • Remove a website
    • Show version
  • How It Works
  • Data Storage
  • Example Workflow
  • Requirements
  • Dependencies

---

Features

• Monitor full web pages for changes
• Monitor specific elements using CSS selectors
• Simple and intuitive CLI
• Lightweight (no browser required)
• Local JSON storage (no database needed)

---

Installation

Clone the repository:

git clone https://github.com/yourname/page-update-monitor.git
cd page-update-monitor

---

Setup (Recommended)

Create a virtual environment:

python -m venv .venv

Activate it:

Windows:

.venv\Scripts\activate

Linux / macOS:

source .venv/bin/activate

Install dependencies:

pip install -r requirements.txt

---

Usage

All commands are executed via:

python run.py [COMMAND]

You can also check the version globally:

python run.py --version
python run.py -v

---

Commands

See help

python run.py --help

---

Check for updates

python run.py check

Checks all registered websites and reports changes.

---

Add a website

python run.py add

You will be prompted to enter:

• Site name

• URL

• Mode:

  • full (default): monitor the entire page
  • selector: monitor a specific HTML element

If you choose selector mode, enter a CSS selector.

Examples:

#main
.content

The tool will validate the selector and show a preview:

[OK] #main -> <content preview>...

---

List websites

python run.py list

With details:

python run.py list -d

---

Remove a website

python run.py remove [name]

Alias:

python run.py rm [name]

Example:

python run.py rm example-site

---

Show version

python run.py version

Or:

python run.py --version
python run.py -v

---

How It Works

• Fetches HTML using requests
• Parses content with BeautifulSoup
• Stores previous results locally
• Compares current content with the last snapshot

If a difference is detected, it reports an update.

---

Data Storage

Registered sites are stored in:

data/sites.json

---

Example Workflow

python run.py add
python run.py list
python run.py check

---

Requirements

• Python 3.10+
• See requirements.txt for full dependencies

---

Dependencies

• typer
• requests
• beautifulsoup4
• rich