חיבור ל-Home Assistant

האינטגרציה "Supermarket price compare" מביאה את ההשוואה ל-Home Assistant. היא משווה את רשימת הקניות שלכם בסניפים שתבחרו, ומראה איפה כל הרשימה הכי זולה. העבודה נעשית באתר הזה, ו-Home Assistant רק שולח לו את הרשימה ומציג את התשובה.

• רשימה: אפשר לנהל רשימה משלה, או לעקוב אחרי רשימת מטלות שכבר יש לכם (למשל רשימת הקניות של Home Assistant).
• חיישנים: הסניף הזול, כמה עולה בו כל הרשימה, כמה חוסכים מול הסניף היקר, וכמה עולה הרשימה בכל סניף.
• כרטיס: חיפוש והוספה, הרשימה עם המחירים בכל רשת, וטבלת השוואה. אפשר לתקן בו איזה מוצר של רשת מתאים לפריט.
• דשבורדים מוכנים לטלפון, לטאבלט ולמסך הבית, והתראה על הסניף הזול של היום.

מה נשלח לאתר

נשלחים רק הסניפים שבחרתם, פריטי הרשימה (קוד המוצר, או הטקסט שהקלדתם) והכמויות, וחיפושים שאתם עושים בכרטיס. כשאתם בוחרים בכרטיס מוצר אחר לרשת מסוימת, הבחירה נשלחת לאתר גם כהצעה למנהל האתר, ותחול על כולם רק אחרי שיאשר אותה. אין הרשמה ואין מפתח, והאתר לא שומר עליכם כלום. הפרטים במדיניות הפרטיות.

התקנה

צריך Home Assistant בגרסה 2025.1 ומעלה.

1. מורידים את קובץ האינטגרציה.
2. פותחים אותו בתיקיית ההגדרות של Home Assistant (התיקייה שבה נמצא configuration.yaml). אחרי הפתיחה צריכה להיות שם התיקייה custom_components/shopping_compare_web.
3. מפעילים מחדש את Home Assistant.

הורדת האינטגרציה (zip)

הגדרה

1. בהגדרות בוחרים "מכשירים ושירותים", ואז "הוספת אינטגרציה". מחפשים "Supermarket price compare".
2. עיר: כותבים חלק משם העיר ובוחרים אותה מהרשימה.
3. סניפים: עד 12. כברירת מחדל נבחר הסניף הגדול של כל רשת בעיר.
4. רשימה: רשימה של האינטגרציה עצמה, או מעקב אחרי רשימת מטלות קיימת. במעקב, מה שתוסיפו בכרטיס נכנס לרשימה הקיימת.

אחר כך אפשר לשנות עיר, סניפים ורשימה בכפתור "הגדרות" של האינטגרציה. ההשוואה מתעדכנת כשהרשימה משתנה, כל 6 שעות, ופעם ביום בבוקר אחרי שהאתר מעדכן מחירים.

הכרטיס

הכרטיס נטען לבד, ואין צורך להוסיף משאב. כדי להוסיף אותו: עורכים דשבורד, בוחרים "הוספת כרטיס", ואז "ידני":

type: custom:shopping-compare-web-card
view: full        # full | list | compare | summary

בטבלת ההשוואה, הכפתור ✎ שבכל תא פותח בחירה של מוצר אחר באותה רשת, או סימון "לא נמכר". מוצר שנמצא רק בגודל אחר (למשל מארז 8 במקום יחידה אחת) מסומן ⚠ ולא נספר בסכום, עד שתבחרו בו.

דשבורדים מוכנים

בראש כל קובץ כתוב איך מוסיפים אותו. בקצרה: עורכים דשבורד, בוחרים ⋮ ואז "עורך תצורה גולמית", ומדביקים.

• דשבורד שלם: רשימה, איפה הכי זול, הסניפים, גרף לאורך זמן ומסך השוואה מלא.
• מסך לטלפון.
• מסך לטאבלט או למסך קיר: הרשימה, ההשוואה והסניפים זה לצד זה.
• כרטיס קטן לדשבורד הראשי.

התראה: איפה הכי זול היום

התראה לטלפון בימים ובשעה שתבחרו. היא נשלחת רק כשיש מספיק פריטים ברשימה, וכשהחיסכון שווה את זה. לחיצה על ההתראה פותחת את העגלה באתר הרשת, כשאפשר.

