Ecommerce Price Watcher

Monitor product URLs, keep price history, detect offers, and output alert-ready JSON.

Quick start

Use

scripts/price_watch.py

# URL mode
python3 skills/ecommerce-price-watcher/scripts/price_watch.py add \
  --url "https://example.com/product" \
  --target-price 399990 \
  --currency CLP
Item mode (discover URLs from query)
python3 skills/ecommerce-price-watcher/scripts/price_watch.py add-item 

--query "iPhone 13 128GB Chile" 

--target-price 349990 

--currency CLP 

--trusted-only 

--max-results 5

python3 skills/ecommerce-price-watcher/scripts/price_watch.py check --all

Commands

```
add
```
: add a single product URL
```
add-item
```
: discover product URLs from an item query, then add watches
```
list
```
: list watched products
```
check --id <id>
```
: check one product now
```
check --all
```
: check all products now
```
remove --id <id>
```
: delete watcher
```
history --id <id>
```
: print full price history

Alert behavior

A check produces alerts when at least one condition matches:

```
price_drop
```
: current price < previous price
```
target_hit
```
: current price <= target price

Alert payload includes:

product id
title
old/new price
drop percent (when available)
URL
timestamp

Item-query mode details

add-item

uses a lightweight search discovery flow to find candidate product links.

```
--trusted-only
```
restricts discovered URLs to a curated trusted domain list.
```
--max-results
```
controls how many links are added.
Duplicate URLs are skipped safely.

This gives users natural language entry ("track iPhone 13 128GB") instead of forcing direct URLs.

Parsing strategy

Use a layered parser:

JSON-LD
```
offers.price
```
Open Graph/meta price fields
Generic HTML regex fallback

When multiple prices are found, choose the lowest positive value as the current offer candidate.

Security standards

Accept only
```
http
```
/
```
https
```
URLs.
Enforce request timeout.
Enforce response body size cap.
Do not execute remote JavaScript.
Store no API keys/tokens in watcher data.
Treat all page content as untrusted.
Return structured JSON for safe downstream automation.

Limits and operational notes

Some stores block bot-like requests (403). This is expected on certain sites.
Price extraction is best-effort and may need store-specific adapters over time.
For production alerting, run
```
check --all
```
on schedule and forward only non-empty
```
alerts
```
.

Suggested scheduled usage

Run every 30–120 minutes via cron, then send each alert to Telegram/WhatsApp/Discord.

Ecommerce Price Watcher

AI Skill Market Insights

Be Part of the 0+ Developer Community