India Price Tracker

1. India-first store adapters

   • Store list and naming normalized for Indian catalogs.

2. Effective price modeling

   • Calculates final payable estimate:
   • effective_price = listing_price - instant_discount - coupon_discount - card_cashback + shipping

3. Pincode-aware availability

   • Supports regional availability and shipping variance inputs.

4. Arbitrage with fee model

   • Computes net margin after platform fees and shipping.

5. History + trend flags

   • Tracks 30/60/90 day movement and volatility.

6. Alerting modes

   • Price-drop threshold
   • Margin threshold
   • Restock + price condition

Setup

On first use, read setup.md, then run scripts in mock mode first.

Core workflows

1) Compare prices across stores

python3 scripts/compare_prices.py \
  --keyword "iPhone 15 128GB" \
  --stores amazon_in,flipkart,reliance_digital,croma,vijay_sales,tata_cliq \
  --report markdown

2) Track a product with threshold alerts

python3 scripts/track_product.py \
  --product "Sony WH-1000XM5" \
  --stores amazon_in,flipkart,croma \
  --alert-below 24999 \
  --alert-margin 0.18 \
  --pincode 560001

3) Bulk monitor from CSV

python3 scripts/bulk_monitor.py \
  --csv examples/products.india.csv \
  --margin-threshold 0.15 \
  --output reports/alerts.txt

4) Price history analysis

python3 scripts/price_history.py \
  --product "Samsung Galaxy S24" \
  --days 60 \
  --stores amazon_in,flipkart \
  --trend-analysis

Strategy rules

• Prefer effective price over headline price.
• Compare same SKU/variant only (storage, color, seller condition).
• Flag uncertain matches for manual review.
• Never assume stock parity across stores.
• Respect platform policies if implementing live adapters.

Output format

When asked to analyze products, return:

1. best store by effective price
2. next best alternative
3. arbitrage opportunity (if margin above threshold)
4. confidence notes (match quality, availability, shipping)

Files

• scripts/compare_prices.py
• scripts/track_product.py
• scripts/bulk_monitor.py
• scripts/price_history.py
• scripts/config.py
• examples/products.india.csv
• README.md

Validation

• Use validation-checklist.md before switching to any live adapter mode.
• Re-validate each store's terms, rate limits, and allowed integration method before production automation.