michraz

Israeli public tenders (מכרזים) in Python. One Tender object, whichever site it came from.

Sources today: Israel Land Authority land tenders and Beer Sheva municipal tenders.

Unofficial client. It can lag or miss tenders, and parsing can break when a source changes. Confirm deadlines on the publisher's page before you act. Not affiliated with the Israel Land Authority or any municipality.

Install

pip install michraz            # Python 3.10+
pip install "michraz[pandas]"  # optional, for DataFrames

Use it

from michraz import Michraz, to_csv

with Michraz() as m:
    tenders = m.search(keyword="גינון", open_only=True)

for t in tenders:
    print(f"{t.deadline:%Y-%m-%d}  {t.title}  {t.url}")

to_csv(tenders, "tenders.csv")

Results are sorted by deadline. Filter by source, closing_before and closing_after (dates or aware datetimes) too. Each tender has an attribution string. Keep it when you republish the data.

Or from the terminal:

michraz search --open --source rmi
michraz search --keyword גינון --csv gardening.csv

A record that fails to parse is skipped and listed in m.last_errors. An unreachable source raises SourceUnavailableError. More scripts are in examples.

Add a source

Write a class with name, description, attribution, errors and a fetch() that yields Tenders, then pass it to Michraz([MySource()]).

Fields are documented in docs/model.md, and how each source was checked in docs/sources.md.

Polite by default

Honest User-Agent, one request per second per host, one-hour disk cache, at most two retries. Tune it with Michraz(cache_dir=None, cache_ttl=..., min_interval=...).

Limitations

• RMI region, type, purpose and status are raw numeric codes in tender.extra. No verified label table exists.
• RMI tender details and documents are not fetched yet.
• Keyword search is a Unicode-normalized substring match. No stemming.

Development

make venv && make check

Tests run against recorded responses and never touch the network. See CONTRIBUTING.md.

MIT licensed. The data belongs to its publishers and carries their licenses.