BestPrice

BestPrice MCP

适用于 BestPrice.gr 的官方 Model Context Protocol 服务。BestPrice.gr 是希腊的价格比较服务。它为 AI 助手提供只读访问权限，可用于购物决策、实时商品搜索、报价比较和价格历史查询。无需账号或 API 密钥。

开始购物

• 在 ChatGPT 中打开 BestPrice，并添加已发布的插件。
• 使用预填的连接器表单将 BestPrice 连接到 Claude。
• 查看购物指南，了解示例和其他助手。

对于开发者集成，公共端点为：

https://mcp.bestprice.gr/mcp

• 传输方式：通过 HTTPS 使用 Streamable HTTP；匿名购物，Events 可选用 OAuth
• 官方 Registry ID：gr.bestprice/mcp
• 服务版本：1.8.4
• 公共指南：https://www.bestprice.gr/mcp
• 支持：https://www.bestprice.gr/contact

此仓库包含托管服务之外的所有内容：适用于各 AI 客户端的安装清单、不支持 HTTP 的宿主所用的本地 stdio 桥接，以及原生浏览器 WebMCP 层。服务本身不在此仓库中。

当前发布矩阵记录了在线网关、UI、OAuth/Events、插件审核以及独立的 ACP 资格认证。

工具

工具	功能	关键参数
get_shopping_decision	运行 BestPrice Shopping Brain：提供有依据的推荐、按需求进行比较，或提供只读购物篮方案，并说明理由、权衡和未知信息。	message（用希腊语或英语描述需求，包括预算），可选的 postal_code（完成购物篮方案时必填），可选的 evidence_detail（summary，默认值：仅提供答案引用的依据；full：提供每项声明及其来源）
search_products	在目录中查找标准商品。返回商品 ID 及不含运费的目录最低价。	query（2–200 个字符：名称、型号、类别或纯 GTIN/EAN 条形码），可选的 price_min、price_max、required_features、sort（relevance、price_asc、price_desc）、limit（1–8）
compare_offers	比较某个特定商品当前的商家报价，分别列出商品价格、运费和送达总价。	来自先前结果的 product_id，可选的 postal_code（希腊邮政编码，10000–85999，用于计算送达总价）、objective、in_stock_only、minimum_merchant_rating、limit（1–10）
get_price_history	总结商品价格随时间的变化，并与其 180 天中位价进行比较。	product_id，可选的 period_days（30、90 或 180）

这四种工具均为只读。它们不会下单、创建提醒或读取账号数据。结果链接到 BestPrice 商品页面，不会直接链接到商家。未知运费会标记为未知，而不会显示为免费。搜索范围涵盖安全的实体商品；不包含数字商品、服务和年龄限制类目。

协议详情

根据 2026 年 9 月 24 日对在线端点的测量结果。

