How adrian-utz/price-checker works
Price Checker is a Flask product-watchlist app: users add or import retailer URLs, run or schedule price checks, and review current prices and history. In hosted modes, account and administrator workflows govern access to shared lists and quotas. Scans select a supported provider, cache and pace requests, and persist results in SQLite for charts and export. The README documents these capabilities; sampled excerpts do not expose all route implementations, so some connections are shown only where documentation or the source index supports them.
Main entry points: main.py Flask routes · database.py SQLite store · scanner.py Scan execution · providers.py Provider selection
Components 21
Web application
- Flask routes
main.py - Runtime settings
utils/config.py - Mode serving
utils/serving.py - Price charts
utils/charting.py - API debug tools
utils/dev_responses.py
Price scanning
- Scan execution
utils/scanner.py - Provider selection
utils/providers.py - SerpApi client
api_clients/serpapi_client.py - Unwrangle client
api_clients/unwrangle_client.py - Apify client
api_clients/apify_api_client.py - Retailer APIs
- List schedules
utils/schedules.py
Accounts and controls
- Usage limits
utils/limits.py - Authentication
utils/auth.py - User accounts
utils/users.py
Watchlist data
- Shared lists
utils/lists.py - Import and export
utils/watchlist_io.py - Product details
utils/product_utils.py - SQLite store
utils/database.py - Schema migrations
utils/migrations.py
Other components
- User
Connections 30
- User → Flask routes: uses
README.md - Flask routes → Runtime settings: loads settings
main.py - Flask routes → Mode serving: starts server
main.py - Flask routes → Authentication: authenticates
main.py - Flask routes → Scan execution: runs scans
main.py - Flask routes → List schedules: manages schedules
main.py - Flask routes → Shared lists: manages lists
main.py - Flask routes → Import and export: imports and exports
main.py - Flask routes → Price charts: renders charts
README.md - Flask routes → API debug tools: shows responses
README.md - Scan execution → Provider selection: fetches products
utils/scanner.py - Provider selection → SerpApi client: dispatches to
utils/providers.py - Provider selection → Unwrangle client: dispatches to
utils/providers.py - Provider selection → Apify client: dispatches to
utils/providers.py - SerpApi client → Retailer APIs: queries
README.md - Unwrangle client → Retailer APIs: queries
README.md - Apify client → Retailer APIs: queries
README.md - Scan execution → Usage limits: checks budgets
utils/scanner.py - Scan execution → SQLite store: records results
- List schedules → Scan execution: runs scheduled scans
README.md - Authentication → User accounts: checks accounts
utils/auth.py - Authentication → SQLite store: reads and updates
- User accounts → SQLite store: stores accounts
- Shared lists → SQLite store: stores lists
- Import and export → SQLite store: reads and merges
utils/watchlist_io.py - Price charts → SQLite store: reads history
- SQLite store → Schema migrations: initializes schema
utils/database.py - API debug tools → SQLite store: reads responses
main.py - Provider selection → API debug tools: records responses
utils/providers.py - Scan execution → Product details: normalizes products