Israel Supermarket Parsers: Clients to parser the data published by the supermarkets.

This is a parser for ALL the supermarket chains listed in the GOV.IL site.

שקיפות מחירים (השוואת מחירים) - https://www.gov.il/he/departments/legalInfo/cpfta_prices_regulations הגדרת הקבצים שהיו צריכים להיות זמינים באתרים - https://www.nevo.co.il/law_html/law01/501_131.htm

Daily Automatic Testing

The test suite is scheduled to run daily, so you can see if the supermarket chains have changed something in their interface and the package will not work properly.

Status:

🤗 Want to support my work?

Got a question?

You can email me at erlichsefi@gmail.com

If you think you've found a bug:

Create issue in issue tracker to see if it's already been reported
Please consider solving the issue by yourself and creating a pull request.

What is il_supermarket_parsers?

A simple access layer to the data the supermarkets publish. You can download the data using https://github.com/OpenIsraeliSupermarkets/israeli-supermarket-scarpers.

You only need to run the following code to parse all the data currently shared by the supermarkets and was downloaded using the package above.

from il_supermarket_parsers import ConvertingTask

task = ConvertingTask(
    source_configuration={"folder": "dumps"},
    output_configuration=[{"output_mode": "csv", "output_folder": "outputs"}],
    status_configuration={"database_type": "json", "base_path": "outputs"},
)
task.start()
task.join()

Optional filters (same names as Docker): enabled_parsers, files_types, and multiprocessing. Pass a maximum number of files with task.start(limit=10).

Quick start

il_supermarket_parsers can be installed using pip:

python3 pip install il_supermarket_parsers

If you want to run the latest version of the code, you can install it from the repo directly:

python3 -m pip install -U git+https://github.com/OpenIsraeliSupermarkets/israeli-supermarket-parsers.git
# or if you don't have 'git' installed
python3 -m pip install -U https://github.com/OpenIsraeliSupermarkets/israeli-supermarket-parsers/main

Running Docker

Build yourself:

docker build -t erlichsefi/israeli-supermarket-parsers --target prod .

or pull the existing image from docker hub:

docker pull erlichsefi/israeli-supermarket-parsers:latest

Then running it using:

docker run  -v "./dumps:/usr/src/app/dumps" \
            -v "./outputs:/usr/src/app/outputs" \
            -e ENABLED_PARSERS="BAREKET,YAYNO_BITAN_AND_CARREFOUR" \
            -e ENABLED_FILE_TYPES="STORE_FILE" \
            -e NUMBER_OF_PROCESSES=4 \
            -e LIMIT=1 \
            erlichsefi/israeli-supermarket-parsers

Optional paths (defaults match the volumes above): DATA_FOLDER (input), OUTPUT_FOLDER (CSV output), STATUS_FOLDER (JSON status; defaults to OUTPUT_FOLDER). Optional tuning: NUMBER_OF_PROCESSES, ENABLED_PARSERS, and ENABLED_FILE_TYPES (comma-separated enum names), LIMIT.

Contributing

Help in testing, development, documentation and other tasks is highly appreciated and useful to the project. There are tasks for contributors of all experience levels.

If you need help getting started, don't hesitate to contact me.

Development status

IL SuperMarket Parser is beta software, as far as i see devlopment stoped until new issues will be found.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

il_supermarket_parser-1.0.3.tar.gz (41.1 kB view details)

Uploaded Jul 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

il_supermarket_parser-1.0.3-py3-none-any.whl (62.6 kB view details)

Uploaded Jul 24, 2026 Python 3

File details

Details for the file il_supermarket_parser-1.0.3.tar.gz.

File metadata

Download URL: il_supermarket_parser-1.0.3.tar.gz
Upload date: Jul 24, 2026
Size: 41.1 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for il_supermarket_parser-1.0.3.tar.gz
Algorithm	Hash digest
SHA256	`7d6bbd84cf1a4d07c22574bd3542c48cc6995c6cf9a3852cebbfc0af3458e3a3`
MD5	`7c71532037decdc9e38a5fc57c41e64b`
BLAKE2b-256	`3d6c93e4387048d31166d3f945847328c7374919755c44e622da6112c60005cd`

See more details on using hashes here.

File details

Details for the file il_supermarket_parser-1.0.3-py3-none-any.whl.

File metadata

Download URL: il_supermarket_parser-1.0.3-py3-none-any.whl
Upload date: Jul 24, 2026
Size: 62.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for il_supermarket_parser-1.0.3-py3-none-any.whl
Algorithm	Hash digest
SHA256	`3fefe386b49f0771db45af9dd74cf9e076b3c149593f5d21f490accd2dc2f5d2`
MD5	`def25a2d6ec3752acddc85178afa368e`
BLAKE2b-256	`cc4cbf1ab7e526ac96f953d9632d9e50de26e09f310219ce0e256e970c70be76`