lacspace-monitor

Watch pages, APIs and feeds for changes — alert when something moves.

● Live · v0.1.0npmSource
terminal
npx lacspace-monitor https://example.com --selector ".price" --interval 5m
What it does

Everything, in one command

The first run captures a baseline; every run after reports exactly what changed. Snapshots live in a small state file, so you can run it from cron or CI and it just works — or use --interval to keep it running. Watch a selector's text, a JSON path, or a feed's new items, and POST changes to a webhook.

Features

What's inside

Watch anything

A page, a CSS selector's text/attribute, a JSON API field, or an RSS/Atom/JSON feed.

Real diffs

Snapshots compared over time — you see the exact before → after, or the new feed items.

Webhook alerts

POST changes to any webhook, or handle them in code with the library.

Schedule or loop

Run once from cron/CI (stateful), or keep running with --interval 30s/5m/1h.

Config files

Define many watches in one JSON file with a shared webhook and state.

Export

Write results to JSON, NDJSON, CSV or Excel.

How to use

Copy, paste, done

Real commands and snippets — from a one-liner to the typed library.

Watch a price, check every 10 minutes
terminal
npx lacspace-monitor https://shop.site/product \
  --selector ".price" --interval 10m \
  --webhook https://hooks.mysite.com/price

Baseline now; later runs report before → after and POST the change.

Watch a JSON API field
terminal
npx lacspace-monitor https://api.site/status --json data.status --interval 1m

Dot/bracket paths: data.items[0].price

New items in a feed
terminal
npx lacspace-monitor https://blog.site/rss.xml --feed --label "Blog posts"

Reports the new item ids/links since last check.

Use it as a library
typescript
import { runChecks, loadState, saveState } from "lacspace-monitor";

const state = loadState(".lacspace-monitor.json");
const { results, state: next } = await runChecks(
  [{ url: "https://example.com", selector: "h1", label: "Title" }], state);
saveState(".lacspace-monitor.json", next);
Good for

What people build with it

Price + stock monitoring

New-listing / new-post alerts

API status & uptime watching

Content-change tracking

Start now

Run lacspace-monitor today

Free, open-source, no API keys. It's a CLI and a typed library.

terminal
npx lacspace-monitor https://example.com --selector ".price" --interval 5m