splitbasket-prices

Name: splitbasket-prices
Author: voicearc

远程服务

splitbasket.shop商业与营销011 周前更新

代码仓库访问官网

关于 splitbasket-prices

splitbasket-prices 是面向开发者和 Agent 的 MCP 服务及数据 API，提供按地点查询的美国杂货缓存价格。它标明价格观测时间和覆盖范围，并在无匹配结果时明确返回未找到，也可请求实时查询。

主要功能

01搜索附近商品及价格
02查询指定商品价格
03按单位价格比较商家
04查看地点覆盖范围
05请求并查询实时检查
06查看价格观测时间

适用场景

01比较不同商家的杂货价格
02查询前确认地点覆盖情况
03按时效限制筛选价格记录
04请求零售商当前价格

MCP 相关

通过 Streamable HTTP 和 bearer 认证，在 https://api.splitbasket.shop/v1/mcp 向 MCP 客户端提供工具。工具涵盖商品搜索、缓存及比较价格、覆盖查询和实时检查任务。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://api.splitbasket.shop/v1/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http voicearc-splitbasket-prices https://api.splitbasket.shop/v1/mcp

Cursor.cursor/mcp.json{"mcpServers":{"voicearc-splitbasket-prices":{"type":"http","url":"https://api.splitbasket.shop/v1/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"voicearc-splitbasket-prices":{"type":"http","url":"https://api.splitbasket.shop/v1/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"voicearc-splitbasket-prices":{"type":"http","url":"https://api.splitbasket.shop/v1/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"voicearc-splitbasket-prices":{"serverUrl":"https://api.splitbasket.shop/v1/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://api.splitbasket.shop/v1/mcp需要授权

工具

详细介绍

SplitBasket Grocery Prices — MCP 服务与数据 API

为开发者和 Agent 提供缓存的美国杂货价格，数据来自 SplitBasket 背后的价格面板。每个价格都标有观测日期；API 会在你查询前告知它在某个地点能回答哪些问题，并在找不到结果时返回 found: false，而不是给出一个看似合理的错误数字。

API 文档与快速入门： https://splitbasket.shop/developers
条款： https://splitbasket.shop/api-terms
获取密钥（免费，封闭测试）： 发送邮件至 [email protected]，简单说明你正在构建什么；密钥由人工发放，通常会在一天内发出。

通过 MCP 连接

端点：https://api.splitbasket.shop/v1/mcp（Streamable HTTP，Bearer 身份验证）

Claude Code：

claude mcp add --transport http splitbasket \
  https://api.splitbasket.shop/v1/mcp \
  --header "Authorization: Bearer sk_live_..."

任何支持 Streamable HTTP 的 MCP 客户端都可以用相同方式连接——将其指向该端点，并设置 Authorization 标头。

或使用普通 HTTP

curl "https://api.splitbasket.shop/v1/compare_price?q=whole+milk&zip=94110" \
  -H "Authorization: Bearer sk_live_..."

工具

工具	功能
`search_products`	查找某个地点附近的商品，并显示附近各门店最近展示的价格
`get_price`	获取某个地点一家门店中某件精确商品（banner + product_id）的缓存价格
`compare_price`	为一个查询匹配各个 banner 的最佳商品，并按标准化单位价格排序
`coverage`	查看 API 在某个地点实际能回答哪些问题——在陌生地区应先调用此工具
`live_check`	立即从零售商处获取数据（付费套餐）；返回任务 ID 和预计耗时
`live_check_status`	轮询 live_check 任务状态

如实说明覆盖范围

分为两层（每周测量——2026-08-09；coverage 是运行时的真实数据源）：

全国层级 — 六个 banner：Walmart、Costco、Whole Foods、Sprouts、 Sam's Club、Aldi。51 个州（含 DC）中均至少有一家门店有定价数据；其中 50 个州可比较至少 2 个 banner，46 个州可比较至少 3 个（测量日期：2026-08-11）。这些门店每周都会针对一个约含 43 件商品的主食购物篮进行定价。
深度覆盖的大都市区 — San Francisco、Fresno、Phoenix、Austin：提供 7–17 个 banner 的完整购物目录。

价格是缓存的观测结果，不是实时报价。根据缓存年龄统计的精确匹配率，基于 27.5 万组观测数据：不到一天时为 99.6%，一周时为 93.8%，30 天时为 79.9%。每条记录都包含 price_as_of 和 price_age_days；传入 max_age_days 可限定在你的使用场景可接受的范围内。

本服务明确不提供什么

不提供购物篮优化器。 要估算购物篮价格，请对每件商品调用 compare_price，然后自行求和。
不提供价格确实不适用于全州范围的州级答案。 对 target、smartandfinal、bashas、frys、foodsco 使用整个连锁门店范围；对于价格呈双峰分布的连锁店，则按州处理：Costco 在 10 个经过测量的州如此，Whole Foods 在 CA 和 NV 如此。以上结论均基于测量，而非假设；降级名单会跟踪每周价格面板。
不提供混合准确度评分。 价格陈旧程度呈双峰分布：过期价格要么完全准确，要么存在明显误差，因此我们会披露价格年龄，而不是将其平均掉。

由 VoiceArc Inc. 运营。与任何零售商均无关联，亦未获其认可；零售商名称仅用于标明价格的观测来源。

支持 Markdown

登录后评论