Korea Tenders

@pipeworx/korea-tenders

开放查询韩国政府采购：当前在 KONEPS（나라장터，公共采购服务门户）、国防电子采购、LH、K-water 和 Nuri-jangteo 上开放的投标公告，以及持有 KONEPS 合同的供应商。所有数据均来自由 BOIM（boim.io）汇总的韩国公共数据门户（data.go.kr）数据源。公告和供应商信息无需密钥；中标结果采用 BYOK。每次请求实时查询。

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

工具

• korea_search_tenders(query?, category?, type?, region?, limit?) — 按自由文本（标题／采购机构）、类别词、类型（货物／服务／工程／其他）和采购方所在地区搜索开放的投标公告。每条公告包含标题、类型、来源门户、类别和分组、采购方、截止时间（KST）、预估价格（KRW）、合同和评标方式，以及 g2b.go.kr 公告网址。按截止时间从近到远排列；仅显示仍开放的公告。

• korea_search_vendors(query?, category?, group?, region?, cert?, limit?) — 搜索过去 12 个月内有 KONEPS 购物商城合同商品或交付记录的供应商，可按商品类别、分组、地区、名称和认证（여성기업、사회적기업、장애인기업、…）搜索。返回供应商 ID，供下一个工具使用。

• korea_get_vendor(id) — 获取单家供应商的完整信息：过去 12 个月的逐项记录和金额、合同商品、主要采购机构、合同方式、PPS 价格范围、认证、供应地区、企业注册状态和数据限制。

• korea_list_categories(group?) — 公共采购服务的商品分类体系（물품분류）：查看所有分组及其顶级类别，或查看某一分组中的所有类别及其 8 位代码和供应商数量。

• korea_get_awards(type?, from, to | notice_no, winner?, title?, limit?, page?, _apiKey) — BYOK。多年中标结果（哪家企业中标哪项投标）：公告、采购方、中标方名称和企业编号、中标金额（KRW）、中标率、投标人数。 需要 API 密钥：将你自己的免费 data.go.kr 服务密钥作为 _apiKey 传入。

认证

由 BOIM 提供支持的四个工具无需密钥。korea_get_awards 采用 BYOK，需要 API 密钥（Bruce 的裁定，fleet #3423）：平台不提供密钥。请在 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 每天汇总两次来自韩国公共数据门户（data.go.kr）的五种投标数据源：PPS KONEPS 投标公告（15129394）、国防电子采购（15158416）、LH（15159012）、K-water（15101635）、PPS Nuri-jangteo（15129456）；供应商信息卡来自 KONEPS 购物商城商品服务（15129471）和合同信息服务（15129427）。门户将这些数据源全部列为不限制再利用（이용허락범위 제한 없음）。
• BOIM 的条款（https://boim.io/terms/，自 2026-10-06 起生效）允许在免费额度内逐次使用 MCP/API，并禁止批量收集或再分发——本工具包仅逐次代理请求，不存储任何内容。

下一位使用者可能会重新发现的事项

• BOIM 只匹配一个韩语短语。 query: "소프트웨어 유지보수" 返回 0 条结果； "소프트웨어" 则会返回记录。完全不匹配英语。该工具包会将常见英语术语（software、IT services、cloud、construction、drone、CCTV、Seoul、Gyeonggi、……）映射为一个韩语词，并在 query_sent 中报告发送的内容；别名表之外的内容会原样传递，因此未翻译的英语单词会如实返回 0 条结果，并附带说明。
• 上游要求 type 使用韩语（물품 / 용역 / 공사 / 기타）；该工具包接受英语，但会明确拒绝其他值，而不是静默地返回全部结果。
• list_categories 即使带有 group，仍会在 groups 键下返回结果（一个组，其 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 服务。目前无法挂载不带这些元工具的工具包端点；如果额外的架构定义所占用的上下文超过了路由带来的价值，请改为连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 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