• 版本。 initialize 会协商 2025-11-25、2025-06-18、2025-03-26、2024-11-05 和 2024-10-07；客户端请求其他任何版本时，都会收到 2025-11-25 作为响应。 也支持 2026-07-28 按请求指定的修订版本：发送 MCP-Protocol-Version、 Mcp-Method（对于 tools/call，还要发送 Mcp-Name）标头，并在 每个请求的 _meta 中放入 io.modelcontextprotocol/protocolVersion 和 io.modelcontextprotocol/clientCapabilities。如果请求指定了该修订版本，却未包含此封装， 则会以 -32602 拒绝。
• 无状态。 不会签发 MCP-Session-Id，也不需要该标头；DELETE 会返回 405。 带有 Accept: text/event-stream 的 GET 请求会开启保持活动状态的流，但服务从不通过该流发送请求或通知，因此客户端不打开该流也不会有任何损失。
• 能力。 兼容的客户端可使用 tools 和 resources。资源范围包括可选的 MCP Apps UI ui://bestprice/shopping-results-v1.html、服务卡片 mcp://server-card.json，以及规范的 skill://bestprice-shopping/SKILL.md。在 MCP 2026-07-28 中，服务还会声明最终版 io.modelcontextprotocol/skills 扩展：skills/list 和 skills/get 会返回唯一的 BestPrice Shopping Skill 及其 SHA-256 摘要和字节大小，而 resources/read 会返回完全一致的 Markdown 字节内容。较旧的客户端只会将该 Skill 视为普通资源。 不支持提示词、补全或日志记录；调用这些方法会返回 -32601。
• 响应。 同时接受 application/json 和 text/event-stream 的客户端会收到包含一个事件的 SSE 响应。使用 Accept: application/json、*/* 或未设置 Accept 标头的请求会收到单个 JSON 正文。每个工具都会返回可通过其 outputSchema 验证的 structuredContent，并以文本形式返回相同结果，供不会将结构化内容传递给模型的客户端使用。
• 错误。 未知工具会导致 JSON-RPC 错误（-32602）。无效参数和服务故障（例如产品不存在）会作为带有 isError: true 的工具结果返回，方便模型读取并修正。
• 限制。 JSON 请求正文最大为 256 KiB（超过时返回 413）；请求截止时间为 12 秒；每个客户端均受速率限制，超限时会返回 HTTP 429、JSON-RPC 错误 -32029 和 Retry-After 标头。JSON-RPC 批量数组请求会被拒绝，并返回 400。
• 浏览器。 桌面、CLI 和服务端客户端不会发送 Origin 标头，因此不受影响。浏览器页面可从列入允许列表的 AI 托管方源、bestprice.gr 或 localhost 调用该端点（因此 MCP Inspector 可在直连模式下工作）；其他任何源都会收到 403。
• 身份验证。 四个购物工具无需账户即可使用。可选的账户关联仅限于 events:subscribe；受保护资源的元数据可在 /.well-known/oauth-protected-resource 和 /mcp/oauth-protected-resource 获取。 端到端资格认证期间，Events 仍处于禁用状态。

开发者快速入门

以下每个客户端都会连接到同一端点。详细的提供商专属说明（包括 OpenAI、Grok、GitHub Copilot 和 Microsoft Copilot Studio）请参阅 docs/provider-setup.md。

Claude

将 BestPrice 连接到 Claude 会打开自定义连接器流程，并预填端点。对于 Claude Code：

claude mcp add --transport http bestprice-shopping https://mcp.bestprice.gr/mcp

附带的 .mcp.json 是等效的项目级配置。

Cursor

将 BestPrice 添加到 Cursor 会在添加之前显示解码后的配置。.cursor-plugin/ 目录中包含市场插件和一个 Agent 技能。

VS Code

将 BestPrice 添加到 VS Code

Gemini CLI 和 Qwen Code

gemini extensions install https://github.com/TheBestCo/bestprice-mcp
qwen extensions install https://github.com/TheBestCo/bestprice-mcp --consent

这两个扩展都只导入上述四个工具。

Codex、Claude 插件和 Agent Skill 宿主

根目录下的 plugin.json、mcp.json 和 skills/bestprice-shopping/SKILL.md 共同构成可移植的 Agent 插件包：MCP 提供实时购物数据，Skill 则指导宿主何时以及如何处理非品牌特定的希腊语购物需求。 可在仓库本地 .agents/skills/ 下发现 Skill 的兼容 Agent 宿主，可通过 .agents/skills/bestprice-shopping/SKILL.md 使用相同的标准工作流。 .codex-plugin/ 仍是 Codex 兼容性清单。 .claude-plugin/plugin.json 加上 相同的根目录 Skill 和 .mcp.json，也使此仓库成为 Claude 插件包。

可自托管的插件市场

同一仓库可直接添加为插件市场，无需复制工具或 Skill 逻辑：

copilot plugin marketplace add TheBestCo/bestprice-mcp
copilot plugin install bestprice-shopping@bestprice

claude plugin marketplace add TheBestCo/bestprice-mcp
claude plugin install bestprice-shopping@bestprice

Copilot 会读取 .github/plugin/marketplace.json，并根据 Agent Plugins 1.0 加载标准的根目录 plugin.json、mcp.json 和 skills/bestprice-shopping/SKILL.md。Claude 会读取 .claude-plugin/marketplace.json，并使用 .claude-plugin/plugin.json、.mcp.json 和相同的根目录 Skill。

Gemini API、DeepSeek、Z.ai

可运行示例位于 examples/ 中：Gemini Interactions API 和 Genkit、 DeepSeek Harness 插件条目，以及 Z.ai GLM 调用。每个示例都需要相应提供商自己的 API 密钥。 BestPrice 无需密钥。

其他 MCP 客户端

添加一个 Streamable HTTP 服务：https://mcp.bestprice.gr/mcp。如果宿主仅支持 stdio 服务，请使用此仓库中的桥接程序：

git clone https://github.com/TheBestCo/bestprice-mcp.git && cd bestprice-mcp
npm ci
node stdio.mjs

桥接程序会将所有请求转发到公共端点，并接受两个环境变量：BESTPRICE_MCP_URL（默认值：公共端点）和 BESTPRICE_MCP_TIMEOUT_MS（默认值：60000）。Dockerfile 会为 Glama 等类似宿主构建相同的桥接程序。

安全地开始对话

1. 询问购买建议：Θέλω κινητό έως 500 ευρώ με NFC και 5G υποχρεωτικά. （我想买一部 500 欧元以内、必须支持 NFC 和 5G 的手机。）
2. 或者搜索：Find Sony WH-1000XM5 under 300 euros.
3. 将返回的 product_id 和邮政编码 10558 传递给 compare_offers。
4. 将相同的 product_id 传递给 get_price_history，查询 180 天的价格历史。

查询支持希腊语或英语。结果摘要、目录数据和商家名称均以希腊语返回。

搜索	比较报价	价格历史

浏览器原生 WebMCP

BestPrice 页面会在兼容的浏览器中注册 22 个上下文感知型 WebMCP 工具（契约 2.8）——每个工具只负责读取或执行操作，不会同时做两者——涵盖带结构化结果的搜索（可按价格、库存、优惠和排序缩小范围），以及在标签页中打开搜索返回的结果页面；购物者的购物清单和比价（可在所有页面读取，在商品页面添加和移除）；降价提醒对话框；可见商品和加载更多商品；筛选和排序；按 ID 打开任意商品（在标签页切换前读取）；商品信息、优惠、规格和价格历史（含图表）；一个可见优惠的操作；以及 BestPrice Shopping Brain——涵盖所有公开页面，包括文章和商店——同时由购物者选择商家。每个工具都会公布输入和输出架构。契约、故障时关闭的运行时、确定性评估器和包含 47 个案例的自然语言数据集位于 webmcp/。

发现

• 官方 MCP 注册表
• 开放式 Agent 发现：ard.json、 ai-catalog.json、 服务卡片，以及 不依赖特定提供商的 BestPrice Shopping 技能。 ARD 示例刻意采用无品牌标识的购物者意图，让发现机制能在用户了解 BestPrice 之前， 就匹配“我该买什么？”、含运费价格和购买时机相关请求。
• webmcp.json 描述了 BestPrice 页面提供的上下文感知型 浏览器工具。
• 此仓库以 bestprice-shopping 的名称列入 Gemini CLI 扩展库 （Google 会抓取带标签的公开扩展仓库）；GitHub Agent Finder 也可以导入公开 MCP 目录和 ARD 资源。
• 可直接复制并固定 CI 版本的外部目录贡献内容位于 distribution/： GitHub Agent Finder Skill 条目和 Docker MCP Registry 远程服务条目。这些目录 需要各自在其仓库中进行审核；仓库中检入的文件是提交内容，并不表示 外部条目已上线。
• 社区索引：Glama、 WebMCP 注册表、 webmcp.com、 cursor.directory

开发

npm ci
npm run check   # Biome lint and format
npm test        # node --test: bridge, WebMCP, manifests, dataset

测试无需联网：桥接层会通过进程内的模拟远程服务进行测试。需要 Node 20 或更高版本；.nvmrc 固定为 22。

版本管理

此仓库中会有意出现两个版本：

• package.json 和每个插件或扩展清单中的软件包版本。当此仓库的清单、桥接层或 WebMCP 层发生变化时，版本会更新，并标记为 vX.Y.Z。
• server.json 和本 README 顶部附近一行中的服务版本。这是托管服务报告并发布到官方 MCP 注册表的版本。

CHANGELOG.md 跟踪软件包版本。

带时间戳的托管服务检查记录在单独的位置。9 月 7 日 Shopping Brain v12 验证 包含确切的网关修订版、已清理的金丝雀测试结果和范围限制。

安全

请按照 SECURITY.md 中的说明私下报告漏洞。

贡献

请参阅 CONTRIBUTING.md。欢迎提交问题和拉取请求。

许可证

Apache License 2.0。版权所有 The Best Company S.A. 请参阅 LICENSE。

隐私：https://www.bestprice.gr/policies/privacy · 条款：https://www.bestprice.gr/policies/terms