buywhere-mcp

buywhere-mcp

适用于 BuyWhere 商品目录的 MCP 服务。无需编写任何 HTTP 代码，即可让 Claude Desktop、Cursor、Windsurf 和其他兼容 MCP 的 Agent 搜索和获取商品信息。

设置

1. 获取 API 密钥

在 buywhere.ai/developers 注册并复制 API 密钥。

2. 配置客户端

Claude Desktop

打开 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），并添加：

{
  "mcpServers": {
    "buywhere": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "BUYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

打开 Settings → MCP 并添加新服务，或编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "buywhere": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "BUYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "buywhere": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "BUYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. 让 Agent 搜索商品

重启客户端，然后尝试：

“在 BuyWhere 中搜索新加坡售价低于 $50 的无线耳机”

“使用 BuyWhere 比较最便宜的 iPhone 15 手机壳”

“获取 BuyWhere 中商品 ID 为 abc123 的联盟链接”

---

工具

search_products

使用关键词或自然语言搜索 BuyWhere 商品目录。

参数	类型	必填	说明
query	string	是	关键词或自然语言查询
country	string	否	国家代码提示（sg、my、id）
category	string	否	类别 slug（例如 electronics/smartphones）
limit	integer	否	最多返回结果数，1–50（默认值为 10）

get_product

获取单个商品的完整详情。

参数	类型	必填	说明
product_id	string	是	BuyWhere 商品 ID

get_price

比较某件商品在所有可用商家处的当前价格。返回按总价（含运费）排序的商品列表，以及最佳价格和最佳性价比推荐。

参数	类型	必填	说明
product_id	string	是	BuyWhere 商品 ID

compare_prices

并排比较 2–5 件商品。返回结构化的差异点、价格区间、优缺点和最佳性价比推荐，专为 AI Agent 决策而设计。

参数	类型	必填	说明
product_ids	string[]	是	包含 2–5 个 BuyWhere 商品 ID 的数组

get_affiliate_link

获取商品的 BuyWhere 点击追踪联盟链接。与用户分享链接时，务必使用此链接，而非原始商品 URL；它会记录引荐信息并重定向至商家页面。

参数	类型	必填	说明
product_id	string	是	BuyWhere 商品 ID

get_catalog

列出可用的商品类别。搜索或筛选前，可使用此工具查看有哪些类别。

参数	类型	必填	说明
parent_slug	string	否	子类别的父级 slug（省略则返回顶级类别）

资源

URI	说明
buywhere://catalog/sg	新加坡的可用类别
buywhere://catalog/my	马来西亚的可用类别
buywhere://catalog/id	印度尼西亚的可用类别

环境变量

变量	必填	说明
BUYWHERE_API_KEY	是	你的 BuyWhere API 密钥
BUYWHERE_API_URL	否	覆盖 API 基础 URL（默认值：https://api.buywhere.ai）

Agent 对话示例

User: Find the cheapest mechanical keyboard on BuyWhere and compare the top 2

Claude: I'll search BuyWhere for mechanical keyboards and compare the top results.

[Calls search_products with query="mechanical keyboard", limit=5]

Found 12 products. Top results:
1. Keychron K2 — SGD 89.00 (prod_abc123)
2. Royal Kludge RK61 — SGD 65.00 (prod_def456)

[Calls compare_prices with product_ids=["prod_abc123", "prod_def456"]]

Comparison: Keychron K2 vs Royal Kludge RK61
Price range: SGD 65 – SGD 89
Key differences:
  • Keychron K2: full-size TKL layout, Mac-optimised keycaps
  • RK61: compact 60% layout, budget-friendly
Best value: Royal Kludge RK61 at SGD 65

[Calls get_affiliate_link with product_id="prod_def456"]

Here's your purchase link: https://api.buywhere.ai/r/prod_def456

开发

npm install
npm run build
BUYWHERE_API_KEY=your_key python mcp_server.py