Offers MCP

Offers MCP

每个报价，一次调用。

为 AI Agent、应用程序和用户提供深入的购物情报。输入商品（例如 Sony WH-1000XM6 black 这样的自由文本，或 GTIN/UPC/EAN 条形码），添加可选的美国邮政编码，一次调用即可并行扫描各商家，返回实时价格、实际总价、配送选项和信任度信息。结果可靠、私密、高效，帮助 Agent、应用程序和用户做出明智的购买决策。

可靠，值得信赖：

• 实时价格和实际到手总价（价格 + 运费，这才是真正重要的数字）
• 指定邮政编码的配送时间范围
• 商家信任评分（不付费排名），并过滤掉不可信的商品列表
• 商品匹配和每个报价的置信度评分，让你的 Agent 知道何时可以肯定作答、何时应该谨慎。如果我们无法确定，响应会如实说明，而不是猜测
• 计算得出的最佳可信报价和最快可信报价，以及完整的选项列表。最终决定权仍在用户手中
• **所有信息均可溯源：**每个报价都会标明来源和核验时间（checked_at、缓存状态）

**私密。无人监视用户购物：**不跟踪单个用户，不存储原始 IP；查询始终保密：绝不出售、分享或用于再营销（详情请见隐私）。

**高效。数秒内比价多家商店：**一次输入即可同时查询多个来源，并将结果规范化为一种结构化契约，方便你据此构建应用。重复查询会立即返回结果。可在商店过道中进行跨商家比价，也可在自己的应用程序中进行程序化查询。同一次工具调用，相同的结果。

v0 期间免费。无需注册。无需 API 密钥。没有任何承诺。

快速开始

托管服务通过以下地址提供可流式传输的 HTTP：

https://offers-engine.dexter-works.com/mcp

Claude Code

claude mcp add --transport http offers https://offers-engine.dexter-works.com/mcp

Claude Desktop / claude.ai（无需使用终端）

1. 打开设置 → 连接器（付费套餐）。
2. 点击添加自定义连接器。
3. 将其命名为 Offers，粘贴 URL https://offers-engine.dexter-works.com/mcp，然后保存。
4. 在新聊天中，确保在工具/连接器菜单中启用 Offers，然后直接提出购物问题。

ChatGPT

1. 设置 → 应用与连接器 → 高级设置 → 启用开发者模式（Plus/Pro/Team 套餐）。
2. 返回连接器，选择创建 / 添加自定义连接器。
3. 将其命名为 Offers，MCP 服务 URL 填写 https://offers-engine.dexter-works.com/mcp，身份验证选择：无。
4. 在聊天中，从工具菜单启用 Offers 连接器，然后提出问题。

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{ "mcpServers": { "offers": { "url": "https://offers-engine.dexter-works.com/mcp" } } }

VS Code（GitHub Copilot）

添加到 .vscode/mcp.json：

{ "servers": { "offers": { "type": "http", "url": "https://offers-engine.dexter-works.com/mcp" } } }

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{ "mcpServers": { "offers": { "serverUrl": "https://offers-engine.dexter-works.com/mcp" } } }

任何仅支持 stdio 的 MCP 客户端

使用 mcp-remote 作为桥接工具：

{
  "mcpServers": {
    "offers": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://offers-engine.dexter-works.com/mcp"]
    }
  }
}

客户端界面更新很快。如果上面的菜单路径已过时， 请提交 issue，我们会修正。

然后可以向助手提出类似这样的问题：

使用 Offers MCP，帮我看看我在 83702，花 $398 买 Sony WH-1000XM6 算不算划算。

工具名称很重要：助手有自己的网页搜索，在回答购物问题时通常会优先使用它。说“使用 Offers MCP”（或在聊天中只启用这个连接器），可以确保你的问题查询的是实时结构化报价，而不是搜索摘要。

REST API

同一引擎也可通过纯 HTTP 使用：

curl "https://offers-engine.dexter-works.com/api/search_offers?q=Sony%20WH-1000XM6%20black&zip=83702"

工具

工具	输入	输出
search_offers	query（文本或 GTIN）、zip（可选，5 位美国邮政编码）	规范化的报价 + 最佳/最快可信报价

