---

name: buywhere-product-catalog description: "使用 BuyWhere 的 MCP 和 API 接口为 AI 购物代理添加产品搜索、价格比较和优惠发现功能。" category: ecommerce risk: safe source: official source_repo: BuyWhere/buywhere-mcp source_type: official license: "Not declared" license_source: "https://github.com/BuyWhere/buywhere-mcp" date_added: "2026-04-29" author: BuyWhere tags: [buywhere, ecommerce, shopping, mcp, api, product-catalog] tools: [claude, cursor, codex, gemini]

BuyWhere 产品目录

概述

BuyWhere 为 AI 代理提供产品目录接口，用于购物流程、价格比较和优惠发现。当你想让代理通过 BuyWhere 的 MCP 设置路径或 API 接入流程连接产品搜索或商家感知的商务操作时，使用此技能。

最安全的公开起点是实时开发者门户、API 密钥注册流程、MCP 指南和官方 Cursor 插件仓库。

何时使用此技能

• 当你想为 AI 购物或推荐代理添加结构化产品搜索时使用。
• 当用户要求在 Cursor、Claude Desktop 或自定义代理运行时中设置 BuyWhere MCP 时使用。
• 当你需要 BuyWhere API 密钥、MCP 配置或插件发现的具体接入路径时使用。

工作原理

步骤 1：选择集成接口

从匹配用户设置的公开 BuyWhere 入口点开始：

• 开发者门户：https://buywhere.ai/developers/
• API 密钥注册：https://buywhere.ai/api-keys/
• MCP 集成指南：https://api.buywhere.ai/docs/guides/mcp
• Cursor 插件仓库：https://github.com/BuyWhere/buywhere-cursor-plugin

步骤 2：确认用户的运行时环境

在给出设置说明之前，询问用户正在集成的宿主环境：

• Cursor 或其他支持 MCP 的编码助手
• Claude Desktop
• 自定义 MCP 客户端
• 直接 REST API 集成

不要假设相同的配置文件或启动命令适用于所有宿主。

步骤 3：引导首次成功连接

优先选择最小化的首次运行路径：

1. 获取 BuyWhere API 密钥。
2. 按照宿主运行时的 MCP 或插件设置路径操作。
3. 在扩展到比较或优惠工作流之前，先运行一个简单的产品搜索请求。

步骤 4：扩展到商务工作流

首次查询成功后，帮助用户进入下一层：

• 产品搜索和发现
• 跨商家价格比较
• 优惠发现流程
• 将用户路由到商家目的地的购物代理编排

示例

示例 1：Cursor 插件发现

Use BuyWhere Product Catalog to help me connect BuyWhere inside Cursor and verify one product-search query.

示例 2：MCP 接入

Use BuyWhere Product Catalog to set up BuyWhere MCP for my shopping agent and keep the first test minimal.

最佳实践

• 在给出配置详情之前，先从实时开发者门户或 API 密钥流程开始。
• 将首次集成验证保持在一次成功查询。
• 询问用户正在使用哪个 MCP 宿主或 API 运行时。
• 除非有当前运行时证据，否则不要声称特定的产品数量或零售商数量。
• 当存在可用的公开页面时，不要将用户引导到已弃用或损坏的文档页面。

限制

• 此技能不能替代目标 MCP 宿主或 API 客户端内的环境特定验证。
• 公开的 BuyWhere 页面可能会变化，因此在精确设置细节重要时重新检查实时 URL。

安全与安全注意事项

• 将 API 密钥视为机密。在示例中使用占位符，永远不要将实时凭据粘贴到聊天、文档或截图中。
• 在建议文件系统路径、启动命令或本地配置编辑之前，确认用户的目标宿主。

常见陷阱

• 问题： 用户想要 BuyWhere 设置帮助但尚未创建 API 密钥。 解决方案： 从 https://buywhere.ai/api-keys/ 开始，只有在该步骤完成后才进入配置。

• 问题： 文档主机名不可用。 解决方案： 优先使用实时开发者门户、API 密钥流程、api.buywhere.ai 上的 MCP 指南和官方 GitHub 插件仓库。

相关技能

• @api-design-principles - 当用户需要围绕商务集成的 API 形状指导时使用。
• @mcp-builder - 当用户正在构建或扩展 MCP 服务器而非消费时使用。