BuyWhere 商品搜索 MCP

让 AI 代理跨多个市场搜索商品、比较价格并发现优惠。

Star 数
★ 14
最近更新
1 个月前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
MCP 服务器命令行工具云服务 / SaaS
可在哪里用
通用 · 跨平台Codex
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Node.js >=18BUYWHERE_API_KEY兼容 MCP 的客户端Shell / 命令行网络访问本地文件系统MCP Server
典型场景
购物助手开发者需要为新加坡用户查找指定预算内的耳机,并返回可购买的候选商品。
不适合
  • 需要完全离线搜索商品的团队
  • 需要店铺或 Shopify 管理功能的商家
  • 无法向 BuyWhere API 发送查询的环境
官网
buywhere.ai ↗ 来自 GitHub 仓库设置
维护状态
近半年有提交最近提交 2026-09-28最新版本 v0.4.0(2026-08-30)

这个 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 委派购物搜索和比价任务。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npx -y @buywhere/mcp-server
  • npm install -g @buywhere/mcp-server
环境变量
BUYWHERE_API_KEY BUYWHERE_API_URL
运行环境
Node.js 18

如何安装或部署这个 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 有哪些优点和局限?

优点
  • 一个 MCP 接口覆盖新加坡、美国、马来西亚、泰国和越南,并聚合 Lazada、Shopee、Amazon 与当地零售商。
  • 工具覆盖从搜索、详情和多商品比较,到最低价、优惠、相似商品及 URL 收录的完整研究流程。
  • 可通过一次 POST 自助注册免费密钥,无需邮箱;示例响应明确给出未验证层级的 20 RPM 和每日 1,000 次限制。
  • 同时提供本地 stdio 包和远程 MCP 端点,并记录了多个 MCP 客户端及代理框架的接入方式。
  • 采用 MIT 许可证,并明确支持 MCP 与 A2A 两种代理协议。
局限
  • 商品查询依赖 BuyWhere 托管 API;没有文档证明商品目录或搜索后端可以自行托管或离线运行。
  • 必须管理 BUYWHERE_API_KEY,未验证免费密钥示例带有 20 RPM 和每日 1,000 次的速率限制。
  • 覆盖范围只明确列出新加坡、美国、马来西亚、泰国和越南,不适合需要其他国家完整商品目录的项目。
  • 文档对工具数量存在冲突:远程 MCP 部分称有 13 个工具,而协议表称 stdio 提供 10 个工具。
  • “实时”价格与库存由上游商户数据和 BuyWhere 服务提供,来源材料未说明刷新频率、可用性保证或故障处理承诺。

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

与 tavily-mcp 的定位不同:Tavily 用于查找评论和产品研究资料,BuyWhere 用于取得当前商品价格和购买链接。@modelcontextprotocol/server-filesystem、@supabase/mcp-server-supabase、n8n-mcp 和 @playwright/mcp 被描述为互补组件,分别承担结果保存、偏好与提醒持久化、价格监控工作流和浏览器端测试,而不是 BuyWhere 商品搜索能力的直接替代品。

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

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
BuyWhere 商品搜索 MCP 当前 55 · 缺口较多 MCP 服务器免费 ★ 14 1 个月前 TypeScript Codex
tRPC-Agent-Go 56 · 缺口较多 代码库 / SDK免费 + 模型费 ★ 1.9k 1 天前 Go OpenAI API
Fetch.ai 智能体示例库 44 · 缺口较多 命令行工具免费 + 模型费 ★ 1.5k 1 天前 Python OpenAI API · Claude API
MCP Memory Service 68 · 存在缺口 MCP 服务器免费 ★ 2.1k 1 天前 Python ChatGPT · Codex · Claude Code · Claude.ai

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
55/ 100 五分制 2.8 / 5
信任安全 13/29
可靠稳定 6/14
适用触发 14/18
规范维护 12/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全13 / 29 · 2.2/5

源码显示该包仅转发 MCP 请求,API key 通过环境变量作为 bearer 和 x-api-key 发送到可配置上游;README 和安全政策提示密钥管理,因此最小权限、数据流与密钥处理有基本说明。扣分原因:工具调用不要求用户确认,配置可将密钥发送到任意上游,且 ingest_products 会提交 URL;没有撤销或恢复机制说明,依赖安全也未提供审计证据。仓库和 LICENSE 将项目归于 BuyWhere,但发布者身份未验证,维护联系仅部分明确。

可靠稳定6 / 14 · 2.1/5

源码有超时、网络错误、HTTP 状态及解析错误处理,CI 配置覆盖 Node 18/20/22 的构建。扣分原因:README、Smithery 清单和源码对工具数量、版本合同、API key 注册选项及 v2 状态存在不一致;产品依赖远程 API,未见可用性或降级保证。清晰的错误处理支持普通排障,但不覆盖所有非成功响应和解析情形。

适用触发14 / 18 · 3.9/5

README 明确面向 MCP 客户端、购物代理、价格比较和跨境场景,并给出多框架配置与示例。扣分原因:能力主要是商品检索与比较,且关键数据和工具契约由托管服务决定;文档对市场覆盖和交付国家要求有不一致,因此触发条件与运行环境说明虽有用但不完全稳定。

