← Back to Skills Marketplace
mguozhen

Amazon Price History

by mguozhen · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
182
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install amazon-price-history
Description
Amazon product price history tracker and drop alert agent. Track price trends over time, identify the best time to buy or sell, analyze competitor pricing pa...
README (SKILL.md)

Amazon Price History Tracker

Track Amazon product price history, identify pricing patterns, and time your pricing decisions with precision. Alternative to Keepa for sellers who want AI-assisted price analysis.

Paste product data, price snapshots, or competitor pricing. The agent builds price timelines, detects patterns, and recommends optimal pricing windows.

Commands

price add \x3Casin> \x3Cprice> [date]   # log a price data point
price trend \x3Casin>                # analyze price trend direction
price pattern \x3Casin>              # detect seasonal and cyclical patterns
price alert set \x3Casin> \x3Ctarget>   # set alert for target price threshold
price compare \x3Casin1> \x3Casin2>     # compare pricing histories side-by-side
price best-time \x3Casin>            # identify best time window to raise/lower price
price volatility \x3Casin>           # compute price stability score
price chart \x3Casin>                # render text-based price chart
price report \x3Casin>               # full pricing analysis report
price save                        # save all price history to workspace

What Data to Provide

  • ASIN + price data — current or historical prices with dates
  • Buy Box price — the winning price you see on the listing
  • Competitor prices — other sellers on the same listing
  • Your cost structure — COGS, FBA fees, target margin
  • Seasonal context — any known promotions or peak periods

Price Analysis Framework

Price Data Points to Track

For each ASIN, capture:

Date | Price | Seller | Buy Box? | Coupon | Sale Event | Notes
2024-01-15 | $29.99 | Brand | Yes | 10% off | None | Normal
2024-01-20 | $24.99 | Brand | Yes | None | Flash sale | -17%
2024-02-01 | $32.99 | Brand | Yes | None | None | Post-sale

Price Trend Classification

Uptrend (Price rising):

  • Average price this month > last month by >5%
  • Signal: possible demand increase, supply constraints, or brand repositioning
  • Seller action: monitor for opportunity to raise your price

Downtrend (Price falling):

  • Average price this month \x3C last month by >5%
  • Signal: increased competition, excess inventory, or market correction
  • Seller action: evaluate your cost floor, avoid race-to-bottom

Stable (±5% range):

  • Price within 5% of 90-day average
  • Signal: mature market equilibrium
  • Seller action: compete on other factors (listing quality, reviews, ads)

Volatile (Frequent swings >10%):

  • Price swings more than 10% within 30 days
  • Signal: heavy promotional activity or multiple sellers competing
  • Seller action: dynamic repricing is essential

Price Volatility Score

Volatility = (Max Price - Min Price) / Average Price × 100

Score 0-10:   Very stable — predictable market
Score 10-25:  Moderate — some promotional activity
Score 25-50:  Volatile — heavy competition or frequent sales
Score 50+:    Highly volatile — use dynamic repricing or avoid

Seasonal Pattern Detection

Map price history against calendar events:

  • Q4 (Oct-Dec): Holiday surge — premium pricing possible
  • Prime Day (July): Deep discounts expected, plan inventory
  • Back to School (Aug-Sep): Category-specific peaks
  • Valentine's/Mother's Day: Gift category spikes
  • Post-holiday (Jan-Feb): Price depression, clear inventory

Buy Box Price Analysis

The Buy Box price matters more than list price:

  • Track who holds the Buy Box at each snapshot
  • Compute your price gap vs. current Buy Box winner
  • Identify patterns in Buy Box rotation (if multiple sellers)

Buy Box pricing rules:

  • New seller entering: typically prices 5-10% below current winner
  • FBA advantage: can price slightly higher than FBM and still win
  • Low inventory: Buy Box may shift to higher-priced seller

Price Alert Thresholds

PRICE DROP ALERT:   Current price falls >10% below 30-day average
PRICE SPIKE ALERT:  Current price rises >20% above 30-day average
BUY BOX LOST:       Your price is no longer the Buy Box winner
COMPETITOR ENTRY:   New seller appears at significantly lower price
FLOOR ALERT:        Price drops below your calculated margin floor

Optimal Repricing Windows

Based on historical patterns:

  • Best time to raise price: After a competitor goes out of stock
  • Best time to lower price: 2 weeks before Prime Day to boost velocity
  • Avoid repricing: During major sale events (prices stabilize after)
  • Post-holiday: Expect 15-25% price compression, plan ahead

