https://github.com/olostep-api/amazon-price-tracker
https://github.com/olostep-api/amazon-price-tracker
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/olostep-api/amazon-price-tracker
- Owner: olostep-api
- Created: 2026-03-02T11:20:46.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-06T07:25:46.000Z (4 months ago)
- Last Synced: 2026-03-06T11:51:35.946Z (4 months ago)
- Language: Python
- Size: 546 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Amazon Product Price Tracker (Python + Streamlit + Olostep API)
Track [Amazon](https://www.amazon.com/) product prices with a lightweight Python workflow that scrapes product data via the [Olostep API](https://www.olostep.com/), stores history in **CSV + JSON**, and provides both a **Streamlit dashboard** and **CLI runners** for manual and scheduled checks.
## Why This Project
This project helps you:
- Monitor Amazon product price changes over time.
- Compare current vs previous prices (`higher`, `lower`, `same`, `new`, `unknown`).
- Run one-off checks from terminal or recurring checks on a schedule.
- View a compact web dashboard for URL management, tracking controls, and filtered product data.
## Features
- Streamlit dashboard (`app.py`)
- Add, edit, and remove tracked URLs.
- Run tracking manually.
- Start or stop the scheduler and view scheduler status.
- Filter tracked products by title/URL and price direction.
- CLI one-shot runner (`run_tracker.py`)
- CLI scheduler runner (`run_scheduler.py`)
- Auto-aligned CSV schema
- JSON history with average price and sample count
## Prerequisites
- Python 3.10+
- `pip`
- Valid `OLOSTEP_API_KEY`
- Internet access for API requests
## Quick Start
### 1) Install dependencies
```bash
pip install requests python-dotenv streamlit
```
### 2) Configure environment
Create `.env`:
```env
OLOSTEP_API_KEY=your_api_key_here
```
Create an API key from the [Olostep API Keys dashboard](https://www.olostep.com/dashboard/api-keys), then place it in `.env`.
### 3) Add product URLs
Add one URL per line in:
```text
data/product_urls.txt
```
## Run the App
### Streamlit dashboard
```bash
streamlit run app.py
```
### CLI one-time tracking
```bash
python run_tracker.py
```
Optional flags:
```bash
python run_tracker.py \
--csv output/price_tracker_history.csv \
--history-json output/product_price_history.json \
--urls-file data/product_urls.txt \
--sleep 2
```
### CLI scheduled tracking
```bash
python run_scheduler.py --interval-minutes 30
```
Optional flags:
```bash
python run_scheduler.py \
--interval-minutes 15 \
--csv output/price_tracker_history.csv \
--history-json output/product_price_history.json \
--urls-file data/product_urls.txt \
--sleep 2
```
## Output Files
All outputs are written to `output/` by default.
| File | Purpose |
|---|---|
| `output/price_tracker_history.csv` | Latest product snapshot including current/previous price and change direction |
| `output/product_price_history.json` | Per-product historical timeline with computed average price |
## Project Structure
```text
.
├── app.py # Streamlit dashboard entrypoint
├── run_tracker.py # CLI one-time tracking runner
├── run_scheduler.py # CLI scheduled tracking runner
├── assets/
│ ├── ui.png # Dashboard screenshot
│ └── thumbnail.png # Parser preview image
├── data/
│ └── product_urls.txt # Input URLs (one per line)
├── output/
│ ├── price_tracker_history.csv # Latest snapshot rows
│ └── product_price_history.json # Per-product historical timeline
└── src/
└── tracker/
├── constants.py # Defaults and shared constants
├── csv_store.py # CSV read/write and schema alignment
├── json_history.py # JSON history persistence
├── normalizer.py # Price and payload normalization
├── olostep_client.py # Olostep request client
├── scheduler.py # Scheduling loop logic
├── service.py # Core tracking orchestration
├── url_loader.py # URL loading and validation
└── utils.py # Shared helper utilities
```
## Notes
- If CSV schema changes, it is auto-aligned by the app.
- New products are appended.
- Existing products are updated on successful scrapes.
- On successful updates, old `price` is shifted to `previous_price`.
## Olostep Parser Reference
- [Olostep Parsers Documentation](https://docs.olostep.com/features/structured-content/parsers)
- [Olostep Authentication Guide](https://docs.olostep.com/get-started/authentication)
- [Parser preview image](assets/thumbnail.png)