procureport
采购报告开放韩国政府采购数据-奈良 Market / data.go.kr API家族-通过一个二进制文件服务于 命令行接口和stdio MCP服务器。它包括出价。 公告，中标（授标）合同，采购 统计、注册产品目录，并公示 购物中心。
配置
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。
命令行界面
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 | (没有) | 探索数据的策略指南。当地。 |
此重建中的参数模式是有文档记录的重建 从原始服务器的公共README(工具名称和 描述记录在案；README没有完整发布 模式)。内置目录的服务操作计数如下 公共规范（统计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.