Retailer tracker
Midea Finder works best when each product entry points to a stable retailer product page. This page explains how to organize those URLs and what to expect from each source.
The source project was built for German DIY store pages such as OBI, toom, BAUHAUS, HORNBACH, and related retailers. It does not need retailer-specific plugins. Each URL is checked with the same availability parser.
| Retailer source | What to add | Signal to watch | Practical note |
|---|---|---|---|
| OBI | Product-page URL for the PortaSplit model or accessory | JSON-LD availability or visible add-to-cart text | Check whether the page represents online availability or a local store view. |
| toom | Stable product URL from the product detail page | Availability wording in the rendered page | Keep request intervals polite because pages can change or rate-limit automation. |
| BAUHAUS | Model-specific URL for PortaSplit, PortaSplit Cool, or accessories | Structured offers data when exposed | If status returns unknown, inspect the page manually before assuming no stock. |
| HORNBACH | Product URL with the exact unit you want to buy | Schema.org offers availability and fallback keywords | Some page states may depend on location, cookies, or delivery option. |
| Other stores | Name, retailer label, and URL in config.json |
Any stock wording the parser can recognize | Review logs after adding a new store so unknown results are caught early. |
Use one entry per watched product page. Clear names help you understand alert emails quickly when several retailers are being checked.
{
"name": "Midea PortaSplit",
"retailer": "OBI",
"url": "https://example-retailer.test/product-page"
}Retailers often separate online delivery status from branch inventory. Midea Finder is best treated as a product-page tracker unless your chosen URL clearly exposes branch-specific stock.
The parser can fall back to visible text when JSON-LD is missing. If you add a new store, compare the page text for in-stock and sold-out states so the terms are not ambiguous.
Add-to-cart text, delivery availability, and pickup wording usually indicate the page is actionable.
Phrases such as unavailable, sold out, or not deliverable should prevent a false positive alert.
Unknown is a safe result when a page blocks requests or exposes no reliable availability signal.