OpenParable
Skip to content
← Back to skills

Stock Monitor

Apps & Automation
stock-monitor

Stock Monitor is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/development/unknown-tdimino-claude-code-minoan-8/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/stock-monitor, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Stock Monitor

Track product availability on Shopify stores. Get notified via SMS, Slack, or terminal when out-of-stock items come back.

Quick Start

# Add a product to watch (auto-detects name from Shopify)
python3 ~/.claude/skills/stock-monitor/scripts/stock_watch.py add "https://store.com/products/item?variant=123" --notify sms --target "+1XXXXXXXXXX"

# Check all watched items
python3 ~/.claude/skills/stock-monitor/scripts/stock_check.py

# One-off check (no watchlist needed)
python3 ~/.claude/skills/stock-monitor/scripts/stock_check.py --url "https://store.com/products/item?variant=123"

Scripts

stock_watch.py — Manage Watchlist

CommandPurpose
stock_watch.py add URL [--name NAME] [--notify sms|slack|terminal] [--target PHONE|#CHANNEL]Add product to watch
stock_watch.py listShow all watched items with status
stock_watch.py remove IDRemove a watch
stock_watch.py pause ID / resume IDPause or resume checking

stock_check.py — Run Checks

FlagPurpose
(no flags)Check all active watches
--id NCheck specific watch
--url URLOne-off URL check, no DB write
--dry-runCheck without sending notifications
--jsonJSON 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).