BuyWhere 商品搜索 MCP
让 AI 代理跨多个市场搜索商品、比较价格并发现优惠。
- Star 数
- ★ 14
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 55/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 购物助手开发者需要为新加坡用户查找指定预算内的耳机,并返回可购买的候选商品。
- 不适合
- 需要完全离线搜索商品的团队
- 需要店铺或 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 配送国家参数。最终输出是供代理继续组织、筛选或推荐的结构化商品、价格、商户和配送信息。
- 购物助手开发者需要为新加坡用户查找指定预算内的耳机,并返回可购买的候选商品。
- 跨境消费者希望比较同一商品在美国、新加坡及东南亚市场的价格与商户。
- 研究型代理需要先搜索商品,再用
compare_products对 2–10 个候选项进行并列分析。 - 自动化团队希望定期调用
get_deals或find_best_price,把降价结果交给其他工作流处理。 - 电商数据提供方或商户希望通过
ingest_products提交商品 URL,供 BuyWhere 目录收录。 - 多代理系统需要通过 A2A Agent Card 委派购物搜索和比价任务。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npx -y @buywhere/mcp-servernpm install -g @buywhere/mcp-server
- 环境变量
BUYWHERE_API_KEYBUYWHERE_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?
查看各维度的扣分理由
源码显示该包仅转发 MCP 请求,API key 通过环境变量作为 bearer 和 x-api-key 发送到可配置上游;README 和安全政策提示密钥管理,因此最小权限、数据流与密钥处理有基本说明。扣分原因:工具调用不要求用户确认,配置可将密钥发送到任意上游,且 ingest_products 会提交 URL;没有撤销或恢复机制说明,依赖安全也未提供审计证据。仓库和 LICENSE 将项目归于 BuyWhere,但发布者身份未验证,维护联系仅部分明确。
源码有超时、网络错误、HTTP 状态及解析错误处理,CI 配置覆盖 Node 18/20/22 的构建。扣分原因:README、Smithery 清单和源码对工具数量、版本合同、API key 注册选项及 v2 状态存在不一致;产品依赖远程 API,未见可用性或降级保证。清晰的错误处理支持普通排障,但不覆盖所有非成功响应和解析情形。
README 明确面向 MCP 客户端、购物代理、价格比较和跨境场景,并给出多框架配置与示例。扣分原因:能力主要是商品检索与比较,且关键数据和工具契约由托管服务决定;文档对市场覆盖和交付国家要求有不一致,因此触发条件与运行环境说明虽有用但不完全稳定。
README 有快速安装、客户端配置、教程、工具表、示例和支持渠道,包元数据及 LICENSE 标明 MIT。扣分原因:README、smithery.yaml、package.json 和 SECURITY.md 在版本、工具面与支持版本上不一致;没有随附清晰的变更日志或已知限制清单。维护邮箱和 issue 入口存在,但维护责任和支持承诺有限。
工具覆盖搜索、详情、比较、最低价、优惠和类目查询,适合返回结构化购物信息;远程 API 转发减少本地实现负担。扣分原因:工具结果质量、价格新鲜度和市场覆盖主要依赖外部服务,仓库没有足够证据量化效益或成本;注册与调用额度信息在文件间不完全一致。
核心转发行为、超时、请求头和工具缓存可从源码追踪,安装与配置声明也有 package.json、CI 和安全政策等材料部分对应。扣分原因:目录样本中没有独立证据验证目录规模、实时性、市场覆盖、服务额度或工具总数;文档自身对这些声明及 v2 发布状态互相矛盾,事实与营销性主张未始终清楚区分。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 使用前应核对托管服务的实际工具与 API 契约;仓库材料对工具数量、v2 可用状态、市场覆盖和额度有冲突。
- API key 会发送到配置的上游;确认 BUYWHERE_MCP_URL 或 BUYWHERE_API_URL 指向预期服务,并避免在客户端配置或版本库中泄露密钥。
- 目录规模、实时定价、可用性及注册承诺在此静态材料中未被独立验证。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
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 查看 ↗ -
v0.3.17 v0.3.17 — Scorecard tools + description fix
发布说明摘录
Scorecard improvement + MCP Registry description fix (<100 chars). NPM publish required.在 GitHub 查看 ↗ -
v0.3.16 v0.3.16 — Point MCP Registry to NPM 0.3.11
常见问题
使用它需要付费或注册邮箱吗?
POST /v1/auth/register 免费取得密钥,无需邮箱。示例未验证层级限制为每分钟 20 次、每天 1,000 次;来源没有列出付费方案或更高层级价格。商品查询会完全在本地执行吗?
api.buywhere.ai,因此需要网络连接并会把查询发送到 BuyWhere API。它能管理我的网店或 Shopify 吗?
支持哪些市场和配送筛选?
deliver_to ISO 国家代码,v2 比较工具可选该参数。可以不安装本地 npm 包吗?
POST https://api.buywhere.ai/mcp 的远程 MCP 端点,使用 JSON-RPC 2.0 和 Bearer API 密钥。BuyWhere 商品搜索 MCP 官网是什么?
BuyWhere 商品搜索 MCP 开源吗?
BuyWhere 商品搜索 MCP 安全吗?
BuyWhere 商品搜索 MCP 还在维护吗?
BuyWhere 商品搜索 MCP 是谁开发的?
谢谢反馈,我们会据此改进页面。