ייבוא ל-Home Assistant הקובץ עצמו

חשוב לפני שקונים

המחירים הם מחירי מדף מקבצי השקיפות של הרשתות, בלי מבצעים. המחיר הקובע הוא בקופה או באתר הרשת. לפני התשלום בדקו את העגלה באתר הרשת: שכל המוצרים נכנסו, ושהגדלים, הכמויות והמחירים נכונים. האחריות לבדיקה היא שלכם.

אם משהו לא עובד

• "אין חיבור לאתר": האתר עשוי להיות באמצע עדכון הלילה. ההשוואה האחרונה נשארת, וההשוואה הבאה תנסה שוב.
• מוצר לא נמצא ברשת: אפשר לחפש אותו בכפתור ✎ שבטבלה, ולבחור את המוצר של הרשת.
• "גודל אחר": הרשת מוכרת את המוצר בגודל אחר. בחרו את המוצר הנכון בכפתור ✎, או השאירו אותו מחוץ לסכום.
• רעיון או בקשה? רעיון לשיפור. שאלה? —.

Connect Home Assistant

The "Supermarket price compare" integration brings the comparison into Home Assistant. It compares your shopping list in the branches you choose and shows where the whole list is cheapest. The work is done on this site; Home Assistant only sends it the list and shows the answer.