更多工具（用于解析 GTIN/URL/图片并识别商品及其变体系列的 identify_product）已列入路线图。

响应结构（节选）

{
  "product": { "name": "Sony WH-1000XM6…", "brand": "Sony", "resolution_confidence": 0.9 },
  "offers": [
    {
      "merchant": { "name": "Best Buy", "trust": { "score": 95 } },
      "price": { "amount": 398.0, "list_price": 449.99, "discount_pct": 11.6 },
      "fulfillment": {
        "landed_cost": 398.0,
        "delivery": { "zip": "83702", "min_days": 2, "max_days": 2, "basis": "merchant_stated" }
      },
      "variant_match": { "confidence": 0.98 },
      "provenance": { "checked_at": "2026-08-11T19:42:03Z", "cache": "miss" }
    }
  ],
  "summary": {
    "best_offer_id": "dw:off_…",
    "recommendation": "Best Buy at $398.00 with free shipping is the best trusted deal."
  }
}

数据来源、限制与预期

• **数据来源（优质数据，而非抓取屏幕内容）：**我们通过官方商家和商品目录合作计划及结构化数据源开展工作，确保结果准确可靠，而非脆弱易失。目前的优惠来自 Google Shopping，商家直连集成（Best Buy、Walmart）正在陆续推出；GTIN 输入通过 Icecat 和 UPCitemdb 解析。每条响应都会在 meta.sources_queried 中准确列出查询过的数据源；如果数据源之间存在分歧或数据不足，响应也会如实说明。
• **延迟：**首次查询约需 5–15 秒（实时查询上游数据）；重复查询会命中短期缓存，在几毫秒内返回。请配置较宽裕的工具超时时间。
• **速率限制／合理使用：**v0 期间免费。每位访客每天约可进行 10 次全新查询（缓存查询不限次数且不计入）；超过限额的请求会收到如实的容量提示，容量每天重置（UTC）。如需大量或商业用途，请先联系我们。端点可能会调整；任何不兼容变更都会在此代码库中公告。
• **Agent 约定：**面向 Agent 的机器可读指南（说明如何解读置信度、新鲜度、可信度和联盟营销字段）位于 offers-engine.dexter-works.com/agents.md。
• 反馈工具：report_feedback(query, verdict, note?) 可直接从你的助手提交结果报告；每份报告都会被阅读。
• REST 和 MCP 返回相同的 JSON 结构（MCP 工具会将其封装为文本内容）。
• **直接通过 curl 请求 /mcp 时请注意：**根据 MCP 可流式传输的 HTTP 规范，响应采用 SSE 帧格式（event: message / data: {...}）；MCP 客户端会为你处理这些内容。

隐私

我们最初是为自己打造 Offers，也会像希望别人对待我们的搜索一样，妥善对待你的搜索。

• **我们能看到什么：**你搜索的商品、你选择提供的邮政编码，以及粗略的技术信息（连接的客户端类型、国家／地区）。我们不会跟踪个人，也不会建立个人购物档案；匿名使用完全无需账号。
• **我们不会保留什么：**绝不存储原始 IP 地址；独立使用量通过每日更换且无法反向还原的哈希值统计。
• **数据用途：**只有一项：改善结果（匹配准确度、商家覆盖范围、速度）。
• **我们绝不会做什么：**出售你的数据、与广告商或数据经纪商共享数据，或将查询用于再营销。绝不例外。
• **商家无法看到你在比较。**所有价格比较都在我们的服务器上进行；只有当购物者点击跳转到商家网站购买时，商家才会知道购物者的相关信息。部分外链可能会为我们带来联盟营销佣金，但你无需承担任何费用；佣金绝不会影响排名（由可信度评分和到手成本决定，并且该逻辑对所有商家一视同仁）。

有疑问或希望删除某些内容？请联系 [email protected]。

状态与支持

早期 v0：面向美国消费者的商品，诚实接入少量数据源。如果某个字段无法确认可信度，就返回 null，而不是猜测。

发现错误结果、错误价格或程序错误？请提交 GitHub issue。目前，附上确切查询内容的错误匹配报告尤其有帮助。

由 Dexter Works 打造。