Prozorro Sale

@pipeworx/prozorro-sale

Prozorro.Saleは、国有・自治体資産の売却および賃貸のためのウクライナの公開オークションシステムです。土地の賃貸・売却オークション、自治体・国有財産の賃貸、小規模民営化、破産財団、木材、鉄道貨物、地下資源の権利を扱い、入札、落札、契約、再オークションの連鎖に対応します。

Pipeworxの一部です。AI エージェントを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でオークションを1件取得します。地籍番号と面積を含む品目、金額付きの入札、落札、署名済み契約、取消、関連する登記資産、および同じロットの前後の再オークションを表示します。
• 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です。プレフィックスで絞り込むと、エラーではなく0件が返されます。
• 地域フィルターには、公開時のウクライナ語の州名（Київська область）を正確に指定する必要があります。このパックでは一般的な英語名を変換します。
• 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サーバーをもう1つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル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