Prozorro Sale

@pipeworx/prozorro-sale

Prozorro.Sale 是乌克兰的公共拍卖系统，用于出售和出租国有及市政资产：土地租赁和土地出售拍卖、市政和国有财产租赁、小型私有化、破产财产、木材、铁路货物和地下资源权利，并提供竞价、授标、合同及同一标的的连续重复拍卖信息。

属于 Pipeworx —— 一个将 AI Agent 连接到 1764+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未经其认可，也非由其发布。

工具

• prozorro_sale_search(direction?, status?, region?, locality?, query?, selling_method?, category?, min_value?, max_value?, modified_since?, limit?, page?) — 查找拍卖，例如基辅州正在接受竞价的土地租赁拍卖。按修改时间从新到旧排序，并提供状态、起拍价、地区、卖方和竞价数量。
• prozorro_sale_procedure(id, include_chain?) — 根据公开 ID（LRE001-UA-20260813-89379）或内部 ID 查询单场拍卖：包含带地籍编号和面积的标的、竞价金额、授标、已签署合同、取消记录、相关登记资产，以及同一标的的较早和较晚重复拍卖。
• prozorro_sale_asset(id) — 查询登记资产（RAS001-UA-…），包括其持有人、状态及其参与过的拍卖。
• prozorro_sale_changes(since, limit?) — 获取上游按修改日期提供的变更数据流，按时间从旧到新排列，并提供用于继续查询的 next_since。

每个响应都包含 data_as_of。未知 ID 会返回 found: false；上游请求失败时会抛出包含上游状态的错误。

身份验证

无需密钥。

数据源

• https://procedure.prozorro.sale/api — Prozorro.Sale 公共 CBD API。

给后续维护者的说明：

• POST /api/search/procedures 仅接受 {limit, page, sort, filters}；每个筛选条件的格式为 {field, operator, value}。字段错误时会返回 422，并列出所有允许的字段——请查看列表，不要猜测。
• metaInfo.directions 与 sellingMethod 前缀并不相同：小型私有化对应 sellOut，basicSell 对应 otherAssets。按前缀筛选不会报错，但会返回零条记录。
• 地区筛选必须使用发布时的乌克兰州名（Київська область）；此包会转换常见的英文名称。
• GET /api/search/procedures（不带请求正文）会返回 204，看起来像是没有结果；这是错误的请求方法。
• _protected / _protect_level 会原样传递。上游会屏蔽竞标者的地址和联系方式；此包还会删除联系人姓名和个人税号（UA-IPN）。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "prozorro-sale": {
      "url": "https://gateway.pipeworx.io/prozorro-sale/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/prozorro-sale/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 的共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和其他整个网关范围内的工具。因此，你看到的工具数量会多于上表所列：目前，单个包的端点除了该包自己的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是了解当天情况的权威依据。

这是有意为之，并非意外的多路复用。元工具可以让作用域受限的连接回答本包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——无需再添加第二个 MCP 服务。目前无法在不包含这些工具的情况下挂载包端点；如果额外的架构定义占用的上下文超过了路由带来的价值，请直接连接完整网关，而不是连接多个包端点。

或者连接完整的 Pipeworx 网关，直接列出每个包的工具，而不仅仅是这个包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1764+ 个数据源。唯一的区别是会直接列出哪个包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/prozorro_sale_search \
  -H 'Content-Type: application/json' \
  -d '{"direction":"landRental","region":"Київська область","status":"active_tendering","limit":5}'

首次调用无需账号。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/prozorro_sale_search。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账号）

此软件包也可以作为本地 stdio MCP 服务运行，无需 Pipeworx 账号，也无需经过网关：

{
  "mcpServers": {
    "prozorro-sale": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-prozorro-sale"]
    }
  }
}

或者直接运行，确认它能够启动：

npx -y @pipeworx/mcp-prozorro-sale

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，但仅支持此软件包中的工具——不包含上述网关连接额外提供的任何共享元工具。相同的源代码，相同的工具，不经过 ask_pipeworx 路由。

与 ask_pipeworx 配合使用

你也可以用通俗的英语提问，而不是直接调用工具——这既适用于上面的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Prozorro Sale data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT