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.

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".