Margin Floor Calculation

Margin Floor = COGS + FBA Fees + Referral Fee + PPC Cost + Minimum Profit
Example:
  COGS:          $8.00
  FBA fees:      $4.50
  Referral (15%): price × 0.15
  PPC cost:      $2.00
  Min profit:    $2.00
  Floor = $8 + $4.50 + (price × 0.15) + $2 + $2 = solve for price
  Minimum price = ($16.50) / (1 - 0.15) = $19.41

Workspace

Creates ~/price-tracker/ containing:

  • history/ — price logs per ASIN (ASIN.md files)
  • alerts/ — triggered price alerts
  • patterns/ — seasonal pattern analysis
  • reports/ — full pricing reports

Output Format

Every price analysis outputs:

  1. Price Timeline Table — chronological price history with key events marked
  2. Trend Direction — current trend with confidence level
  3. Volatility Score — 0-100 stability rating with interpretation
  4. Pattern Summary — detected seasonal or cyclical patterns
  5. Optimal Price Window — recommended price and timing
  6. Margin Check — current price vs. your floor, profit per unit
Usage Guidance
This skill appears coherent and self-contained, but before installing: (1) be aware it will create and write files under ~/price-tracker — review and remove those files if undesired; (2) do not paste secrets or credentials (API keys, supplier passwords) into the skill — only paste price and cost data you intend to store locally; (3) confirm the agent's runtime sandboxing for Bash commands in your environment (Bash access could be used to run arbitrary shell commands if the agent is compromised); (4) if you want networked price scraping or automated alerts, ask for explicit instructions or an integration that requires credentials — this skill does not perform external scraping or require API keys as written; (5) optionally inspect the referenced GitHub homepage before use to verify provenance and review any example outputs or community feedback.
Capability Analysis
Type: OpenClaw Skill Name: amazon-price-history Version: 1.0.0 The skill bundle provides a framework for an AI agent to track Amazon price history, analyze trends, and calculate profit margins. It uses the Bash tool for managing a local workspace in `~/price-tracker/`, but the instructions in `SKILL.md` are strictly aligned with the stated purpose and contain no evidence of data exfiltration, malicious execution, or prompt injection attacks.
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions: all features (trend, volatility, alerts, reports) are implemented as guidance for the agent to operate on pasted ASIN/price snapshots and produce local analyses. There are no unrelated requirements (no cloud credentials, no extra service APIs).
Instruction Scope
SKILL.md restricts input to user-provided ASINs, prices, competitor/buy-box info, and cost structure. It instructs the agent to create and write files under ~/price-tracker/ (history, alerts, patterns, reports). This is consistent with the stated purpose, but you should expect the agent to write files to your home directory and to process any sensitive cost data you paste.
Install Mechanism
No install spec and no code files — instruction-only skill. That minimizes supply-chain risk (nothing downloaded or executed beyond allowed-tools).
Credentials
The skill requests no environment variables, no credentials, and no config paths. This is proportionate to its stated functionality.
Persistence & Privilege
The skill does create a local workspace (~/price-tracker) but does not request always:true or other elevated/always-present privileges. It relies on allowed-tools: Bash to perform file writes, which is expected for an instruction-only skill that saves data locally.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install amazon-price-history
  3. After installation, invoke the skill by name or use /amazon-price-history
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Amazon Price History Tracker skill. - Tracks Amazon product price history, detects trends, and analyzes competitor pricing. - Supports price alerts, volatility analysis, seasonality detection, and buy box monitoring. - Offers a full set of commands for adding price data, analyzing trends, generating reports, and setting alerts. - Provides a framework for identifying optimal repricing windows and calculating margin floors. - Organizes data in workspace directories for history, alerts, patterns, and reports.
Metadata
Slug amazon-price-history
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Amazon Price History?

Amazon product price history tracker and drop alert agent. Track price trends over time, identify the best time to buy or sell, analyze competitor pricing pa... It is an AI Agent Skill for Claude Code / OpenClaw, with 182 downloads so far.

How do I install Amazon Price History?

Run "/install amazon-price-history" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Amazon Price History free?

Yes, Amazon Price History is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Amazon Price History support?

Amazon Price History is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Amazon Price History?

It is built and maintained by mguozhen (@mguozhen); the current version is v1.0.0.

💬 Comments