Korea Tenders

@pipeworx/korea-tenders

韓国政府の調達情報を開きます。KONEPS（나라장터、公共調達サービスのポータル）、Defense e-Procurement、LH、K-water、Nuri-jangteoで現在受付中の入札公告と、KONEPSの契約を保有するサプライヤーを、BOIM（boim.io）が取りまとめた韓国公共データポータル（data.go.kr）のフィードから取得します。公告とベンダーの検索にAPIキーは不要です。落札結果はBYOKです。リクエストごとにライブデータを取得します。

Pipeworxの一部です。AI エージェントを1882以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流の提供元とは提携しておらず、同社の承認や公開を受けたものでもありません。

ツール

• korea_search_tenders(query?, category?, type?, region?, limit?) — 自由入力テキスト（タイトル／発注機関）、カテゴリ名、種別（物品／サービス／建設／その他）、発注者の地域を指定して、受付中の入札公告を検索します。各公告には、タイトル、種別、情報源のポータル、カテゴリとグループ、発注者、締切日時（KST）、推定価格（KRW）、契約方式と落札方式、g2b.go.krの公告URLが含まれます。締切が近い順に表示され、受付中の公告のみが対象です。

• korea_search_vendors(query?, category?, group?, region?, cert?, limit?) — KONEPSのショッピングモールで契約品目を持つ、または過去12か月に納入実績のあるサプライヤーを、品目カテゴリ、グループ、地域、名称、認証（여성기업、사회적기업、장애인기업、…）で検索します。次のツールで使うベンダーIDを返します。

• korea_get_vendor(id) — ベンダー1社の詳細を取得します。品目ごとの過去12か月の記録と金額、契約品目、上位の発注機関、契約方式、PPSの価格帯、認証、供給地域、事業者登録状況、データの制限が含まれます。

• korea_list_categories(group?) — 公共調達サービスの品目分類（물품분류）を取得します。すべてのグループとその上位カテゴリ、または1つのグループに含まれる全カテゴリと8桁コード、ベンダー数を表示します。

• korea_get_awards(type?, from, to | notice_no, winner?, title?, limit?, page?, _apiKey) — BYOKです。複数年にわたる落札結果（どの入札を誰が落札したか）を取得します。公告、発注者、落札者名と事業者番号、落札額（KRW）、落札率、入札者数が含まれます。 APIキーが必要です。無料で取得できるdata.go.krのサービスキーを_apiKeyとして渡してください。

認証

BOIMを利用する4つのツールは、APIキーなしで使用できます。korea_get_awardsはBYOKで、APIキーが必要です（Bruceの裁定、fleet #3423）。プラットフォームのAPIキーはありません。https://www.data.go.krで無料登録し、公共調達サービスの落札情報サービスを申請して、キーを_apiKeyとして渡してください。キーがない場合、ツールは「APIキーが必要です」として処理を拒否し、取得先を案内します。

データソース

• https://boim.io/api/mcp — BOIMの公開MCPエンドポイント（JSON-RPCのtools/call）。このパックはfind_public_bids、search_vendors、get_vendor、list_categoriesを呼び出し、結果を整形します。
• BOIMは1日2回、韓国公共データポータル（data.go.kr）の5つの入札フィードを取りまとめています。PPS KONEPSの入札公告（15129394）、Defense e-Procurement（15158416）、LH（15159012）、K-water（15101635）、PPS Nuri-jangteo（15129456）が含まれます。ベンダー情報はKONEPSショッピングモール品目サービス（15129471）と契約情報サービス（15129427）から取得します。ポータルには、これらすべてが再利用制限なし（이용허락범위 제한 없음）として掲載されています。
• BOIMの利用規約（https://boim.io/terms/、2026-10-06発効）では、無料利用枠内でのリクエストごとのMCP／API利用を認める一方、一括収集や再配布を禁止しています。このパックは呼び出しごとにプロキシするだけで、データを保存しません。

次の人が改めて調べることになる事項

• BOIM は韓国語のフレーズを 1 つだけ照合します。 query: "소프트웨어 유지보수" は 0 件を返しますが、 "소프트웨어" なら行が返ります。英語はまったく照合されません。このパックでは よく使われる英語の用語（software、IT services、cloud、construction、drone、 CCTV、Seoul、Gyeonggi、…）を 1 つの韓国語用語に対応付けており、送信した内容を query_sent で報告します。別名テーブルにない語句は変更せずに渡されるため、 翻訳されていない英単語の場合は、注記とともに正直に 0 件を返します。
• type は上流で韓国語（물품 / 용역 / 공사 / 기타）である必要があります。このパックは 英語を受け付けますが、それ以外は、黙ってすべてを返すのではなく、明示的にエラーにします。
• group を指定した list_categories の応答も groups キーの下に返されます（ グループは 1 つで、その中に categories がネストされています）。トップレベルに categories はありません。
• ベンダーの並び順は、関連度 → カードの充実度 → 日ごとのローテーション （rotation_seed）です。調達量順ではありません。同じ検索でも、明日には別のページが返ります。ベンダー ID は固定です。
• 日付：入札の deadline は +09:00 のオフセット付き ISO 形式です。ベンダーの日付は YYYYMMDD 形式で届き、検索ツールで YYYY-MM-DD に整形されます（ベンダーの完全な カードは受信したまま渡されます）。
• data.go.kr の KONEPS 公式オープン API には登録済みのサービスキーが必要です （キーがない場合は SERVICE_KEY_IS_NULL）。キーは保有していないため、BOIM を利用します。キーの予算が確保された場合は、同じツール構成のまま apis.data.go.kr/1230000/ad/BidPublicInfoService に接続先を変更できます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/korea-tenders/mcp の tools/list は、上の表にあるツールに 加えて、Pipeworx 共通のメタツール（ask_pipeworx、 discover_tools、search_within、remember/recall など、ゲートウェイ全体で 共通のツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、このパック独自のツールに加えて共通ツールが約 30 個表示されます。接続の initialize 応答に正確な範囲が記載されており、その日ごとの正式な情報源となります。

これは意図的な仕様であり、偶発的な多重化ではありません。これらのメタツールがあることで、このパックの対象外の質問にも、カタログ全体から振り分ける ask_pipeworx を通じて回答できます。MCP サーバーを 2 つ目に追加する必要はありません。現在、これらのメタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フルの Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます：

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

どちらの URL も同じゲートウェイと、同じ 1882 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/korea_search_tenders \
  -H 'Content-Type: application/json' \
  -d '{"query":"software","limit":5}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/korea_search_tenders を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイ経由の通信も不要です：

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

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-korea-tenders

stdin/stdout 経由で MCP を使用し、initialize/tools/list/tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Korea Tenders data" })

ゲートウェイが適切なツールを選択し、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT