salai-mcp

Salai MCP 上的以色列杂货购物和价格比较助手。当您需要通过 Salai 远程 MCP 端点进行产品搜索、自动完成、跨零售商价格比较、购物车管理、商店发现、零售商发现和补充产品推荐时使用。

# Salai MCP Skill

Use Salai's remote MCP server for Israeli grocery discovery, comparison, and cart workflows.

## Access requirements

- Salai MCP is currently in **beta**.
- Users must register to the beta program and be approved.
- Only approved beta users can generate an API key from Salai Profile and use MCP tools.
- Registration: go to `https://app.salai.co.il`, create an account (Sign up), and wait for beta approval.
- Beta access contact: `beta@salai.co.il`

## Connection

- Endpoint: `https://mcp.salai.co.il/mcp`
- Auth: send a user API key from Salai Profile using either:
  - `Authorization: Bearer <SALAI_API_KEY>`
  - `X-API-Key: <SALAI_API_KEY>`

Use the full `/mcp` endpoint directly for best client compatibility.

## Tools

- Discovery:
  - `get_stores`
  - `get_retailers`
- Search:
  - `autocomplete_products`
  - `search_products`
- Pricing and comparison:
  - `get_product_prices`
  - `compare_prices`
  - `cart_of_israel`
- Cart management:
  - `get_cart`
  - `get_my_cart`
  - `update_cart_items`
  - `add_cart_item`
  - `remove_cart_item`
  - `delete_cart`
- Recommendations:
  - `get_complementary_recommendations`

## Recommended workflow

1. Resolve products quickly with `autocomplete_products` (`method: text` first, then `semantic` if empty).
2. Use `search_products` for richer semantic results and recommendations.
3. Build/modify the active user cart with `get_my_cart`, `add_cart_item`, `update_cart_items`, and `remove_cart_item`.
4. Compare total cost across retailers with `compare_prices`.
5. Use `cart_of_israel` for one-shot comparison of the default Cart of Israel list.

## Store scope conventions

When filtering by store, prefer `retailerId + storeId`.

`subChainId` may be accepted by some tools for backward compatibility, but is deprecated for store identity.

## Error handling

- If access is denied, instruct the user to complete beta signup and wait for approval.
- If an auth error occurs, request a valid Salai API key and retry.
- If a product is not found in one store, continue comparison with available alternatives.
- For ambiguous product names, call `autocomplete_products` before cart mutations.

## Security

- Never log or expose API keys in output.
- Treat all API keys as secrets.

---

## 中文说明

# Salai MCP 技能

使用 Salai 的远程 MCP 服务器进行以色列杂货的发现、比价和购物车工作流。

## 访问要求

- Salai MCP 目前处于 **beta（测试）** 阶段。
- 用户必须注册测试计划并获得批准。
- 只有获批的测试用户才能从 Salai Profile 生成 API 密钥并使用 MCP 工具。
- 注册方式：前往 `https://app.salai.co.il`，创建账户（Sign up），并等待测试批准。
- 测试访问联系方式：`beta@salai.co.il`

## 连接

- 端点：`https://mcp.salai.co.il/mcp`
- 鉴权：使用来自 Salai Profile 的用户 API 密钥，通过以下任一方式发送：
  - `Authorization: Bearer <SALAI_API_KEY>`
  - `X-API-Key: <SALAI_API_KEY>`

直接使用完整的 `/mcp` 端点，以获得最佳的客户端兼容性。

## 工具

- 发现：
  - `get_stores`
  - `get_retailers`
- 搜索：
  - `autocomplete_products`
  - `search_products`
- 定价与比较：
  - `get_product_prices`
  - `compare_prices`
  - `cart_of_israel`
- 购物车管理：
  - `get_cart`
  - `get_my_cart`
  - `update_cart_items`
  - `add_cart_item`
  - `remove_cart_item`
  - `delete_cart`
- 推荐：
  - `get_complementary_recommendations`

## 推荐工作流

1. 使用 `autocomplete_products` 快速解析产品（先用 `method: text`，若为空再用 `semantic`）。
2. 使用 `search_products` 获取更丰富的语义结果和推荐。
3. 使用 `get_my_cart`、`add_cart_item`、`update_cart_items` 和 `remove_cart_item` 构建/修改当前用户购物车。
4. 使用 `compare_prices` 跨零售商比较总成本。
5. 使用 `cart_of_israel` 对默认的 Cart of Israel 清单进行一次性比较。

## 商店范围约定

按商店过滤时，优先使用 `retailerId + storeId`。

某些工具出于向后兼容可能仍接受 `subChainId`，但作为商店标识它已被弃用。

## 错误处理

- 如果访问被拒绝，引导用户完成测试注册并等待批准。
- 如果出现鉴权错误，请求一个有效的 Salai API 密钥并重试。
- 如果某个商店未找到某产品，使用可用的替代品继续比较。
- 对于含糊的产品名称，在改动购物车前先调用 `autocomplete_products`。

## 安全

- 切勿在输出中记录或暴露 API 密钥。
- 将所有 API 密钥视为机密。