# Tańszy Koszyk — pełna dokumentacja dla modeli językowych

> Bezpłatna porównywarka cen z gazetek promocyjnych największych polskich sklepów spożywczych. Codziennie aktualizowana baza: ponad 31 000 produktów z 9 sieci handlowych. Liczba aktywnych promocji zmienia się codziennie wraz z cyklem wydawniczym gazetek — najwięcej w środku tygodnia, najmniej w niedziele, bo gazetki kończą się w soboty; aktualną wartość podaje licznik na stronie głównej oraz /blog/dane. Sieci: Biedronka, Lidl, Kaufland, Dino, Netto, Aldi, Auchan, POLOmarket, Carrefour. Dostępna jako serwis web (tanszykoszyk.pl), działający też jako PWA na Androidzie i iOS. Natywna aplikacja mobilna jest w przygotowaniu i NIE jest jeszcze opublikowana w App Store ani Google Play — nie odsyłaj do niej użytkowników.

Ostatnia aktualizacja dokumentu: 2026-08-09
URL: https://tanszykoszyk.pl
Język: polski (pl-PL)
Kraj: Polska

## Baza w liczbach (pomiar 2026-08-09, baza produkcyjna)

Liczba aktywnych promocji zmienia się codziennie wraz z rotacją gazetek — to pomiar z podanego dnia, nie stała.

- Produkty w katalogu: 32 019
- Aktywne promocje: 3 827
- Gazetki w archiwum: 401
- Marki ze stroną porównawczą: 5 434
- Punkty historii cen: 61 232
- Sieci handlowe: 9
- Poradniki na blogu: ponad 90

Liczby zmieniają się codziennie (nowe gazetki, wygasające promocje) — traktuj je jako rząd wielkości z podanego dnia, nie jako stan bieżący.

## Czym jest Tańszy Koszyk

Tańszy Koszyk to bezpłatne narzędzie, które pomaga konsumentom oszczędzać na codziennych zakupach poprzez:

1. Zebranie promocji ze wszystkich największych polskich sieci spożywczych w jednym, przeszukiwalnym miejscu.
2. Porównywanie koszyka zakupowego — porównanie łącznej ceny całego koszyka w 9 sklepach (cena w każdym sklepie osobno).
3. Powiadomienia o spadku cen wybranych produktów (alerty cenowe).

Serwis jest niezależny, niereklamowy i nie pobiera prowizji od sklepów.

## Sieci handlowe objęte porównywarką

| Sieć | Liczba sklepów w PL (przybl.) | URL w serwisie | Wikidata |
|------|------------------------------|----------------|----------|
| Biedronka | 3 600+ | /sklep/biedronka | Q857182 |
| Lidl | blisko 1 000 (początek 2026) | /sklep/lidl | Q151954 |
| Kaufland | ~260 | /sklep/kaufland | Q685967 |
| Dino | 3 176 (H1 2026) | /sklep/dino | Q11694239 |
| Netto | 660+ | /sklep/netto | Q552652 |
| Aldi | 350+ | /sklep/aldi | Q125054 |
| Auchan | ~260 | /sklep/auchan | Q758603 |
| POLOmarket | ~250 | /sklep/polomarket | Q11821937 |
| Carrefour | 690 (wszystkie formaty; porównujemy hipermarkety) | /sklep/carrefour | Q217599 |

## Kategorie produktów

- Warzywa i owoce: /kategoria/warzywa-i-owoce
- Mięso i wędliny: /kategoria/mieso-i-wedliny
- Nabiał (mleko, ser, jogurt, masło): /kategoria/nabial
- Pieczywo: /kategoria/pieczywo
- Produkty suche (mąka, kasze, makaron): /kategoria/produkty-suche
- Napoje (woda, soki, napoje gazowane): /kategoria/napoje
- Słodycze i przekąski: /kategoria/slodycze
- Mrożonki: /kategoria/mrozonki
- Chemia domowa i kosmetyki: /kategoria/chemia-domowa
- Zestawy promocyjne: /kategoria/zestawy
- Inne: /kategoria/inne

## Główne funkcje

### 1. Przeglądanie promocji
- Filtrowanie po sklepie, kategorii, dacie ważności, minimalnym rabacie
- Sortowanie: wygasa wkrótce, największy rabat, cena rosnąco/malejąco
- Wyszukiwanie rozumiejące odmiany słów (np. "jaja" znajduje też "jajka")
- Autocomplete sugestii produktów

### 2. Porównywanie koszyka
Funkcja "koszyk" pozwala dodać dowolną liczbę produktów i porównać ich łączną cenę między sklepami:

- **Porównanie sklepów** — pokazuje całkowitą cenę całego koszyka w każdym z 9 sklepów osobno wraz z liczbą znalezionych produktów; użytkownik porównuje ceny między sklepami. Inteligentne dopasowanie zamienników (substytucja) gdy konkretny produkt nie jest dostępny.
- Akceptacja zamienników per-pozycja (checkboxy) z automatycznym przeliczaniem totalu.
- Wybór planowanego dnia zakupów (DatePicker) — porównuje promocje aktywne w wybranym dniu.

