DealWatch

Official

by xiaojiou176-open · Python

Local-first grocery price intelligence with a read-only MCP server.

The io.github.xiaojiou176-open/dealwatch MCP server provides a local-first grocery price intelligence service. It is a read-only MCP server and is described as price-monitoring and price-tracking functionality, focused on detecting deals. The repository includes components associated with FastAPI, Playwright, PostgreSQL, and Preact.

🛠️ Key Features

Local-first grocery price intelligence
Read-only MCP server
Price monitoring and price tracking
Deal-finder / dealwatch functionality
Uses related tooling: apscheduler, postgres, notifications, playback with Playwright

🚀 Use Cases

Monitor grocery prices over time
Track changes and surface dealwatch events
Trigger notifications based on cashback/deal detection

⚡ Developer Benefits

Integrates with Python web stack (fastapi)
Supports scheduled tasks (apscheduler)
Uses database persistence (postgresql)
Frontend/UI development hints (preact)

⚠️ Limitations

Read-only MCP server (no write/update operations implied)

Topics

apschedulercashbackdeal-finderdealwatchfastapigrocerynotificationsplaywrightpostgresqlpreactprice-monitoringprice-tracking

README.md5 KBView on GitHub

shopping bags

dealwatcherer

let prices fight, you sit and watch

What You Get • Install • How It Work • Ecosystem

dealwatcherer watches the products you care about across vendors, replays history, and tells you when to pull the trigger. Browser extension and dashboard included.

code

┌──────────────────────────────────────┐
│  LOCAL-FIRST          ████████ 100%  │
│  SOURCE-TRACEABLE     ████████ 100%  │
│  TYPING REQUIRED      ░░░░░░░░   0%  │
│  VIBES                ████████ ZERO  │
│                                FILLER│
└──────────────────────────────────────┘

Track prices across vendors. Get the receipt before you check out.

What You Get

Surface	What
`dealwatcherer core`	Price-monitoring engine. Crawl, normalize, score, alert.
`dealwatcherer frontend`	Compare-first dashboard. See the deal, not the noise.
`browser extension`	Right-click any product. dealwatcherer does the rest.
`dealwatcherer worker`	Scheduled checks, alembic-backed history.
`public skills`	Drop into Claude/Codex/OpenClaw and let the agent shop.

IMPORTANT

Local-first by default. No silent telemetry. No cloud round-trip. Your data stays on your machine until you explicitly ship it somewhere.

Install

bash

git clone https://github.com/xiaojiou176-open/dealwatcherer.git
cd dealwatcherer
# follow the per-stack quickstart in INSTALL.md or docs/

Three commands. No curl | sh. No login. Read what you run.

Install break? Open your favorite agent and say "Read AGENTS.md and bootstrap dealwatcherer for me." Agent fix own brain. Long version: docs/.

How It Work

The repo is seven layers — exactly the seven commits in git log. New work goes in as small named PRs. No 50-file mystery commits.

Layer	What
`chore: scaffold`	License, governance, hygiene gates, CI scaffolding.
`feat(core)`	The primary engine. The reason dealwatcherer exists.
`feat(modules)`	Packages, adapters, services, plugins. The second floor.
`feat(contracts)`	Schemas, configs, public boundaries. Other code talks here.
`test:`	Receipts. Everything in this layer must run.
`feat(ops)`	Scripts, infra, CI helpers, build glue.
`docs:`	Public docs surface. The pretty face.

git log reads like a building floor plan. Look once, know the whole shape.

Ecosystem

dealwatcherer lives in the yard family: seven yards. one philosophy: structured input, structured output, structured proof.

Repo	What
switchyard	model & agent runtime switch board
browserclickyard	your AI clicks, your browser obeys
noteyard	your Apple Notes never really die
dealwatcherer (you here)	let prices fight, you sit and watch
docyard	docs site in, markdown out, no scraping by hand
fileyard	messy folders in, organized library out
proofyard	every claim ships with its receipt

Cross-family taste: BeamMe · BrewMe · OpenVibeCoding · proofyard.

Star This Repo

If dealwatcherer saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐

Also by Yifeng[Terry] Yu

switchyard — model & agent runtime switch board
browserclickyard — your AI clicks, your browser obeys
BeamMe — beam your agent config to any planet
BrewMe — wake up, news already brewed
OpenVibeCoding — AI codes overnight, you ship in the morning

License

MIT — small print, big freedom.

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "dealwatch": {
      "command": "uvx",
      "args": [
        "dealwatch"
      ]
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

dealwatcherer

What You Get

Install

How It Work

Ecosystem

Star This Repo

Also by Yifeng[Terry] Yu

License

Install

Related servers