procureport

procureport opens up Korean public-procurement data — the Nara Market / data.go.kr API family — through one binary that serves a command-line interface and a stdio MCP server. It covers bid notices, successful bids (awards) and contracts, procurement statistics, the registered product catalogue, and the public shopping mall.

Configuration

API-calling tools need a service key:

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

Calls go to data.go.kr-style endpoints under a base URL you can override with NARAMARKET_API_URL (default https://apis.data.go.kr). Requests are shaped as {base}/{service}/{operation}?serviceKey={key}&{params}.

Four tools are purely local — they answer from a built-in catalogue of the four API services and their operations, and work with nothing configured: server_info, get_all_api_services_info, get_api_operations, and get_data_exploration_guide. Every other tool checks for the service key first and fails with a clean error before any request is attempted when it is missing.

Related MCP server: narajangteo-pro

Install

npx @reneturcios/procureport server-info

Or run the container image:

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

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

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

Exit codes: 0 on success, 1 when a call fails (including a missing service key or an upstream API error), 2 for usage errors.

MCP server

npx -y @reneturcios/procureport mcp

MCP client configuration:

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

Tools

Basic:

Generic API access (each takes operation (required) and an optional params object):

Convenience:

Exploration:

Argument schemas in this rebuild are documented reconstructions from the public README of the original server (tool names and descriptions are documented; the README does not publish full schemas). The built-in catalogue's service operation counts follow the public spec (statistics 14, product list 12, shopping mall 9); individual operation names within the catalogue are documented reconstructions too.

Development

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

License

MIT — see LICENSE.