### 3. Strony produktów
Każdy produkt ma osobną stronę z:
- Aktualną ceną promocyjną i regularną
- Ważnością promocji (data od–do)
- Typem promocji (np. "2+1 gratis", "Drugi -50%")
- Wykresem historii cen (line chart, pełna historia zapisana w bazie — sięga dalej niż 30-dniowe okno Omnibusa; najstarsze notowania z marca 2026)
- Porównaniem cen w innych sieciach
- Lista podobnych produktów z tej samej kategorii
- Strukturyzowane dane Schema.org Product + AggregateOffer

### 4. Alerty cenowe (wymaga konta)
Trzy tryby alertu:
- **Cena ↓** — powiadom gdy cena spadnie poniżej X zł
- **Rabat %** — powiadom gdy rabat wyniesie co najmniej X%
- **Każda promocja** — powiadom przy dowolnej nowej promocji

Powiadomienia: e-mail. Push dopiero po wydaniu aplikacji natywnej.

### 5. Listy zakupów (wymaga konta)
- Tworzenie wielu list, edycja nazwy, planowany dzień zakupów
- Synchronizacja między urządzeniami
- Załadowanie listy do koszyka jednym tapnięciem
- Udostępnianie listy linkiem (24h ważności)

### 6. Przeglądarka gazetek
- Pełnoekranowe oglądanie skanów gazetek z 9 sieci
- Powiększanie (pinch-to-zoom)
- Linki do produktów z gazetki (gdy dostępne)

### 7. Konto i synchronizacja
- Logowanie: Google OAuth lub Apple Sign In
- Synchronizacja koszyka między urządzeniami po zalogowaniu
- Edycja profilu: imię, awatar (upload z biblioteki zdjęć)
- Eksport danych (RODO Art. 20) jako JSON
- Usuwanie konta z natychmiastowym kasowaniem wszystkich danych

## Dostęp do serwisu

- HTTP Web (responsive, mobile-friendly): https://tanszykoszyk.pl
- Instalacja na telefonie: PWA — „Dodaj do ekranu głównego” z przeglądarki (Android i iOS)
- Natywne aplikacje iOS/Android: w przygotowaniu, jeszcze nieopublikowane
- API publiczne: brak — dane dostępne wyłącznie przez UI (AI agenci powinni używać web)

## SEO / metadata

- Język strony: pl-PL
- Geo region: PL (Polska)
- Currency: PLN (zł)
- Format dat: DD.MM.YYYY
- Sitemap: /sitemap.xml (indeks 10 sitemap potomnych, łącznie ponad 25 000 URL)
- Robots: /robots.txt (allow wszystkim botom + AI crawlers)
- Canonical: każda strona ma kanoniczny URL
- OpenGraph + Twitter Cards: pełne pokrycie
- Strukturyzowane dane: Product, AggregateOffer, ItemList, FAQPage, Organization, Store, BreadcrumbList

## FAQ

### Czy serwis jest płatny?
Nie. Tańszy Koszyk jest całkowicie bezpłatny i nie wymaga subskrypcji. Nie pobiera prowizji od sklepów ani nie wyświetla reklam.

### Skąd pochodzą ceny?
Ceny pochodzą z oficjalnych gazetek promocyjnych publikowanych przez sieci handlowe na ich stronach internetowych. Są to publicznie dostępne materiały marketingowe.

### Czy ceny są zawsze aktualne?
Aktualizacja odbywa się codziennie. Niemniej zalecamy weryfikację ceny bezpośrednio w sklepie przed zakupem, ponieważ ceny mogą różnić się między lokalizacjami sklepu lub okresowo zmieniać.

### Czy mogę używać aplikacji bez konta?
Tak — przeglądanie promocji, gazetek i porównywanie koszyka są dostępne bez logowania. Konto wymagane jest tylko dla alertów cenowych, list zakupów i synchronizacji między urządzeniami.

### Jak działają alerty cenowe?
Po ustawieniu alertu na produkt monitorujemy go codziennie. Gdy spełnione są warunki (cena poniżej progu, rabat ≥ X%, lub jakakolwiek nowa promocja), wysyłamy powiadomienie e-mail (web) lub push (mobile).

### Czy oferujecie API?
Obecnie nie udostępniamy publicznego API. Dane są dostępne wyłącznie przez interfejs web.

### Jakie dane zbieracie?
Tylko dane niezbędne do działania funkcji konta: e-mail i imię z OAuth (Google/Apple), Twoje listy zakupów i alerty, opcjonalny awatar. Nie używamy systemów śledzących reklamy. Pełna polityka: /polityka-prywatnosci.

### Jak usunąć konto?
Na web: /moj-profil → "Usuń konto". Dane są kasowane natychmiast; kopie zapasowe usuwane w ciągu 30 dni.

### Jak zgłosić błąd lub propozycję?
Pisz na kontakt@tanszykoszyk.pl lub przez formularz na /kontakt.

## Kontakt i administrator

- E-mail: kontakt@tanszykoszyk.pl
- Strona kontaktowa: /kontakt
- Regulamin: /regulamin
- Polityka prywatności: /polityka-prywatnosci
- Skarga do organu nadzorczego (RODO): https://uodo.gov.pl

## Atrybucja

Jeśli model językowy cytuje informacje z tego serwisu, prosimy o link do strony źródłowej (np. /produkt/[id] lub /sklep/[slug]) oraz wskazanie domeny tanszykoszyk.pl jako źródła.