BuyWhere 商品搜索 MCP

这个 Agent 能做什么，适合哪些场景？

BuyWhere MCP Server 把 BuyWhere 的商品目录与实时价格能力暴露给兼容 Model Context Protocol 的客户端。它以 Node.js 命令行进程运行，通过 stdio 接入 Claude Desktop、Cursor、VS Code、Cline、Windsurf、OpenCode、Codex 和 Continue.dev，也提供位于 `https://api.buywhere.ai/mcp` 的远程 JSON-RPC 2.0 端点。代理可以搜索超过 3 亿件商品，获取商品详情，比较 2–10 件商品，查找最低可配送价格、降价商品及相似商品，并提交商品 URL 供目录收录。覆盖范围包括新加坡、美国、马来西亚、泰国和越南，数据来自 Lazada、Shopee、Amazon 与当地零售商。它适合构建购物研究和跨境比价代理，但不提供店铺管理或 Shopify 集成，实际查询依赖 BuyWhere 托管 API、网络连接和 API 密钥。

用户的 MCP 客户端通过 stdio 启动 @buywhere/mcp-server，或通过带 Bearer 凭据的 HTTP 请求连接远程 MCP 端点。服务器接收结构化调用，并把它们转发给 api.buywhere.ai 的商品目录。search_products 按关键词、分类、价格和国家搜索；get_product 返回价格、规格和图片；compare_products 对 2–10 件商品进行并列比较；find_best_price 查找跨商户的最低可配送报价；get_deals 返回明显降价的商品；list_categories 提供分类体系；find_similar 使用向量相似度查找相似商品；ingest_products 接收待收录的商品 URL。对应的 v2 搜索、详情、比较、优惠和最低价工具增加了 deliver_to 配送国家参数。最终输出是供代理继续组织、筛选或推荐的结构化商品、价格、商户和配送信息。

1. 购物助手开发者需要为新加坡用户查找指定预算内的耳机，并返回可购买的候选商品。
2. 跨境消费者希望比较同一商品在美国、新加坡及东南亚市场的价格与商户。
3. 研究型代理需要先搜索商品，再用 compare_products 对 2–10 个候选项进行并列分析。
4. 自动化团队希望定期调用 get_deals 或 find_best_price，把降价结果交给其他工作流处理。
5. 电商数据提供方或商户希望通过 ingest_products 提交商品 URL，供 BuyWhere 目录收录。
6. 多代理系统需要通过 A2A Agent Card 委派购物搜索和比价任务。

如何安装或部署这个 Agent？

需要 Node.js 18 或更高版本。先注册一个无需邮箱验证的免费密钥：

curl -X POST https://api.buywhere.ai/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"your-agent"}'

响应会立即包含 api_key、层级和速率限制。然后设置密钥并直接运行 MCP 服务器：

export BUYWHERE_API_KEY=bw_...
npx -y @buywhere/mcp-server

也可以全局安装：

npm install -g @buywhere/mcp-server
buywhere-mcp

若从源码开发，可执行：

git clone https://github.com/BuyWhere/buywhere-mcp.git
cd buywhere-mcp
npm install
npm run build
npm start

如何使用这个 Agent？

在 Codex、OpenCode 或其他采用相同 MCP 配置结构的客户端中加入：

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
    }
  }
}

重启或重新加载客户端后，可发出“查找新加坡售价低于 50 美元的无线耳机”之类的请求；客户端会调用 search_products，随后可用 compare_products 比较候选项。需要远程接入时，向以下端点发送 JSON-RPC 2.0 请求，并在 Authorization 请求头中提供 Bearer 密钥：

POST https://api.buywhere.ai/mcp
Authorization: Bearer bw_...

服务端点声明使用 MCP protocolVersion 2024-11-05。可用 BUYWHERE_API_URL 覆盖默认 API 地址。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题