# @reneturcios/procureport 中文文档

规范地址：https://npmcn.com/package/%40reneturcios/procureport/

版本：0\.1\.0
npm 元数据更新时间：2026-11-02T06:55:20.054Z
中文译文更新时间：2026-11-02T08:11:52.291Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40reneturcios/procureport
原文对照：https://npmcn.com/package/%40reneturcios/procureport/?lang=original
项目主页：https://github.com/CloudCorpRecords/procureport#readme
源码仓库：https://github.com/CloudCorpRecords/procureport

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：80.8 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-11-02T06:54:24.467Z
- 最新版本发布：2026-11-02T06:55:19.889Z
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

韩国公共采购数据：招标公告、评标、合同、采购统计、产品目录和商场搜索，背后一个CLI和工作室MCP服务器。

## 安装

```sh
npm install @reneturcios/procureport
```

也可以使用：`pnpm add @reneturcios/procureport`、`yarn add @reneturcios/procureport`、`bun add @reneturcios/procureport`

## README

# procureport

采购报告开放韩国政府采购数据-奈良 Market / data.go.kr API家族-通过一个二进制文件服务于 命令行接口和stdio MCP服务器。它包括出价。 公告，中标（授标）合同，采购 统计、注册产品目录，并公示 购物中心。

## 配置

api调用工具需要一个服务密钥：

```bash
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`． 每一个其他工具检查 首先使用服务密钥，然后在任何请求之前失败并出现明显错误 当它丢失时尝试。

## 安装

```bash
npx @reneturcios/procureport server-info
```

或者运行容器镜像：

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

容器默认为MCP服务器（见下文）。通过CLI 参数将其用作CLI。

## 命令行界面

```bash
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服务器

```bash
npx -y @reneturcios/procureport mcp
```

MCP客户端配置：

```json
{
  "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项）； 目录中的单个操作名称被记录下来 重建。

## 开发

```bash
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`.

## 常见问题

### @reneturcios/procureport 是什么？

韩国公共采购数据：招标公告、评标、合同、采购统计、产品目录和商场搜索，背后一个CLI和工作室MCP服务器。

### 如何安装 @reneturcios/procureport？

在项目目录运行 npm install @reneturcios/procureport，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 procureport，可以用 npx procureport 直接运行。

### @reneturcios/procureport 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/reneturcios\_\_procureport 是否存在。

### @reneturcios/procureport 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @reneturcios/procureport 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @reneturcios/procureport 可以商用吗？

@reneturcios/procureport 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @reneturcios/procureport 还在维护吗？

最新版本 0\.1\.0 发布于 2026/11/02（1 天前）；至今共发布 2 个版本，其中过去 12 个月发布了 2 个；首次发布于 2026/11/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。