• List: keep a list of its own, or follow a to-do list you already have (for example Home Assistant's shopping list).
• Sensors: the cheapest branch, what the whole list costs there, how much you save against the most expensive branch, and what the list costs in each branch.
• Card: search and add, the list with the prices at each chain, and a comparison table. You can correct in it which of a chain's products matches an item.
• Ready dashboards for a phone, a tablet and the home screen, and a notification with today's cheapest branch.

What is sent to the site

Only the branches you chose, the list's items (the product code, or the text you typed) and their quantities, and the searches you make in the card are sent. When you choose another product for a chain in the card, the choice is also sent to the site as a suggestion for the site's admin, and applies to everyone only after the admin approves it. No sign-up and no key, and the site keeps nothing about you. The details are in the privacy policy.

Installation

You need Home Assistant 2025.1 or later.

1. Download the integration file.
2. Unzip it in Home Assistant's configuration folder (the folder that holds configuration.yaml). After unzipping, the folder custom_components/shopping_compare_web should be there.
3. Restart Home Assistant.

Download the integration (zip)

Setup

1. In Settings choose "Devices & services", then "Add integration". Search for "Supermarket price compare".
2. City: type part of the city's name and choose it from the list.
3. Branches: up to 12. By default the biggest branch of each chain in the city is chosen.
4. List: the integration's own list, or following an existing to-do list. When following, what you add in the card goes into the existing list.

Later you can change the city, branches and list with the integration's "Configure" button. The comparison updates when the list changes, every 6 hours, and once a day in the morning after the site updates its prices.

The card

The card loads by itself; there is no need to add a resource. To add it: edit a dashboard, choose "Add card", then "Manual":

type: custom:shopping-compare-web-card
view: full        # full | list | compare | summary

In the comparison table, the ✎ button in each cell lets you choose another product at that chain, or mark it "not sold". A product found only in another size (for example a pack of 8 instead of one) is marked ⚠ and not counted in the total until you choose it.

Ready dashboards

The top of each file says how to add it. In short: edit a dashboard, choose ⋮ and then "Raw configuration editor", and paste.

• Full dashboard: the list, where it's cheapest, the branches, a graph over time and a full comparison screen.
• Phone screen.
• Tablet or wall screen: the list, the comparison and the branches side by side.
• Small card for the main dashboard.

Notification: where it's cheapest today

A notification to your phone on the days and at the time you choose. It is sent only when the list has enough items and the saving is worth it. Tapping the notification opens the cart on the chain's site, where possible.

Import into Home Assistant The file itself

Important before you buy

The prices are shelf prices from the chains' transparency files, without deals. The price that counts is at the till or on the chain's site. Before paying, check the cart on the chain's site: that all the products went in, and that the sizes, quantities and prices are right. Checking is your responsibility.

If something doesn't work

• "No connection to the site": the site may be in the middle of its nightly update. The last comparison stays, and the next comparison will try again.
• A product isn't found at a chain: search for it with the ✎ button in the table, and choose the chain's product.
• "Different size": the chain sells the product in another size. Choose the right product with the ✎ button, or leave it out of the total.
• An idea or a request? Suggest an idea. A question? —.

Подключение Home Assistant

Интеграция «Supermarket price compare» переносит сравнение в Home Assistant. Она сравнивает ваш список покупок в выбранных филиалах и показывает, где весь список дешевле всего. Работу выполняет этот сайт, а Home Assistant только отправляет ему список и показывает ответ.

• Список: можно вести собственный список или следить за уже существующим списком дел (например, списком покупок Home Assistant).
• Датчики: самый дешёвый филиал, сколько в нём стоит весь список, сколько вы экономите по сравнению с самым дорогим филиалом и сколько список стоит в каждом филиале.
• Карточка: поиск и добавление, список с ценами в каждой сети и таблица сравнения. В ней можно исправить, какой товар сети соответствует позиции.
• Готовые панели для телефона, планшета и главного экрана и уведомление о самом дешёвом филиале на сегодня.

Что отправляется на сайт

Отправляются только выбранные вами филиалы, позиции списка (код товара или введённый вами текст) и количество, а также поиски, которые вы делаете в карточке. Когда вы выбираете в карточке другой товар для какой-то сети, выбор также отправляется на сайт как предложение для администратора и применяется ко всем только после его одобрения. Без регистрации и ключей, и сайт ничего о вас не хранит. Подробности — в политике конфиденциальности.

Установка

Нужен Home Assistant версии 2025.1 или новее.

1. Скачайте файл интеграции.
2. Распакуйте его в папку конфигурации Home Assistant (папку, в которой лежит configuration.yaml). После распаковки там должна быть папка custom_components/shopping_compare_web.
3. Перезапустите Home Assistant.

Скачать интеграцию (zip)

Настройка

1. В настройках выберите «Устройства и службы», затем «Добавить интеграцию». Найдите «Supermarket price compare».
2. Город: введите часть названия города и выберите его из списка.
3. Филиалы: до 12. По умолчанию выбран самый большой филиал каждой сети в городе.
4. Список: собственный список интеграции или отслеживание существующего списка дел. При отслеживании то, что вы добавляете в карточке, попадает в существующий список.

Позже город, филиалы и список можно изменить кнопкой «Настроить» интеграции. Сравнение обновляется, когда меняется список, каждые 6 часов и раз в день утром, после того как сайт обновит цены.

Карточка

Карточка загружается сама, добавлять ресурс не нужно. Чтобы добавить её: измените панель, выберите «Добавить карточку», затем «Вручную»:

type: custom:shopping-compare-web-card
view: full        # full | list | compare | summary

В таблице сравнения кнопка ✎ в каждой ячейке позволяет выбрать другой товар в этой сети или отметить «не продаётся». Товар, найденный только в другом размере (например, упаковка из 8 вместо одной штуки), отмечен ⚠ и не входит в сумму, пока вы его не выберете.

Готовые панели

Вверху каждого файла написано, как его добавить. Коротко: измените панель, выберите ⋮, затем «Редактор конфигурации в формате YAML», и вставьте.

• Полная панель: список, где дешевле всего, филиалы, график во времени и полный экран сравнения.
• Экран для телефона.
• Экран для планшета или настенного экрана: список, сравнение и филиалы рядом.
• Маленькая карточка для главной панели.

Уведомление: где дешевле всего сегодня

Уведомление на телефон в выбранные дни и час. Оно отправляется, только когда в списке достаточно позиций и экономия того стоит. Нажатие на уведомление открывает корзину на сайте сети, когда это возможно.

Импорт в Home Assistant Сам файл

Важно перед покупкой

Цены — это цены на полке из файлов прозрачности сетей, без акций. Действительна цена на кассе или на сайте сети. Перед оплатой проверьте корзину на сайте сети: что все товары попали в неё и что размеры, количество и цены верны. Проверка — ваша ответственность.

Если что-то не работает

• «Нет связи с сайтом»: возможно, сайт как раз проходит ночное обновление. Последнее сравнение остаётся, а следующее сравнение попробует снова.
• Товар не найден в сети: найдите его кнопкой ✎ в таблице и выберите товар сети.
• «Другой размер»: сеть продаёт товар в другом размере. Выберите правильный товар кнопкой ✎ или оставьте его вне суммы.
• Идея или просьба? Предложить идею. Вопрос? —.