An unofficial read-only Python client and CLI tool for querying current grocery and product discounts from physical Lidl stores via public Lidl Plus endpoints without requiring user login.
Key Capabilities
- Store Discovery: Search Lidl stores using autocomplete queries or location-based catalog search.
- Store Metadata: Displays store addresses, opening hours, and distance coordinates.
- Discount & Offer Retrieval: Fetches all active weekly discounts, deal percentages, regular prices, and promotional validity windows.
- Clean CLI Formatting: Tabular terminal output with discount breakdowns and unit pricing.
Usage Example
# Query offers for stores in a city
uv run main.py Hamburg
# Example Output:
# Hamburg - Horn (DE5868)
# Hamburg - Horn, Manshardtstraße 74, 22119 Hamburg-Wandsbek
# Offers: 50
# Product | Offer | Regular | Deal | Valid
# ------------------------------- | ------- | ------- | ---- | -----------------------
# Pizza Tradizionale | 1.88 € | 3.69 € | -49% | 2026-05-03 - 2026-05-09