Open-source Midea watcher

Midea PortaSplit stock alerts

Watch retailer product pages, detect real availability changes, and get an email when a sold-out unit comes back.

Python 3.8+ No external packages Email alerts
Portable air conditioner beside a laptop showing availability alert rows
A practical stock alert workflow for people waiting on Midea PortaSplit availability.

Quick answer

What does Midea Finder do?

Midea Finder is a small Python stock alert tool. It checks configured retailer pages, reads schema.org availability when present, falls back to visible page text when needed, stores the last result, and sends one email when an item changes from sold out to available.

Built for the exact restock problem

The source project focuses on Midea PortaSplit availability across German DIY store product pages. The method is simple enough to audit and flexible enough to extend.

Reads product-page signals

It checks machine-readable JSON-LD offers first, then scans visible German availability phrases when a page does not expose clean structured data.

Avoids alert spam

The tracker stores previous product status in a local state file and only sends a message when availability changes in the useful direction.

Runs where you control it

Use a one-time check in cron, keep it running as a loop, or install the supplied systemd timer on a small Linux box.

How the stock alert loop works

The workflow stays intentionally boring. Fewer moving parts means fewer surprises while you are waiting for a restock.

Add the product URLs you want to watch

Each entry includes a product name, retailer name, and product-page URL in the local config file.

Run a check on your schedule

Use a single command for cron or run the loop mode when you want the process to keep checking every few minutes.

Get notified when stock returns

When a product moves from out of stock to in stock, Midea Finder sends one email through your configured SMTP account.

Good fit, poor fit

This site is for users who want to run the open-source tracker themselves. It is not a hosted paid alert service.

Good fit

  • You can run Python locally or on a small server.
  • You want email alerts for online product-page availability.
  • You prefer readable code over a closed hosted service.
  • You are comfortable editing a JSON config file.

Poor fit

  • You need live branch inventory across every store location.
  • You want a hosted account, map, payment, or mobile app.
  • You expect guaranteed results from retailer pages with bot protection.
  • You do not want to configure SMTP credentials.

Start with the install guide

Copy the config template, set SMTP credentials through environment variables, send a test email, then run one stock check.