zsobix/lidlplus-api — reverse-engineered prompt

Build me a small Python library that lets my own scripts talk to my Lidl Plus account without using the Lidl app directly. I want to log in with my email and password, or reuse a refresh token if I already have one, then fetch useful account info like receipts, coupons, active coupon count, stores, offers, brochures, loyalty ID and the QR code data.

Please make it easy to install with pip and simple to use from a Python script. Include a clear README with examples for logging in, listing receipts, getting one receipt, finding stores, viewing coupons for a store, activating and deactivating a coupon, and checking store details or schedule.

Use Playwright for the login flow if needed, but also support running with just a refresh token for systems where browser automation is awkward. Keep the code organized, handle paging for receipts, and make errors understandable. Add a short legal note that this is unofficial, educational, and not affiliated with Lidl.