procureport

procureport

procureport 通过一个同时提供命令行界面和 stdio MCP 服务的二进制文件，开放韩国公共采购数据——Nara Market / data.go.kr API 系列。它涵盖招标公告、中标结果（授标）和合同、采购统计、注册产品目录以及公共购物商城。

配置

调用 API 的工具需要服务密钥：

export NARAMARKET_SERVICE_KEY=<your data.go.kr service key>

请求会发送到 data.go.kr 风格的端点，基础 URL 可通过 NARAMARKET_API_URL 覆盖（默认值为 https://apis.data.go.kr）。请求格式为 {base}/{service}/{operation}?serviceKey={key}&{params}。

有四个工具完全在本地运行——它们从内置的四个 API 服务及其操作目录中返回信息，无需进行任何配置：server_info、 get_all_api_services_info、get_api_operations 和 get_data_exploration_guide。其他所有工具都会先检查服务密钥；如果密钥缺失，会在尝试发送请求前返回清晰的错误。

安装

npx @reneturcios/procureport server-info

也可以运行容器镜像：

docker run -i -e NARAMARKET_SERVICE_KEY=... ghcr.io/cloudcorprecords/procureport

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

procureport server-info
procureport services
procureport operations shopping_mall
procureport guide
procureport crawl chair --page 1 --page-size 20
procureport attributes PRD-42
procureport recent-bids --days 7 --business-type 물품
procureport successful-bids 공사
procureport statistics-year 2025
procureport search-mall monitor --company Acme

procureport --version

退出代码：成功时为 0，调用失败时为 1（包括缺少服务密钥或上游 API 错误），用法错误时为 2。

MCP 服务

npx -y @reneturcios/procureport mcp

MCP 客户端配置：

{
  "mcpServers": {
    "procureport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/procureport", "mcp"],
      "env": { "NARAMARKET_SERVICE_KEY": "<your data.go.kr service key>" }
    }
  }
}

工具

基础：

工具	输入	返回内容
crawl_list	query（可选）、page、page_size（可选）	一页产品列表。
get_detailed_attributes	product_id（必需）	单个产品的详细属性。
server_info	（无）	服务身份、工具列表和服务摘要。本地运行。

通用 API 访问（每个工具均需要 operation（必需）和可选的 params 对象）：

工具	服务
call_public_data_standard_api	招标公告、中标结果和合同。
call_procurement_statistics_api	采购统计——14 个操作。
call_product_list_api	产品目录——12 个操作。
call_shopping_mall_api	购物商城——9 个操作。

便捷工具：

工具	输入	返回内容
get_recent_bid_announcements	days、business_type（均可选）	自动计算的近期时间范围内的招标公告。
get_successful_bids_by_business_type	business_type（必需）	指定业务类型的中标结果；例如 물품、용역、공사 或 외자 等韩文名称会自动转换为对应代码。
get_procurement_statistics_by_year	year（必需）	单个年份的采购统计。
search_shopping_mall_products	query（必需）、company（可选）	符合名称的购物商城产品；也可按单个公司进一步筛选。

数据探索：

工具	输入	返回内容
get_all_api_services_info	（无）	全部四个服务及其操作。本地运行。
get_api_operations	service（必需）	单个服务的操作。本地运行。
call_api_with_pagination_support	service、operation（必需）、params、max_pages、page_size（可选）	聚合多页结果，直到某页结果不足一页或达到页数上限。
get_data_exploration_guide	（无）	数据探索策略指南。本地运行。

此重建版本中的参数 Schema 是根据原服务公开 README 重建并记录的（工具名称和描述有文档说明；README 未公开完整 Schema）。内置目录中的服务操作数量遵循公开规范（统计 14 个、产品列表 12 个、购物商城 9 个）；目录中的各个操作名称同样是重建并记录的。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

许可证

MIT — 参见 LICENSE。