israeli-tech-shopping-mcp
v0.1.0
Published
MCP server for shopping Israeli tech retailers with browser automation on the user's host
Maintainers
Readme
Israeli Tech Shopping MCP
An MCP (Model Context Protocol) server for comparison shopping across Israeli tech retailers. Uses Playwright browser automation on your local machine (your IP, your locale) to search, scrape prices, compare to international RRP, and generate PDF reports via Typst.
Features
- Search Israeli retailers — KSP, Ivory, Bug, TMS, iDigital, Zap, and more
- Auto-translate — English queries automatically translated to Hebrew for searching
- Price comparison — find the best price across multiple retailers
- RRP lookup — compare Israeli prices against international recommended retail prices
- USD/ILS conversion — live exchange rates
- VAT verification — detects ex-VAT prices and adds 18% when needed
- Eilat pricing — automatically uses regular (non-Eilat) prices on KSP and similar
- PDF reports — generates shopping reports with recommendations via Typst
- Tiered searching — search mainstream chains only, or broaden to niche/brand stores
Supported Retailers
Tier 1 — Mainstream (big high-street chains)
| Retailer | Domain | |----------|--------| | KSP | ksp.co.il | | Ivory | ivory.co.il | | Bug | bug.co.il | | TMS | tms.co.il | | Machsanei Hashmal | payngo.co.il | | Kravitz | kravitz.co.il | | iDigital | idigital.co.il |
Tier 2 — Major
| Retailer | Domain | |----------|--------| | Ace | ace.co.il | | Home Center | homecenter.co.il | | Office Depot | officedepot.co.il | | Audioline | audioline.co.il |
Tier 3 — Niche
| Retailer | Domain | |----------|--------| | Alpesek (UPS) | alpesek.co.il | | Sollan (Batteries) | sollan.co.il |
Tier 4 — Brand
| Retailer | Domain | |----------|--------| | Nitecore | nitecore.co.il |
Aggregator
| Retailer | Domain | |----------|--------| | Zap | zap.co.il |
Tools
| Tool | Description |
|------|-------------|
| list_retailers | List supported retailers, optionally filtered by tier |
| search_product | Search for a product across retailers (auto-translates to Hebrew) |
| find_rrp | Look up international RRP/MSRP for a product |
| check_price_vs_rrp | Compare Israeli price vs international RRP with markup analysis |
| convert_currency | Convert between USD and ILS |
| find_options | Broad product search with text recommendations |
| scrape_product_page | Scrape a specific product URL for price details |
| generate_report | Full pipeline: search → compare → PDF report with recommendations |
Prerequisites
- Node.js 20+
- Typst (for PDF report generation) — install
- Chromium (installed automatically via Playwright)
Installation
npx israeli-tech-shopping-mcpOr install globally:
npm install -g israeli-tech-shopping-mcpMCP Configuration
Add to your Claude Code settings (~/.claude/settings.json):
{
"mcpServers": {
"israeli-tech-shopping": {
"type": "stdio",
"command": "npx",
"args": ["-y", "israeli-tech-shopping-mcp"]
}
}
}Important Notes
- Runs on your machine: Browser automation uses your local IP and network. This is intentional — Israeli retailers may geo-restrict or show different prices to non-Israeli IPs.
- Eilat pricing: KSP and some retailers show a lower "Eilat price" (no VAT). This MCP always uses the regular (higher) price that applies to most of Israel.
- VAT: Israeli VAT is 18%. The MCP detects when prices exclude VAT and adds it automatically.
- Domain whitelist: The browser will only navigate to the approved retailer domains listed above.
License
MIT
