What makes price-predator notable?

2K downloads. Trust evidence available

How should price-predator be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

price-predator

Track product prices across time and stores, alert on price drops, and predict the best time to buy.

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.0k

Updated

Oct 9, 2026

Version

0.1.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 2K downloadsadoption · observed Oct 9, 2026
Latest release: 0.1.1release · observed Aug 14, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17b6amkd3wzqgg640v03a9r1n83gxs1:price-predator

Install using `clawhub skill install s17b6amkd3wzqgg640v03a9r1n83gxs1:price-predator` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/voronindenis5/price-predator before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-price-predator/snapshot"

Documentation

CLAWHUB

36,483 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: price-predator
version: 1.0.0
author: Denis Voronin
license: MIT
description: Track product prices across time and stores, alert on price drops, and predict the best time to buy.
---

# Price Predator

Track product prices across time and stores, get alerts on price drops, and predict the best time to buy.

## Quick Start

```bash
# Track a product with its current price
python3 scripts/price_predator.py track --name "Sony WH-1000XM5" --price 350.00 --category electronics

# Record a new price observation
python3 scripts/price_predator.py update <product-id> --price 299.99

# View ASCII sparkline price history
python3 scripts/price_predator.py history <product-id>

# Check for price drop alerts (all products)
python3 scripts/price_predator.py alert

# Check best time to buy by category
python3 scripts/price_predator.py best-time --category electronics

# Full report
python3 scripts/price_predator.py report
```

## Commands

| Command | Description |
|---------|-------------|
| `track` | Add a product to track (name + price + category + optional URL/target) |
| `update` | Record a new price observation for a tracked product |
| `history` | Show price history with ASCII sparkline chart |
| `alert` | Check for price drops exceeding threshold (>10% below median by default) |
| `best-time` | Predict best time to buy based on seasonal patterns by category |
| `report` | Full summary report of all tracked products |
| `list` | List all tracked products |
| `remove` | Remove a tracked product |
| `info` | Show detailed info about a product |

## How It Works

- **Database**: JSON file (`~/.price_predator_db.json` by default). Override with `--db`.
- **Price tracking**: Each `update` records price + timestamp + source. Build a history over time.
- **Alerts**: When the latest price drops more than the threshold (default 10%) below the median of all recorded prices, an alert fires.
- **Seasonal prediction**: Uses a built-in calendar of best months to buy each category (see `references/seasonal-buying-calendar.md`).
- **Depreciation**: Category-aware annual depreciation rates provide a rough price prediction model.

## Category-Aware Patterns

Price Predator knows seasonal discount windows for 15+ categories:

- **Electronics / TVs / Laptops** → Black Friday (Nov), Cyber Monday
- **Mattresses** → May (Memorial Day), February (Presidents' Day)
- **Appliances** → September (Labor Day), May (Memorial Day)
- **Smartphones** → September (new model launches), November (Black Friday)
- **Furniture** → January & July (inventory clearance)
- See `references/seasonal-buying-calendar.md` for the full calendar.

## Options

- `--db <path>` — Use a custom database file (global flag, before subcommand)
- `--target <price>` — Set a target buy price when tracking
- `--threshold <frac>` — Set alert threshold as a fraction (0.15 = 15%)
- `--category <cat>` — Set product category for seasonal predictions

## Files

- `scripts/price_predator.py` — Main script (Python

README.md

# Price Predator 🦈

Track product prices across time and stores, get alerts on price drops, and predict the best time to buy.

## Features

- **Price tracking** — Add products and record price observations over time
- **ASCII sparkline charts** — Visual price history right in your terminal
- **Drop alerts** — Get notified when prices drop below your threshold (default: 10% below median)
- **Seasonal buying guide** — Know the best month to buy each product category
- **Category-aware predictions** — Depreciation rates and seasonal patterns for 15+ categories
- **Target prices** — Set a buy target and get notified when it's reached
- **Pure Python stdlib** — No dependencies, no pip install, just works

## Quick Start

```bash
# Track a product
python3 scripts/price_predator.py track --name "Sony WH-1000XM5" --price 350.00 --category electronics

# Update with a new price
python3 scripts/price_predator.py update <product-id> --price 299.99

# View price history with sparkline
python3 scripts/price_predator.py history <product-id>

# Check for alerts
python3 scripts/price_predator.py alert

# Best time to buy
python3 scripts/price_predator.py best-time --category electronics

# Full report
python3 scripts/price_predator.py report
```

## Commands

| Command | Description |
|---------|-------------|
| `track` | Add a product to track |
| `update <id> --price N` | Record a new price observation |
| `history <id>` | Show price history with ASCII sparkline |
| `alert [id]` | Check for price drops (all or one product) |
| `best-time --category CAT` | Predict best time to buy by category |
| `report` | Full summary of all tracked products |
| `list` | List all tracked products |
| `remove <id>` | Remove a tracked product |
| `info <id>` | Show detailed product info |

## Categories with Seasonal Data

Electronics, TVs, Laptops, Smartphones, Cameras, Video Games, Mattresses, Appliances, Furniture, Clothing, Toys, Tools, Fitness Equipment, Outdoor Gear, Jewelry.

## Example Session

```bash
$ python3 scripts/price_predator.py track --name "MacBook Air M3" --price 1099 --category laptops --target 999
✅ Tracking product 'MacBook Air M3' (id: a1b2c3d4)
   Initial price: $1099.00
   Category: laptops

$ python3 scripts/price_predator.py update a1b2c3d4 --price 1049 --source amazon
✅ Updated 'MacBook Air M3' → $1049.00
   ↓ -50.00 (-4.5%) from previous $1099.00

$ python3 scripts/price_predator.py update a1b2c3d4 --price 989 --source bestbuy
✅ Updated 'MacBook Air M3' → $989.00
   ↓ -60.00 (-5.7%) from previous $1049.00

$ python3 scripts/price_predator.py alert a1b2c3d4
🔔 ALERT: 'MacBook Air M3' (id: a1b2c3d4)
   Latest: $989.00 | Median: $1049.00
   Drop: 5.7% below median (threshold: 10%)

$ python3 scripts/price_predator.py history a1b2c3d4
📊 Price History: MacBook Air M3 (id: a1b2c3d4)
   Sparkline: █▆▄
```

## License

MIT © Denis Voronin

_meta.json

{
  "ownerId": "kn75wwn4x6djaf28jbykeamazd81gtdp",
  "slug": "price-predator",
  "version": "0.1.1",
  "publishedAt": 1786688333570
}

references/price-tracking-strategies.md

# Price Tracking Strategies

Effective strategies for tracking product prices and timing purchases.

## 1. Establish a Baseline

Before tracking for drops, record at least 2–3 price observations over a few weeks. This establishes a realistic median and helps filter out short-term noise.

```bash
python3 scripts/price_predator.py track --name "Product" --price 400.00 --category electronics
python3 scripts/price_predator.py update <id> --price 395.00
python3 scripts/price_predator.py update <id> --price 389.99
```

## 2. Set a Target Price

Define the price at which you're ready to buy. Price Predator will flag when it's reached.

```bash
python3 scripts/price_predator.py track --name "Product" --price 400.00 --target 300.00 --category electronics
```

## 3. Adjust Alert Sensitivity

The default alert threshold is 10% below median. For high-volatility items, raise it; for stable items, lower it.

```bash
# 15% threshold — only alert on significant drops
python3 scripts/price_predator.py track --name "Product" --price 1000.00 --threshold 0.15
```

## 4. Check Seasonal Timing

Before buying, check whether the current month is a known discount window for the product's category.

```bash
python3 scripts/price_predator.py best-time --category electronics
```

If it says "NOW is a great time to buy," you're in a prime window. If the next window is months away, waiting could save 10–30%.

## 5. Regular Price Checks

Update prices regularly for the best data. Strategies:

- **Manual checks**: Visit the store/website weekly and record the price.
- **Sale events**: Always check during Black Friday, Prime Day, and holiday weekends.
- **Multiple sources**: Use the `--source` flag to tag where each price came from (e.g., amazon, bestbuy, costco).

```bash
python3 scripts/price_predator.py update <id> --price 349.00 --source amazon
python3 scripts/price_predator.py update <id> --price 339.00 --source bestbuy
```

## 6. Read the Sparkline

The ASCII sparkline gives a quick visual of price trend:

```
▁▂▂▃▄▅▅▆▇█
```

- **Upward stairs** (▁▃▅▇): Price rising — buy soon or wait for seasonal dip.
- **Downward stairs** (█▇▅▃▁): Price falling — good sign, may drop further.
- **Flat line** (▄▄▄▄): Price stable — wait for a sale event.
- **Sharp drop** (█▁): Flash sale or clearance — act fast.

## 7. Use the Report for Portfolio Review

Run `report` periodically to review all tracked products at once. It shows:
- Current price vs. median for each product
- Whether any product is near its all-time low
- Whether target prices have been reached
- Recommended best-buy months

## 8. Category-Specific Tips

### Electronics
- New models typically launch in Sep–Oct; previous gen drops immediately.
- Black Friday doorbuster deals may be on lower-quality variants — verify model numbers.

### Mattresses
- Mattress prices are highly negotiable; MSRP is inflated.
- Memorial Day and Labor Day offer the most predictable discounts.

### Appliances
- New appliance models ship in Sep–Oct;

references/seasonal-buying-calendar.md

# Seasonal Buying Calendar

Best months to buy each product category, based on retail industry sales cycles.

## Electronics

| Category | Best Months | Why | Secondary Windows |
|----------|------------|-----|-------------------|
| **Electronics (general)** | November, December | Black Friday & Cyber Monday offer the deepest discounts on TVs, laptops, headphones, and gadgets | July (Amazon Prime Day), August (back-to-school) |
| **TVs** | November, January | Black Friday is the biggest TV discount event; January brings Super Bowl promotions | Cyber Monday, Presidents' Day |
| **Laptops** | November, August | Black Friday/Cyber Monday and back-to-school season | July (Prime Day), April (spring refresh) |
| **Smartphones** | September, November | New iPhones/Androids launch Sep–Oct; prior models drop in price | March (spring launches), Black Friday |
| **Cameras** | November, April | Black Friday and spring rebate season | January (CES clearance), September |
| **Video Games** | November, December | Holiday shopping season; deepest game/console discounts | June (E3/Summer Game Fest), January (Steam Winter Sale end) |

## Home

| Category | Best Months | Why | Secondary Windows |
|----------|------------|-----|-------------------|
| **Mattresses** | May | Memorial Day sales are the prime mattress buying event | February (Presidents' Day), September (Labor Day) |
| **Appliances** | September, May | Labor Day and Memorial Day bring major appliance clearance | November (Black Friday), January (New Year clearance) |
| **Furniture** | January, July | Dealers clear inventory for new lines | November (Black Friday), May (Memorial Day) |

## Lifestyle

| Category | Best Months | Why | Secondary Windows |
|----------|------------|-----|-------------------|
| **Clothing** | January, July | End-of-season clearance: January (winter), July (summer) | August (back-to-school), December (post-holiday) |
| **Jewelry** | January, July | Slower retail periods yield better prices | February (Valentine's clearance), November |
| **Toys** | November, December | Holiday shopping season; deepest discounts early December | January (post-holiday clearance), July |

## Tools & Outdoor

| Category | Best Months | Why | Secondary Windows |
|----------|------------|-----|-------------------|
| **Tools** | June, December | Father's Day and holiday sales on power tools | November (Black Friday), May (spring DIY) |
| **Outdoor Gear** | September, August | End-of-summer clearance on grills, patio furniture, camping gear | May (Memorial Day), November |
| **Fitness Equipment** | January, December | New Year resolutions and holiday sales | September (end of outdoor season), May |

## Depreciation Rates (Annual)

Expected year-over-year price decline used for predictions:

| Category | Annual Depreciation |
|----------|-------------------|
| Smartphones | 25% |
| TVs | 20% |
| Laptops | 18% |
| Electronics (general) | 15% |
| Cameras | 15% |
| Video Games | 12% |
| Clothing | 10% |
|

Github ReposUpdated 10h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.