规范维护12 / 18 · 3.3/5

README 有快速安装、客户端配置、教程、工具表、示例和支持渠道,包元数据及 LICENSE 标明 MIT。扣分原因:README、smithery.yaml、package.json 和 SECURITY.md 在版本、工具面与支持版本上不一致;没有随附清晰的变更日志或已知限制清单。维护邮箱和 issue 入口存在,但维护责任和支持承诺有限。

有效结果7 / 13 · 2.7/5

工具覆盖搜索、详情、比较、最低价、优惠和类目查询,适合返回结构化购物信息;远程 API 转发减少本地实现负担。扣分原因:工具结果质量、价格新鲜度和市场覆盖主要依赖外部服务,仓库没有足够证据量化效益或成本;注册与调用额度信息在文件间不完全一致。

证据核验3 / 8 · 1.9/5

核心转发行为、超时、请求头和工具缓存可从源码追踪,安装与配置声明也有 package.json、CI 和安全政策等材料部分对应。扣分原因:目录样本中没有独立证据验证目录规模、实时性、市场覆盖、服务额度或工具总数;文档自身对这些声明及 v2 发布状态互相矛盾,事实与营销性主张未始终清楚区分。

风险与缓解建议
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 使用前应核对托管服务的实际工具与 API 契约;仓库材料对工具数量、v2 可用状态、市场覆盖和额度有冲突。
  • API key 会发送到配置的上游;确认 BUYWHERE_MCP_URL 或 BUYWHERE_API_URL 指向预期服务,并避免在客户端配置或版本库中泄露密钥。
  • 目录规模、实时定价、可用性及注册承诺在此静态材料中未被独立验证。
证据充分度:低 评估于 2026年11月8日 审查版本 eeb06674c9a2
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/buywhere-mcp.svg?lang=zh)](https://followagents.com/zh/agents/buywhere-mcp)
<a href="https://followagents.com/zh/agents/buywhere-mcp"><img src="https://followagents.com/badge/buywhere-mcp.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.4.0 v0.4.0 — stdio proxy to the hosted MCP server
    发布说明摘录
    The package no longer reimplements tools. tools/list and tools/call forward to https://api.buywhere.ai/mcp and return responses verbatim, so the stdio package and the hosted server expose the same contract by construction (13 tools, including the v2 family). Previously the package hardcoded 7 v1 tools and drifted from the hosted server — an agent comparing the two saw different products.
    在 GitHub 查看 ↗
  2. v0.3.17 v0.3.17 — Scorecard tools + description fix
    发布说明摘录
    Scorecard improvement + MCP Registry description fix (<100 chars). NPM publish required.
    在 GitHub 查看 ↗
  3. v0.3.16 v0.3.16 — Point MCP Registry to NPM 0.3.11
    发布说明摘录
    Fix: align server.json with actual published NPM version 0.3.11
    在 GitHub 查看 ↗

常见问题

使用它需要付费或注册邮箱吗?
来源说明可通过 POST /v1/auth/register 免费取得密钥,无需邮箱。示例未验证层级限制为每分钟 20 次、每天 1,000 次;来源没有列出付费方案或更高层级价格。
商品查询会完全在本地执行吗?
不会。本地 npm 包充当 MCP 服务器,但商品搜索和详情来自 api.buywhere.ai,因此需要网络连接并会把查询发送到 BuyWhere API。
它能管理我的网店或 Shopify 吗?
不能。项目明确定位为面向代理的商品搜索与比价接口,而非店铺管理或 Shopify 集成。
支持哪些市场和配送筛选?
明确覆盖新加坡、美国、马来西亚、泰国和越南。v2 搜索、优惠和最低价工具要求 deliver_to ISO 国家代码,v2 比较工具可选该参数。
可以不安装本地 npm 包吗?
可以。文档提供 POST https://api.buywhere.ai/mcp 的远程 MCP 端点,使用 JSON-RPC 2.0 和 Bearer API 密钥。
BuyWhere 商品搜索 MCP 官网是什么?
BuyWhere 商品搜索 MCP 的 GitHub 仓库填写的官网是 https://buywhere.ai。这个链接由仓库作者设置;源码在 GitHub(BuyWhere/buywhere-mcp)。
BuyWhere 商品搜索 MCP 开源吗?
开源。源码在 GitHub(BuyWhere/buywhere-mcp),许可证是 MIT。
BuyWhere 商品搜索 MCP 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 BuyWhere 商品搜索 MCP 的“信任与安全”打了 13/29 分。评审没有在源码和文档里找到这些安全措施:回滚或恢复路径。接入真实账号或数据前:运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
BuyWhere 商品搜索 MCP 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-09-28,在最近半年内,但不在最近 30 天内。最新版本是 v0.4.0(2026-08-30)。
BuyWhere 商品搜索 MCP 是谁开发的?
BuyWhere 商品搜索 MCP 由 GitHub 账号 BuyWhere 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念