israel-shopping

Append a user-added Israeli vendor to the persistent user store list (under the CLAUDE_USER_DATA-resolved plugin data directory) with auto-dedup. Survives plugin updates.

Convert between ILS and the three common foreign currencies for Israeli shopping — USD, EUR, GBP — in either direction. Uses a live exchange-rate API with a fallback rate. Use whenever the user asks to convert a price or wants ILS↔USD/EUR/GBP figures.

Playful "are you a freier" (sucker) assessment — given an Israeli price and international RRP, compute the premium and deliver a verdict on the freier scale. Light-hearted counterpart to `/rrp-check`.

Broader Israeli retail search beyond the tier-1 tech four — Ace, Home Center, Office Depot, Audioline, plus Google IL discovery and niche category-dispatched search. Use for household/office/audio/appliance products, or when tier-1 tech retailers don't carry the item.

Given an Israeli product listing, find what manufacturer part-number (PN) / SKU it corresponds to on the international market. Useful because Israeli retailers often relabel consumables (toner cartridges, filters, replacement parts) with odd local PNs that don't match the manufacturer's global catalog.

Compare an Israeli price (ILS) against the international RRP/MSRP or a specific international retailer (Amazon, B&H, manufacturer). Reports markup % and a verdict (good deal / fair / above average / heavy markup) with import-cost realism.

Search zap.co.il — the canonical Israeli price-comparison aggregator. Zap indexes prices across all tier-1 and tier-2 IL retailers plus many niche specialists, so one Zap search often beats querying each retailer individually. Use as the default first-pass for any cross-retailer price comparison in Israel. Fall back to per-retailer skills only for SKUs Zap doesn't index.

Given an Israeli retailer name (Hebrew or English), find its Zap.co.il profile URL and retrieve the seller rating and review count. Useful for vetting an unfamiliar retailer before buying.

Search the four tier-1 Israeli tech retailers — Ivory, KSP, Bug, TMS — for a consumer-tech product (laptop, phone, peripheral, accessory, charger, cable, monitor, TV, headphones, etc.) and return prices ranked low-to-high. Handles Hebrew-term resolution and falls back to Playwright when Tavily/WebFetch is blocked.

Identify an obscure brand encountered only in Israel. Many IL-market brands are white-labelled / rebadged versions of global brands or importer-specific labels. Returns probable OEM and international equivalent.

Use when the user wants to search AliExpress and **hide products that carry the `Max Combo` badge** — i.e. exclude bundle/combo deals from the result set so only standalone listings remain. AliExpress provides no server-side filter for this on the listing page (validated — see `research/ui-selectors/listing-page-filters.md` §3); the skill therefore runs the standard search via `search-aliexpress`, then post-filters the visible product cards by reading the `Max Combo` badge text in the card DOM and dropping any card that has it. Trigger phrases — "search aliexpress without combo", "exclude max combo", "no bundle deals aliexpress", "aliexpress single items only", "hide combo deals".

Fallback for `fetch-listing` when the no-auth scraper is broken. Calls the official AliExpress Affiliate API (HMAC-SHA256 signed against `api-sg.aliexpress.com/sync`) — counterintuitively returns LESS buyer-relevant data than the scraper (no shipping fees, no reviews, no specs, no lead time) because the API is designed for affiliate-marketing publishers, not buyer-side analysis. Use only when the scraper fails (DOM rotation, anti-bot, rate-limit) or for a quick affiliate-catalogue search without spinning up Puppeteer. Two modes — `detail <productId>` and `search <query>`. Output normalised to drop affiliate-specific fields (commission rates, tracked promotion links). Trigger phrases — "scraper is broken fall back to the api", "use the affiliate api", "scrape failed try the api".

Use when the user provides a specific AliExpress product URL or ID and wants the listing parsed into structured JSON — title, price, ship-to-Israel fee, lead time, ratings, store, and a computed landed cost (item + shipping, with optional 18% Israeli VAT band for items over $75 USD). Default locale is English/USD; opt in to Hebrew/ILS via `--locale he-IL`. Uses the no-auth Puppeteer scraper (`aliexpress-product-scraper`) — no API credentials needed. Trigger phrases — "fetch this aliexpress listing", "parse this aliexpress url", "what's the landed cost of this aliexpress item", "scrape aliexpress product".

Use when the user wants to search AliExpress and **only see results with free shipping to Israel** — applying the validated server-side `filterCode:freeshipping` toggle on the listing page so paid-shipping listings are excluded before scraping. This is the IL-context shorthand for `search-aliexpress` with `filters.freeshipping=true`; it exists as a standalone skill so triggers like "free shipping only" route to the right preset without the caller having to know the param name. Trigger phrases — "free shipping only", "aliexpress free shipping", "no shipping fee aliexpress", "search aliexpress with free delivery to israel", "ship free to il".

Use when the user wants to see only the reviews left by Israeli buyers (`reviews from IL`) on an AliExpress product page — filtering out the global review pool and surfacing what people who actually shipped to Israel said about the item, including the variant/SKU they bought, star rating, photos, review text, and date. Drives the AliExpress product page (`/item/<id>.html`) reviews section via Playwright, clicks the IL country-flag chip in the review-filter strip (validated version-agnostic selector — `[class*="country-flag-"].IL`), expands "View more" if present, and extracts the per-review fields. Trigger phrases — "show israeli reviews", "what do israelis say about X", "il reviews aliexpress", "filter aliexpress reviews to israel", "reviews from israel for this listing".

Use when the user wants to search AliExpress for a product from an Israel-based buyer's perspective — returning results priced in ILS, with the AliExpress site set to the Israel channel and Hebrew locale, and with optional filters for Choice, free shipping, 4★+ ratings, and ship-from country (IL / CN / TR). Drives the AliExpress search results page (`https://he.aliexpress.com/w/wholesale-<query>.html`) via a visible Playwright browser, applies filters via the validated stable selectors (`aria-label="filterCode:*"` and `aria-label="<ISO-2>"`), and extracts the visible product cards. Trigger phrases — "search aliexpress for X", "find X on aliexpress in ILS", "aliexpress IL search", "aliexpress with ship from israel", "aliexpress choice only".

Use when the user wants to check whether a product they've found on AliExpress (or are considering importing) is also sold by Israeli retailers — and at what price. Runs two separate web searches scoped to Israeli sources — one with `site:il` (broad — Ksp, Bug, Ivory, Zap-listed shops, manufacturer .co.il pages, etc.) and one with `site:zap.co.il` (Zap, Israel's main price-comparison aggregator) — then summarises the cheapest local options in ILS for side-by-side comparison with the AliExpress listing. Trigger phrases — "compare to local", "is this sold in israel", "check zap for X", "site:il price for X", "local price israel", "compare aliexpress to local".