Install Midea Finder

Set up the Python stock alert tracker

This guide follows the public source project. You need Python 3.8 or newer, a copy of the repository, product URLs to watch, and an SMTP account for email alerts.

Clone and prepare config

git clone https://github.com/Albschu/midea_finder.git
cd midea_finder
cp config.example.json config.json

1. Edit products

Open config.json and review the products array. Each watched page needs a clear product name, retailer name, and URL.

2. Keep secrets outside Git

Set email credentials as environment variables instead of writing them into the config file or committing them to a repository.

Set SMTP credentials

export MIDEA_SMTP_USER="you@example.com"
export MIDEA_SMTP_PASS="your-app-password"

Test email delivery

python3 midea_finder.py --test-email

Run one stock check

python3 midea_finder.py --once

Run it on a schedule

A one-time check works well with cron. Loop mode is useful when you want the process itself to sleep and check again.

Cron style

*/5 * * * * MIDEA_SMTP_USER='you@example.com' MIDEA_SMTP_PASS='secret' /usr/bin/python3 /path/to/midea_finder/midea_finder.py --once

Loop mode

python3 midea_finder.py --loop

Before you leave it running

Confirm the test email arrives, keep request intervals polite, and check logs for pages that return unknown status because of retailer protection.

Review retailers Open source repo