| name | stock-monitor |
| description | Monitor product availability and get restock alerts for Shopify stores. This skill should be used when checking if a product is in stock, watching for restocks, setting up back-in-stock alerts, or tracking product availability. Supports SMS, Slack, and terminal notifications on status transitions. Keywords: out of stock, sold out, back in stock, restock alert, notify when available, watch product. |
| argument-hint | [URL or 'check' or 'list'] |
Stock Monitor
Track product availability on Shopify stores. Get notified via SMS, Slack, or terminal when out-of-stock items come back.
Quick Start
python3 ~/.claude/skills/stock-monitor/scripts/stock_watch.py add "https://store.com/products/item?variant=123" --notify sms --target "+17327595647"
python3 ~/.claude/skills/stock-monitor/scripts/stock_check.py
python3 ~/.claude/skills/stock-monitor/scripts/stock_check.py --url "https://store.com/products/item?variant=123"
Scripts
stock_watch.py — Manage Watchlist
| Command | Purpose |
|---|
stock_watch.py add URL [--name NAME] [--notify sms|slack|terminal] [--target PHONE|#CHANNEL] | Add product to watch |
stock_watch.py list | Show all watched items with status |
stock_watch.py remove ID | Remove a watch |
stock_watch.py pause ID / resume ID | Pause or resume checking |
stock_check.py — Run Checks
| Flag | Purpose |
|---|
| (no flags) | Check all active watches |
--id N | Check specific watch |
--url URL | One-off URL check, no DB write |
--dry-run | Check without sending notifications |
--json | JSON output for piping |
Notification Channels
- terminal (default): Colored output to stdout
- sms: Dispatches via
~/.claude/skills/sms/scripts/sms_send.py
- slack: Dispatches via
~/.claude/skills/slack/scripts/slack_post.py
Notifications fire only on out_of_stock → in_stock transitions to avoid noise on repeated checks.
Scheduling
Run stock_check.py manually, or schedule recurring checks:
- Session loop:
/loop 30m python3 ~/.claude/skills/stock-monitor/scripts/stock_check.py
- Persistent cron: See
references/launchd-setup.md for a macOS launchd plist that runs checks when Claude is closed.
How It Works
Shopify stores expose product data at /products/{handle}.js with per-variant available booleans. The skill fetches this JSON, finds the target variant by ID, and compares against the last known status in SQLite. No scraping, no browser rendering, no rate-limit concerns.
Data
SQLite DB at ~/.claude/skills/stock-monitor/data/stock_monitor.db with two tables: watches (watchlist) and check_log (check history with transition tracking).
