Log in to Tiv Taam with email and password.

Args:
    email: Your Tiv Taam account email address.
    password: Your Tiv Taam account password.

Open a browser window for Shufersal login.
Complete the sign-in on shufersal.co.il and the session will be captured automatically.
Requires Playwright: run `uv run playwright install chromium` once.

Perform a live login check for one or all stores.

Args:
    store_id: "shufersal" or "tivtaam", or omit for all.

Set your shopping preferences.

Args:
    preferred_store: Default store ("shufersal" or "tivtaam"). None = always compare.
    shopping_strategy: "cheapest" | "preferred_store" | "quality"
    prefer_organic: Prefer organic products when available.
    prefer_budget: Prefer sale/discounted products.
    prefer_store_brand: Prefer Shufersal-brand products.
    preferred_brands: Brand names to prefer (e.g. ["Tnuva", "Osem"]).
    banned_keywords: Words to avoid in product names.
    skip_pantry: Skip common pantry staples (salt, oil, spices) when parsing recipes.
    tivtaam_branch_id: Override Tiv Taam branch ID (default: 943).

Search for products across all (or selected) grocery stores.

Args:
    query: Search term (English or Hebrew).
    stores: Limit to specific stores, e.g. ["tivtaam"] or ["shufersal", "tivtaam"].
    max_results: Max results per store (default: 8).

Compare prices for a product across all connected stores.

Args:
    query: What you're looking for (e.g. "eggs", "chicken breast").

Show the current cart contents.

Args:
    store_id: "shufersal" or "tivtaam". If omitted, shows all carts.

Add a specific product to a store's cart.

Args:
    store_id: "shufersal" or "tivtaam".
    product_id: The product ID from search results.
    quantity: Number of units (default: 1).

Re-check every item in the cart for live stock availability and automatically
swap out-of-stock items with the best available replacement.

Call this after adding all items to a cart to catch anything that went
out of stock between search and checkout.

Args:
    store_id: Which store cart to verify. Currently supports "tivtaam".

Parse a recipe and list the ingredients that will be searched for.

Args:
    recipe_text: Recipe text with ingredients list, or a URL to a recipe page.

Parse a recipe and compare ingredient prices across all connected stores.
Shows which store is cheapest overall and where to buy each item for the best deal.

Args:
    recipe_text: Recipe text or URL.

Parse a recipe, find best-matching products, and add them to a cart.

Args:
    recipe_text: Recipe text or URL.
    store_id: Which store to add to ("shufersal" or "tivtaam").
              If omitted, uses your preferred_store or the cheapest per item.
    strategy: "cheapest" — buy each item from its cheapest store.
              "preferred_store" — use your preferred_store for everything.
              "single_store" — use store_id for everything (requires store_id).
    confirm_all: If True, add low-confidence matches without pausing.

Run a full diagnostic for one or all stores.
Shows session status, raw API response, and parsed result count.

Args:
    store_id: "shufersal" or "tivtaam" — omit to check all.
    test_query: Simple English word to test search (default: "eggs").