kalicart-global

KaliCart Global — 面向 AI Agent 的联邦商务搜索

一次查询，覆盖多个独立的 WooCommerce 商店——真实商品、由商家权威确认的价格、带有明确文档说明的实时验证路径，可回到商家核验。无需密钥、只读、无需注册。

KaliCart Global 是一个公开的 Model Context Protocol 服务，可让 AI Agent 通过 ARC（Agent-Readable Catalog）协议搜索已选择加入的独立商家所提供的真实商品。Agent 无需抓取商店页面并猜测价格和库存，而是查询结构化的联邦索引，获取可信数据，然后将购物者引导至商家自己的商店完成购买。服务本身不处理交易。

• 端点： https://global.kalicart.com/mcp-public（远程，Streamable HTTP）——https://dashboard.kalicart.com/mcp-public 也可作为兼容别名使用
• 注册表： io.github.giuseppesocci-bot/kalicart-global — 官方 MCP 注册表，状态为 active
• 文档： https://bridge.kalicart.com/mcp/ · ARC 协议： https://bridge.kalicart.com/spec/ · 提供商授权： https://global.kalicart.com/providers/
• 法律信息： https://global.kalicart.com/terms/（使用条款，包括可选的联邦提供商交付渠道）· https://global.kalicart.com/privacy/（隐私声明）

为什么需要它

当机器只需要读取商品页面时，抓取页面行之有效。但当 Agent 需要基于真实价格和真实库存采取行动时，这种方式就会失效——价格可能过时，库存可能并不存在，商品变体也可能不存在。KaliCart 的做法是让目录变得可计算，而不只是可抓取：目录从设计上就支持查询且具有权威性，并以索引快照的形式提供，同时明确说明如何交回商家自己的 Bridge，在结账前进行实时验证。

以这种方式读取目录，成本也低得多。一项针对 Bridge 层的配套案例研究测得：向 Agent 提供一个包含 626 件商品的实时目录只需 8,000 个 token，而非 196,595 个——减少约 24 倍，目录内容小到足以放进模型的上下文窗口，而不会超出限制（阅读案例研究）。Global 将同样结构化、读取成本低的界面扩展到多个商家。

连接

将其作为远程（Streamable HTTP）服务添加到 MCP 客户端——无需 API 密钥或账户：

{
  "mcpServers": {
    "kalicart-global": {
      "url": "https://global.kalicart.com/mcp-public"
    }
  }
}

工具

全部五种工具均公开、无需密钥、只读且幂等。

工具	用途
global_search	按自由文本（q）和／或规范类别（leaf）搜索联邦索引，并支持按维度筛选（品牌、性别、颜色、价格范围、库存）。返回商品报价，包括商家权威确认的价格、UCP availability_status、商店页面 URL 和规范类别叶节点。
get_product	根据 p2209_id 获取完整商品详情（该 ID 可通过 global_search 获得）：价格、可用性、属性、变体和直接商店页面 URL。
lookup_merchant	检查商家域名是否运行符合 ARC 标准的目录（KaliCart Bridge）。返回 Bridge 版本、发现 URL 和联邦索引授权标记；未命中时返回 probe: "not_scheduled"，而不会将检查加入后台队列。联邦索引授权与商家对指定外部提供商的可选授权彼此独立（见上方“法律信息”）；此工具不会报告各提供商的授权状态。
list_merchants	列出参与商家及其域名、商店 URL 和商品数量。
list_categories	列出规范类别叶节点及商品数量；支持按 parent 筛选。

典型流程：使用 list_categories / list_merchants 了解覆盖范围 → 使用 global_search 查找商品报价 → 对入围商品使用 get_product → 跳转至商家商店 URL。

行为说明

• 不带 q 或 leaf 调用 global_search 会返回 query_required 错误（guidance_code: USE_Q_OR_LEAF），而不是空结果集——至少传入其中一项。
• 不带 parent 调用 list_categories 时，每次最多返回 100 个叶子类别（如果还有更多，则会包含 truncated: true、total 和 complete_via）；请使用 parent 过滤或分页提示遍历完整集合。
• 搜索结果和商品详情是索引快照（provenance.fetched_at），并非实时数据库读取——在将价格或库存视为最终信息前，请通过 Bridge 跳转链接验证所选商品。
• 自由文本查询会匹配商家的原生目录文本；服务端不会翻译。请使用 leaf 和 facet 筛选器进行语言无关的检索。
• 价格筛选器使用各商品报价的商家货币；不会进行外汇换算。
• 不支持分页：请使用 limit（商品报价最多 25 个，商家最多 50 个）。

此仓库是该服务的公共接口，用于文档、问题跟踪和安全联系。该服务为托管服务，其源代码未在此处发布。

MIT 许可证仅涵盖此仓库的内容；托管服务和目录数据受使用条款约束。

UCP 目录

KaliCart Global 也支持 Universal Commerce Protocol 的 Catalog 能力（规范版本 2026-08-25），因此任何 UCP 购物 Agent 都可以查询独立的 WooCommerce 商店，方式与查询其他 UCP 目录相同。

• 配置文件： https://global.kalicart.com/.well-known/ucp（目录搜索 + 查询，不支持结账）
• 端点： https://global.kalicart.com/ucp/mcp（Streamable HTTP）
• 工具： search_catalog、lookup_catalog、get_product。每个请求都必须携带 meta["ucp-agent"].profile。

预期行为：

• 每个变体都包含其卖家（商家），以及指向商店的链接；如有声明，还会包含其退款政策。
• search_catalog 返回索引快照（metadata.kalicart.snapshot_at）。如果商家的 KaliCart Bridge 及时响应，get_product 和 lookup_catalog 会从中实时读取价格和库存（metadata.kalicart.source = "live"）；如果回退到快照，也会明确说明。
• 价格使用 ISO 4217 次要货币单位。标识符稳定：gid://kalicart/Product/… 和 gid://kalicart/ProductVariant/…。
• 类别使用 KaliCart 规范分类体系（taxonomy: "kalicart"，例如 home.bedroom.pillows）；请将其作为 filters.categories 传回。
• 范围： 与公共 Global API 使用相同的目录——包含所有选择加入的商家，包括葡萄酒和烈酒以及数字商品；商店会在结账时自行执行年龄和法律检查。为特定平台构建的界面适用该平台更严格的商品政策；UCP 端点不适用。
• 仅为安装了 KaliCart Bridge 并选择加入的商家建立索引。KaliCart 从不销售商品、处理结账或收款：购买发生在商家的商店中，其结账流程具有最终决定权。

反馈

如果你正在评估或集成此服务，并遇到异常行为，请提交问题。在请求中注明 UTC 时间戳，便于我们与服务器日志进行关联。

安全相关事项请参阅 SECURITY.md——请勿通过公开问题报告漏洞。

相关项目

• KaliCart Bridge — 免费的 WooCommerce 插件，可让单个商家的目录供 Agent 读取（ARC）。Bridge 是每家商店的入口；Global 则是汇集众多此类入口的联合索引。
• kalicart-mcp — 用于 WordPress 内容的站点级 MCP 插件。

---

由 Save The Brain 维护 · Giuseppe Socci