@opendata-kr/narajangteo-opening-mcp 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +558 -0
- package/dist/index.js +443 -0
- package/dist/index.js.map +1 -0
- package/package.json +55 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 opendata-kr
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,558 @@
|
|
|
1
|
+
<!-- mcp-name: io.github.opendata-kr/narajangteo-opening -->
|
|
2
|
+
|
|
3
|
+
# @opendata-kr/narajangteo-opening-mcp
|
|
4
|
+
|
|
5
|
+
나라장터 낙찰정보서비스(공공데이터포털 data.go.kr) Open API를 감싼 로컬 MCP 서버.
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/@opendata-kr/narajangteo-opening-mcp)
|
|
8
|
+
[](https://github.com/opendata-kr/narajangteo-opening-mcp/actions/workflows/ci.yml)
|
|
9
|
+
[](https://nodejs.org)
|
|
10
|
+
[](./LICENSE)
|
|
11
|
+
|
|
12
|
+
MCP 클라이언트에서 나라장터 낙찰정보(개찰결과·최종낙찰자·투찰업체별 순위·예비가격·유찰/재입찰)를 자연어로 검색하고 조회한다. 예를 들어 이렇게 물어볼 수 있다.
|
|
13
|
+
|
|
14
|
+
- "R25BK00965123 공고 개찰결과 보여줘. 낙찰자랑 투찰업체별 순위·금액."
|
|
15
|
+
- "인천 지역 물품 낙찰 결과 최근 것 검색해줘."
|
|
16
|
+
- "이 공고 유찰됐는지 확인해줘."
|
|
17
|
+
|
|
18
|
+
## 특징
|
|
19
|
+
|
|
20
|
+
- **4계열 데이터를 3개 도구로 노출**: 낙찰자(A)·개찰진행(B)·예비가격상세(C)·투찰업체별(D) 오퍼레이션을 검색용 2개(`search_awards`·`search_openings`)와 단건 심층조회 1개(`get_bid_result`)로 묶어 사용성을 단순화했다.
|
|
21
|
+
- **4개 업무구분 병렬 검색**: 공사/용역/물품/외자를 한 번에 조회한다. 업무구분 미지정 시 전 구분을 동시 검색한다.
|
|
22
|
+
- **넓은 기간 자동 분할**: `startDate`/`endDate` 범위가 넓으면 내부에서 창 단위로 쪼개 순차 조회한다.
|
|
23
|
+
- **부분 실패 표면화**: 일부 구분·집행 조회가 실패해도 나머지 결과를 반환하고, 실패는 오류 메시지로 드러낸다(조용한 누락 없음).
|
|
24
|
+
- **복합키 정합**: `get_bid_result`는 공고번호+차수+분류+재입찰번호로 A/B/C/D를 조인해 집행 단위로 묶는다.
|
|
25
|
+
- **data.go.kr 에러코드 한국어화**: 인증키 만료, 트래픽 초과 등 결과코드를 조치 가능한 한국어 메시지로 정규화한다.
|
|
26
|
+
- **이중 인코딩 방어**: Encoding 키를 잘못 넣으면 경고하고, 요청은 한 번만 인코딩한다.
|
|
27
|
+
- **타임아웃**: API 호출에 타임아웃을 둔다.
|
|
28
|
+
|
|
29
|
+
## 준비물
|
|
30
|
+
|
|
31
|
+
- **Node.js 24** 이상 (`.nvmrc` = `lts/krypton`).
|
|
32
|
+
- **data.go.kr 인증키**:
|
|
33
|
+
1. [공공데이터포털](https://www.data.go.kr)에서 **나라장터 낙찰정보서비스**(`ScsbidInfoService`)를 활용신청해 `[승인]`을 받는다. 인증키는 계정당 하나지만, 각 API는 저마다 활용신청 승인이 있어야 그 API에서 인증된다. 서비스키가 있어도 이 API를 활용신청하지 않으면 인증 오류(코드 30)가 난다.
|
|
34
|
+
2. 마이페이지 → 활용신청 현황 → 개발계정 상세에서 **Decoding 서비스키**를 복사한다.
|
|
35
|
+
3. 같은 `DATA_GO_KR_SERVICE_KEY`는 같은 계정으로 활용신청한 다른 data.go.kr API에도 재사용된다.
|
|
36
|
+
|
|
37
|
+
> [!TIP]
|
|
38
|
+
> 공공데이터포털이 처음이라면 활용신청부터 인증키 복사까지 그림으로 따라 하는 [**data.go.kr 인증키 발급 가이드**](docs/service-key-guide.md)를 참고한다.
|
|
39
|
+
|
|
40
|
+
> 서비스키는 반드시 **Decoding(원본)** 키를 넣는다. Encoding(`%2B` 등 포함) 키를 넣으면 이중 인코딩으로 인증 오류(코드 30)가 난다.
|
|
41
|
+
|
|
42
|
+
## MCP 클라이언트 설정
|
|
43
|
+
|
|
44
|
+
MCP 클라이언트에 아래 config를 추가한다:
|
|
45
|
+
|
|
46
|
+
```json
|
|
47
|
+
{
|
|
48
|
+
"mcpServers": {
|
|
49
|
+
"narajangteo-opening": {
|
|
50
|
+
"command": "npx",
|
|
51
|
+
"args": ["-y", "@opendata-kr/narajangteo-opening-mcp@latest"],
|
|
52
|
+
"env": { "DATA_GO_KR_SERVICE_KEY": "발급받은_Decoding_키" }
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
> [!NOTE]
|
|
59
|
+
> `@opendata-kr/narajangteo-opening-mcp@latest`를 쓰면 클라이언트가 항상 최신 버전을 받는다.
|
|
60
|
+
|
|
61
|
+
> [!IMPORTANT]
|
|
62
|
+
> `DATA_GO_KR_SERVICE_KEY`(필수, **Decoding 원본** 키)가 없으면 첫 호출이 인증 오류(코드 30)로 실패한다. 위 config의 `env`에 키를 넣는다. 원클릭 버튼이나 env를 config에 담지 못하는 클라이언트는 설치 후 셸 환경변수로 `DATA_GO_KR_SERVICE_KEY`를 설정한다.
|
|
63
|
+
|
|
64
|
+
### 클라이언트별 설정
|
|
65
|
+
|
|
66
|
+
<details>
|
|
67
|
+
<summary>Amp</summary>
|
|
68
|
+
https://ampcode.com/manual#mcp 의 안내를 따르고 위 config를 사용한다. CLI로도 추가할 수 있다:
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
amp mcp add narajangteo-opening -- npx -y @opendata-kr/narajangteo-opening-mcp@latest
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
이후 생성된 설정의 `env`(또는 셸 환경변수)에 `DATA_GO_KR_SERVICE_KEY`를 추가한다.
|
|
75
|
+
|
|
76
|
+
</details>
|
|
77
|
+
|
|
78
|
+
<details>
|
|
79
|
+
<summary>Antigravity</summary>
|
|
80
|
+
|
|
81
|
+
<a href="https://antigravity.google/docs/mcp">Antigravity 문서</a>의 커스텀 MCP 서버 추가 방법을 따라 아래 config를 MCP servers 설정에 넣는다:
|
|
82
|
+
|
|
83
|
+
```json
|
|
84
|
+
{
|
|
85
|
+
"mcpServers": {
|
|
86
|
+
"narajangteo-opening": {
|
|
87
|
+
"command": "npx",
|
|
88
|
+
"args": ["-y", "@opendata-kr/narajangteo-opening-mcp@latest"],
|
|
89
|
+
"env": { "DATA_GO_KR_SERVICE_KEY": "발급받은_Decoding_키" }
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
</details>
|
|
96
|
+
|
|
97
|
+
<details>
|
|
98
|
+
<summary>Claude Code</summary>
|
|
99
|
+
|
|
100
|
+
Claude Code CLI로 서버를 추가한다 (<a href="https://code.claude.com/docs/en/mcp">가이드</a>):
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
claude mcp add narajangteo-opening --scope user --env DATA_GO_KR_SERVICE_KEY=발급받은_Decoding_키 -- npx -y @opendata-kr/narajangteo-opening-mcp@latest
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
</details>
|
|
107
|
+
|
|
108
|
+
<details>
|
|
109
|
+
<summary>Cline</summary>
|
|
110
|
+
https://docs.cline.bot/mcp/configuring-mcp-servers 의 안내를 따르고 위 config를 사용한다.
|
|
111
|
+
</details>
|
|
112
|
+
|
|
113
|
+
<details>
|
|
114
|
+
<summary>Codex</summary>
|
|
115
|
+
<a href="https://developers.openai.com/codex/mcp/#configure-with-the-cli">MCP 설정 가이드</a>를 따르고 위 config를 사용한다. Codex CLI로도 추가할 수 있다:
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
codex mcp add narajangteo-opening --env DATA_GO_KR_SERVICE_KEY=발급받은_Decoding_키 -- npx -y @opendata-kr/narajangteo-opening-mcp@latest
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
**Windows**
|
|
122
|
+
|
|
123
|
+
`~/.codex/config.toml`에 `cmd /c` 래핑으로 추가한다:
|
|
124
|
+
|
|
125
|
+
```toml
|
|
126
|
+
[mcp_servers.narajangteo-opening]
|
|
127
|
+
command = "cmd"
|
|
128
|
+
args = ["/c", "npx", "-y", "@opendata-kr/narajangteo-opening-mcp@latest"]
|
|
129
|
+
env = { DATA_GO_KR_SERVICE_KEY = "발급받은_Decoding_키" }
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
</details>
|
|
133
|
+
|
|
134
|
+
<details>
|
|
135
|
+
<summary>Command Code</summary>
|
|
136
|
+
|
|
137
|
+
Command Code CLI로 서버를 추가한다 (<a href="https://commandcode.ai/docs/mcp">MCP 가이드</a>):
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
cmd mcp add narajangteo-opening --scope user npx -y @opendata-kr/narajangteo-opening-mcp@latest
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
이후 생성된 설정의 `env`(또는 셸 환경변수)에 `DATA_GO_KR_SERVICE_KEY`를 추가한다.
|
|
144
|
+
|
|
145
|
+
</details>
|
|
146
|
+
|
|
147
|
+
<details>
|
|
148
|
+
<summary>Continue</summary>
|
|
149
|
+
|
|
150
|
+
Continue의 <a href="https://docs.continue.dev/customize/deep-dives/mcp">MCP 가이드</a>를 따른다. Continue는 `mcpServers`를 배열로 쓴다:
|
|
151
|
+
|
|
152
|
+
```json
|
|
153
|
+
{
|
|
154
|
+
"mcpServers": [
|
|
155
|
+
{
|
|
156
|
+
"name": "narajangteo-opening",
|
|
157
|
+
"command": "npx",
|
|
158
|
+
"args": ["-y", "@opendata-kr/narajangteo-opening-mcp@latest"],
|
|
159
|
+
"env": { "DATA_GO_KR_SERVICE_KEY": "발급받은_Decoding_키" }
|
|
160
|
+
}
|
|
161
|
+
]
|
|
162
|
+
}
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
</details>
|
|
166
|
+
|
|
167
|
+
<details>
|
|
168
|
+
<summary>Copilot CLI</summary>
|
|
169
|
+
|
|
170
|
+
Copilot CLI를 시작한다:
|
|
171
|
+
|
|
172
|
+
```
|
|
173
|
+
copilot
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
MCP 서버 추가 대화를 연다:
|
|
177
|
+
|
|
178
|
+
```
|
|
179
|
+
/mcp add
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
다음 필드를 입력하고 `CTRL+S`로 저장한다:
|
|
183
|
+
|
|
184
|
+
- **Server name:** `narajangteo-opening`
|
|
185
|
+
- **Server Type:** `[1] Local`
|
|
186
|
+
- **Command:** `npx -y @opendata-kr/narajangteo-opening-mcp@latest`
|
|
187
|
+
- **Environment variables:** `DATA_GO_KR_SERVICE_KEY=발급받은_Decoding_키`
|
|
188
|
+
|
|
189
|
+
</details>
|
|
190
|
+
|
|
191
|
+
<details>
|
|
192
|
+
<summary>Copilot / VS Code</summary>
|
|
193
|
+
|
|
194
|
+
**버튼으로 설치:**
|
|
195
|
+
|
|
196
|
+
[<img src="https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code">](https://vscode.dev/redirect/mcp/install?name=io.github.opendata-kr%2Fnarajangteo-opening&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40opendata-kr%2Fnarajangteo-opening-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)
|
|
197
|
+
|
|
198
|
+
[<img src="https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code Insiders">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522io.github.opendata-kr%252Fnarajangteo-opening%2522%252C%2522config%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540opendata-kr%252Fnarajangteo-opening-mcp%2522%255D%252C%2522env%2522%253A%257B%257D%257D%257D)
|
|
199
|
+
|
|
200
|
+
> 버튼은 키를 담지 못한다. 설치 후 `.vscode/mcp.json`(또는 사용자 설정)의 `env`에 `DATA_GO_KR_SERVICE_KEY`를 추가한다.
|
|
201
|
+
|
|
202
|
+
**직접 추가:**
|
|
203
|
+
|
|
204
|
+
VS Code [MCP 설정 가이드](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server)를 따르거나 CLI를 쓴다.
|
|
205
|
+
|
|
206
|
+
macOS·Linux:
|
|
207
|
+
|
|
208
|
+
```bash
|
|
209
|
+
code --add-mcp '{"name":"narajangteo-opening","command":"npx","args":["-y","@opendata-kr/narajangteo-opening-mcp@latest"],"env":{"DATA_GO_KR_SERVICE_KEY":"발급받은_Decoding_키"}}'
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
Windows(PowerShell):
|
|
213
|
+
|
|
214
|
+
```powershell
|
|
215
|
+
code --add-mcp '{"""name""":"""narajangteo-opening""","""command""":"""npx""","""args""":["""-y""","""@opendata-kr/narajangteo-opening-mcp@latest"""],"""env""":{"""DATA_GO_KR_SERVICE_KEY""":"""발급받은_Decoding_키"""}}'
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
</details>
|
|
219
|
+
|
|
220
|
+
<details>
|
|
221
|
+
<summary>Cursor</summary>
|
|
222
|
+
|
|
223
|
+
**버튼으로 설치:**
|
|
224
|
+
|
|
225
|
+
[<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add narajangteo-opening MCP server to Cursor">](https://cursor.com/en/install-mcp?name=narajangteo-opening&config=eyJjb21tYW5kIjoibnB4IC15IEBvcGVuZGF0YS1rci9uYXJhamFuZ3Rlby1vcGVuaW5nLW1jcEBsYXRlc3QifQ==)
|
|
226
|
+
|
|
227
|
+
> 버튼은 키를 담지 못한다. 설치 후 Cursor의 MCP 설정에서 `env`에 `DATA_GO_KR_SERVICE_KEY`를 추가한다.
|
|
228
|
+
|
|
229
|
+
**직접 추가:**
|
|
230
|
+
|
|
231
|
+
`Cursor Settings` → `MCP` → `New MCP Server`에서 위 config를 사용한다.
|
|
232
|
+
|
|
233
|
+
</details>
|
|
234
|
+
|
|
235
|
+
<details>
|
|
236
|
+
<summary>Factory CLI</summary>
|
|
237
|
+
|
|
238
|
+
Factory CLI로 서버를 추가한다 (<a href="https://docs.factory.ai/cli/configuration/mcp">가이드</a>):
|
|
239
|
+
|
|
240
|
+
```bash
|
|
241
|
+
droid mcp add narajangteo-opening "npx -y @opendata-kr/narajangteo-opening-mcp@latest"
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
이후 생성된 설정의 `env`(또는 셸 환경변수)에 `DATA_GO_KR_SERVICE_KEY`를 추가한다.
|
|
245
|
+
|
|
246
|
+
</details>
|
|
247
|
+
|
|
248
|
+
<details>
|
|
249
|
+
<summary>Gemini CLI</summary>
|
|
250
|
+
|
|
251
|
+
Gemini CLI로 서버를 추가한다.
|
|
252
|
+
|
|
253
|
+
**프로젝트 범위:**
|
|
254
|
+
|
|
255
|
+
```bash
|
|
256
|
+
gemini mcp add narajangteo-opening npx -y @opendata-kr/narajangteo-opening-mcp@latest
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
**전역:**
|
|
260
|
+
|
|
261
|
+
```bash
|
|
262
|
+
gemini mcp add -s user narajangteo-opening npx -y @opendata-kr/narajangteo-opening-mcp@latest
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
또는 <a href="https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md#how-to-set-up-your-mcp-server">MCP 가이드</a>를 따르고 위 config를 쓴다. `~/.gemini/settings.json`의 서버 정의 `env`에 `DATA_GO_KR_SERVICE_KEY`를 추가한다.
|
|
266
|
+
|
|
267
|
+
</details>
|
|
268
|
+
|
|
269
|
+
<details>
|
|
270
|
+
<summary>Gemini Code Assist</summary>
|
|
271
|
+
<a href="https://cloud.google.com/gemini/docs/codeassist/use-agentic-chat-pair-programmer#configure-mcp-servers">MCP 설정 가이드</a>를 따르고 위 config를 사용한다.
|
|
272
|
+
</details>
|
|
273
|
+
|
|
274
|
+
<details>
|
|
275
|
+
<summary>Grok Build CLI</summary>
|
|
276
|
+
|
|
277
|
+
```bash
|
|
278
|
+
grok mcp add narajangteo-opening npx -y @opendata-kr/narajangteo-opening-mcp@latest
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
이후 생성된 설정의 `env`(또는 셸 환경변수)에 `DATA_GO_KR_SERVICE_KEY`를 추가한다. 더 많은 옵션은 <a href="https://docs.x.ai/build/features/skills-plugins-marketplaces">문서</a> 참고.
|
|
282
|
+
|
|
283
|
+
</details>
|
|
284
|
+
|
|
285
|
+
<details>
|
|
286
|
+
<summary>JetBrains AI Assistant & Junie</summary>
|
|
287
|
+
|
|
288
|
+
`Settings | Tools | AI Assistant | Model Context Protocol (MCP)` → `Add`에서 위 config를 사용한다.
|
|
289
|
+
Junie도 같은 방식으로 `Settings | Tools | Junie | MCP Settings` → `Add`에서 위 config를 사용한다.
|
|
290
|
+
|
|
291
|
+
</details>
|
|
292
|
+
|
|
293
|
+
<details>
|
|
294
|
+
<summary>Katalon Studio</summary>
|
|
295
|
+
|
|
296
|
+
Katalon StudioAssist는 MCP 프록시를 통해 stdio 서버를 연결한다.
|
|
297
|
+
|
|
298
|
+
**1단계:** <a href="https://docs.katalon.com/katalon-studio/studioassist/mcp-servers/setting-up-mcp-proxy-for-stdio-mcp-servers">MCP 프록시 설정 가이드</a>로 프록시를 설치한다.
|
|
299
|
+
|
|
300
|
+
**2단계:** 프록시로 서버를 띄운다(같은 셸에 `DATA_GO_KR_SERVICE_KEY`를 export 한 상태):
|
|
301
|
+
|
|
302
|
+
```bash
|
|
303
|
+
DATA_GO_KR_SERVICE_KEY=발급받은_Decoding_키 mcp-proxy --transport streamablehttp --port 8080 -- npx -y @opendata-kr/narajangteo-opening-mcp@latest
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
**3단계:** StudioAssist에 다음 설정으로 서버를 추가한다:
|
|
307
|
+
|
|
308
|
+
- **Connection URL:** `http://127.0.0.1:8080/mcp`
|
|
309
|
+
- **Transport type:** `HTTP`
|
|
310
|
+
|
|
311
|
+
</details>
|
|
312
|
+
|
|
313
|
+
<details>
|
|
314
|
+
<summary>Kiro</summary>
|
|
315
|
+
|
|
316
|
+
**Kiro Settings**에서 `Configure MCP` → `Open Workspace or User MCP Config` → 위 config를 사용한다.
|
|
317
|
+
|
|
318
|
+
또는 **Activity Bar** → `Kiro` → `MCP Servers` → `Open MCP Config`에서 위 config를 사용한다.
|
|
319
|
+
|
|
320
|
+
</details>
|
|
321
|
+
|
|
322
|
+
<details>
|
|
323
|
+
<summary>Mistral Vibe</summary>
|
|
324
|
+
|
|
325
|
+
`~/.vibe/config.toml`에 추가한다:
|
|
326
|
+
|
|
327
|
+
```toml
|
|
328
|
+
[[mcp_servers]]
|
|
329
|
+
name = "narajangteo-opening"
|
|
330
|
+
transport = "stdio"
|
|
331
|
+
command = "npx"
|
|
332
|
+
args = ["-y", "@opendata-kr/narajangteo-opening-mcp@latest"]
|
|
333
|
+
env = { DATA_GO_KR_SERVICE_KEY = "발급받은_Decoding_키" }
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
</details>
|
|
337
|
+
|
|
338
|
+
<details>
|
|
339
|
+
<summary>OpenCode</summary>
|
|
340
|
+
|
|
341
|
+
`opencode.json`에 추가한다. 없으면 `~/.config/opencode/opencode.json`에 만든다 (<a href="https://opencode.ai/docs/mcp-servers">가이드</a>):
|
|
342
|
+
|
|
343
|
+
```json
|
|
344
|
+
{
|
|
345
|
+
"$schema": "https://opencode.ai/config.json",
|
|
346
|
+
"mcp": {
|
|
347
|
+
"narajangteo-opening": {
|
|
348
|
+
"type": "local",
|
|
349
|
+
"command": ["npx", "-y", "@opendata-kr/narajangteo-opening-mcp@latest"],
|
|
350
|
+
"environment": { "DATA_GO_KR_SERVICE_KEY": "발급받은_Decoding_키" }
|
|
351
|
+
}
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
</details>
|
|
357
|
+
|
|
358
|
+
<details>
|
|
359
|
+
<summary>Qoder</summary>
|
|
360
|
+
|
|
361
|
+
**Qoder Settings**에서 `MCP Server` → `+ Add` → 위 config를 사용한다.
|
|
362
|
+
|
|
363
|
+
또는 <a href="https://docs.qoder.com/user-guide/chat/model-context-protocol">MCP 가이드</a>를 따르고 위 config를 쓴다.
|
|
364
|
+
|
|
365
|
+
</details>
|
|
366
|
+
|
|
367
|
+
<details>
|
|
368
|
+
<summary>Qoder CLI</summary>
|
|
369
|
+
|
|
370
|
+
Qoder CLI로 서버를 추가한다 (<a href="https://docs.qoder.com/cli/using-cli#mcp-servers">가이드</a>):
|
|
371
|
+
|
|
372
|
+
**프로젝트 범위:**
|
|
373
|
+
|
|
374
|
+
```bash
|
|
375
|
+
qodercli mcp add narajangteo-opening -- npx @opendata-kr/narajangteo-opening-mcp@latest
|
|
376
|
+
```
|
|
377
|
+
|
|
378
|
+
**전역:**
|
|
379
|
+
|
|
380
|
+
```bash
|
|
381
|
+
qodercli mcp add -s user narajangteo-opening -- npx @opendata-kr/narajangteo-opening-mcp@latest
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
이후 생성된 설정의 `env`(또는 셸 환경변수)에 `DATA_GO_KR_SERVICE_KEY`를 추가한다.
|
|
385
|
+
|
|
386
|
+
</details>
|
|
387
|
+
|
|
388
|
+
<details>
|
|
389
|
+
<summary>Visual Studio</summary>
|
|
390
|
+
|
|
391
|
+
**버튼으로 설치:**
|
|
392
|
+
|
|
393
|
+
[<img src="https://img.shields.io/badge/Visual_Studio-Install-C16FDE?logo=visualstudio&logoColor=white" alt="Install in Visual Studio">](https://vs-open.link/mcp-install?%7B%22name%22%3A%22narajangteo-opening%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22%40opendata-kr%2Fnarajangteo-opening-mcp%40latest%22%5D%7D)
|
|
394
|
+
|
|
395
|
+
> 버튼은 키를 담지 못한다. 설치 후 서버 설정의 `env`에 `DATA_GO_KR_SERVICE_KEY`를 추가한다.
|
|
396
|
+
|
|
397
|
+
</details>
|
|
398
|
+
|
|
399
|
+
<details>
|
|
400
|
+
<summary>Warp</summary>
|
|
401
|
+
|
|
402
|
+
`Settings | AI | Manage MCP Servers` → `+ Add`에서 [MCP 서버를 추가](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server)하고 위 config를 사용한다.
|
|
403
|
+
|
|
404
|
+
</details>
|
|
405
|
+
|
|
406
|
+
<details>
|
|
407
|
+
<summary>Windsurf</summary>
|
|
408
|
+
<a href="https://docs.windsurf.com/windsurf/cascade/mcp#mcp-config-json">MCP 설정 가이드</a>를 따르고 위 config를 사용한다. Windsurf는 `mcpServers` 키를 쓴다(`~/.codeium/windsurf/mcp_config.json`).
|
|
409
|
+
</details>
|
|
410
|
+
|
|
411
|
+
<details>
|
|
412
|
+
<summary>Zed</summary>
|
|
413
|
+
|
|
414
|
+
`~/.config/zed/settings.json`에 추가한다(스키마는 Zed 버전에 따라 다를 수 있으니 <a href="https://zed.dev/docs/ai/mcp">Zed 공식 문서</a>를 확인):
|
|
415
|
+
|
|
416
|
+
```json
|
|
417
|
+
{
|
|
418
|
+
"context_servers": {
|
|
419
|
+
"narajangteo-opening": {
|
|
420
|
+
"command": { "path": "npx", "args": ["-y", "@opendata-kr/narajangteo-opening-mcp@latest"] },
|
|
421
|
+
"env": { "DATA_GO_KR_SERVICE_KEY": "발급받은_Decoding_키" }
|
|
422
|
+
}
|
|
423
|
+
}
|
|
424
|
+
}
|
|
425
|
+
```
|
|
426
|
+
|
|
427
|
+
</details>
|
|
428
|
+
|
|
429
|
+
<details>
|
|
430
|
+
<summary>ChatGPT · 원격 전용 클라이언트</summary>
|
|
431
|
+
|
|
432
|
+
ChatGPT Developer Mode처럼 **원격(HTTPS) MCP만 지원하는 클라이언트**는 로컬 stdio 서버를 직접 붙일 수 없다. stdio→HTTP 브리지(`mcp-proxy`)로 이 서버를 HTTP로 띄우고 공개 HTTPS 엔드포인트(리버스 프록시·터널·호스팅)로 노출한 뒤, 그 URL을 커넥터로 등록한다.
|
|
433
|
+
|
|
434
|
+
```bash
|
|
435
|
+
DATA_GO_KR_SERVICE_KEY=발급받은_Decoding_키 mcp-proxy --transport streamablehttp --port 8080 -- npx -y @opendata-kr/narajangteo-opening-mcp@latest
|
|
436
|
+
```
|
|
437
|
+
|
|
438
|
+
`http://127.0.0.1:8080/mcp`를 공개 HTTPS로 노출하는 것은 사용자 몫이다. (`mcp-remote`는 반대로 stdio 클라이언트를 원격 서버에 붙일 때 쓰는 도구라 여기엔 맞지 않는다.)
|
|
439
|
+
|
|
440
|
+
</details>
|
|
441
|
+
|
|
442
|
+
### 발견성
|
|
443
|
+
|
|
444
|
+
이 서버는 MCP 레지스트리에 `io.github.opendata-kr/narajangteo-opening`으로 기술된다. [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io)를 지원하는 클라이언트에서 검색·설치할 수 있다.
|
|
445
|
+
|
|
446
|
+
## 환경변수
|
|
447
|
+
|
|
448
|
+
| 환경변수 | 필수 | 비밀 | 기본값 | 설명 |
|
|
449
|
+
|---|---|---|---|---|
|
|
450
|
+
| `DATA_GO_KR_SERVICE_KEY` | 예 | 예 | (없음) | 공공데이터포털 **Decoding(원본)** 인증키 |
|
|
451
|
+
| `DATA_GO_KR_BASE_URL` | 아니오 | 아니오 | `https://apis.data.go.kr` | 게이트웨이 base 오버라이드 |
|
|
452
|
+
|
|
453
|
+
## 도구
|
|
454
|
+
|
|
455
|
+
3개 도구 모두 읽기 전용 조회다(`readOnlyHint`). 업무구분(`bidKind`) 배열: `cnstwk`(공사) `servc`(용역) `thng`(물품) `frgcpt`(외자). 미지정 시 전 구분 병렬 조회한다. `startDate`/`endDate`(`YYYYMMDD`)는 함께 지정하며, 넓은 범위는 내부에서 창 단위로 분할해 순차 조회한다.
|
|
456
|
+
|
|
457
|
+
### `search_awards`
|
|
458
|
+
|
|
459
|
+
나라장터 낙찰 결과(최종낙찰자)를 공고명·기관·수요기관(코드)·지역·업종·추정가·사업자번호·기간으로 검색한다. "누가 얼마에 낙찰받았나", 경쟁사(사업자번호) 낙찰 이력, 되풀이 사업의 종단 조회에 쓴다. 낙찰자만 반환하며 그 업체가 참여했으나 진 입찰은 미포함이다. 특정 공고의 개찰·투찰업체·예비가 상세는 `get_bid_result`, 개찰 진행·유찰 발굴은 `search_openings`를 쓴다.
|
|
460
|
+
|
|
461
|
+
| 파라미터 | 타입 | 설명 |
|
|
462
|
+
|---|---|---|
|
|
463
|
+
| `bidKind` | `string[]` | 업무구분 배열. 미지정 시 전 구분 병렬 |
|
|
464
|
+
| `keyword` | `string` | 공고명 부분검색(`bidNtceNm`) |
|
|
465
|
+
| `institution` | `string` | 공고기관명(`ntceInsttNm`) |
|
|
466
|
+
| `demandInstitution` | `string` | 수요기관명(`dminsttNm`) |
|
|
467
|
+
| `demandInstitutionCode` | `string` | 수요기관코드(`dminsttCd`). 종단 식별에 안정적 |
|
|
468
|
+
| `detailProductCode` | `string` | 세부품명번호(`dtilPrdctClsfcNo`) |
|
|
469
|
+
| `region` | `string` | 참가제한지역명(`prtcptLmtRgnNm`) |
|
|
470
|
+
| `industry` | `string` | 업종명(`indstrytyNm`) |
|
|
471
|
+
| `minPrice` | `number` | 추정가격 하한(`presmptPrceBgn`) |
|
|
472
|
+
| `maxPrice` | `number` | 추정가격 상한(`presmptPrceEnd`) |
|
|
473
|
+
| `bizno` | `string` | 업체 사업자번호. 그 업체의 낙찰건만 조회(진 입찰은 미포함) |
|
|
474
|
+
| `startDate` | `string` | 조회 시작일 `YYYYMMDD` |
|
|
475
|
+
| `endDate` | `string` | 조회 종료일 `YYYYMMDD` |
|
|
476
|
+
| `dateType` | `string` | 날짜 기준: `posted`(공고게시, 기본) `opened`(개찰) |
|
|
477
|
+
| `pageSize` | `number` | 창당 페이지 크기(기본 100, 최대 100) |
|
|
478
|
+
| `maxPages` | `number` | 창당 최대 페이지(기본 10, 최대 50) |
|
|
479
|
+
|
|
480
|
+
### `search_openings`
|
|
481
|
+
|
|
482
|
+
나라장터 개찰결과 목록을 검색하고 진행상태(개찰완료/유찰/재입찰)로 필터한다. 유찰·재입찰 공고 발굴에 쓴다. `status`는 API 파라미터가 아니라 응답 기준 클라이언트 필터라 응답이 느리니 기관·업종·기간으로 좁혀 쓴다(`truncated: true`면 미완 스캔). 재입찰은 동일 공고 내 재입찰이며 재공고가 아니다(재공고는 입찰공고 서비스 소관). 최종낙찰자 검색은 `search_awards`, 단일 공고 상세는 `get_bid_result`를 쓴다.
|
|
483
|
+
|
|
484
|
+
| 파라미터 | 타입 | 설명 |
|
|
485
|
+
|---|---|---|
|
|
486
|
+
| `bidKind` | `string[]` | 업무구분 배열. 미지정 시 전 구분 병렬 |
|
|
487
|
+
| `keyword` | `string` | 공고명(`bidNtceNm`) |
|
|
488
|
+
| `institution` | `string` | 공고기관명 |
|
|
489
|
+
| `demandInstitution` | `string` | 수요기관명(`dminsttNm`) |
|
|
490
|
+
| `region` | `string` | 참가제한지역명(`prtcptLmtRgnNm`, 예: 인천광역시) |
|
|
491
|
+
| `industry` | `string` | 업종명(`indstrytyNm`) |
|
|
492
|
+
| `status` | `string` | 진행상태 필터: `개찰완료` `유찰` `재입찰`(응답 `progrsDivCdNm` 기준 클라이언트 필터) |
|
|
493
|
+
| `startDate` | `string` | 조회 시작일 `YYYYMMDD`(`endDate`와 함께 지정) |
|
|
494
|
+
| `endDate` | `string` | 조회 종료일 `YYYYMMDD`(`startDate`와 함께 지정) |
|
|
495
|
+
| `dateType` | `string` | 날짜 기준: `posted`(공고게시, 기본) `opened`(개찰) |
|
|
496
|
+
| `pageSize` | `number` | 창당 페이지 크기(기본 20, 개찰결과는 느려 작게 권장) |
|
|
497
|
+
| `maxPages` | `number` | 창당 최대 페이지(기본 5) |
|
|
498
|
+
|
|
499
|
+
> 개찰결과 조회는 응답이 느리다(라이브 기준 20행 0.6초, 50행 9초, 100행은 타임아웃). 페이지 크기를 작게 유지하고 검색조건을 좁혀 쓴다.
|
|
500
|
+
|
|
501
|
+
### `get_bid_result`
|
|
502
|
+
|
|
503
|
+
입찰공고번호로 그 공고의 낙찰자·개찰진행·예비가격상세(사정률)·투찰업체별 순위/금액/점수를 복합키(공고번호+차수+분류+재입찰번호) 정합으로 단건 조회한다. 딜 사후분석·투찰가 참고에 쓴다. 다분류·다차수 공고는 집행 단위 배열로 분리한다. 낙찰방식은 추정이며(협상계약만 기술·가격 점수 제공, 적격심사는 금액·순위만), `myBizno`를 주면 자사 투찰행에 `isOurs`를 표시한다. 여러 공고를 조건으로 찾으려면 `search_awards` 또는 `search_openings`를 쓴다.
|
|
504
|
+
|
|
505
|
+
| 파라미터 | 타입 | 설명 |
|
|
506
|
+
|---|---|---|
|
|
507
|
+
| `bidNtceNo` | `string` | 입찰공고번호(필수) |
|
|
508
|
+
| `bidKind` | `string` | 업무구분. 미지정 시 A/B/C를 전 구분에서 조회 |
|
|
509
|
+
| `status` | `string` | D(투찰업체별) 상태: `completed` `failing` `rebid` `all`(기본, 완료·유찰·재입찰 병렬) |
|
|
510
|
+
| `bidNtceOrd` | `string` | 입찰공고차수. 특정 집행으로 좁힘 |
|
|
511
|
+
| `bidClsfcNo` | `string` | 입찰분류번호. 특정 집행으로 좁힘 |
|
|
512
|
+
| `rbidNo` | `string` | 재입찰번호. 특정 집행으로 좁힘 |
|
|
513
|
+
| `myBizno` | `string` | 자사 사업자번호. 일치하는 투찰행에 `isOurs` 플래그 |
|
|
514
|
+
|
|
515
|
+
모든 도구의 반환은 `search_awards`/`search_openings`가 `{ query, results }`(업무구분별로 `{ totalCount, items }` 또는 실패 시 `{ error }`), `get_bid_result`가 `{ bidNtceNo, executions, errors, notes }`다.
|
|
516
|
+
|
|
517
|
+
## 응답 필드
|
|
518
|
+
|
|
519
|
+
### `AwardResult` (계열 A, 최종낙찰자)
|
|
520
|
+
|
|
521
|
+
`bidNtceNo`(입찰공고번호), `bidNtceNm`(공고명), `participants`(참가업체수), `winner`(낙찰자), `winnerBizno`(낙찰자 사업자번호), `winnerCeo`(낙찰자 대표자), `awardAmount`(낙찰금액), `awardRate`(낙찰률), `realOpeningDt`(실개찰일시), `demandInstitution`(수요기관), `finalAwardDate`(최종낙찰일자).
|
|
522
|
+
|
|
523
|
+
### `OpeningSummary` (계열 B, 개찰진행)
|
|
524
|
+
|
|
525
|
+
`bidNtceNo`, `bidNtceNm`, `openingDt`(개찰일시), `participants`(참가업체수), `progress`(진행상태: 개찰완료/유찰/재입찰), `topBidder`(1위 업체 `{ name, bizno, ceo, amount, rate }` 또는 `null`), `reservePriceFileExists`(예비가격 파일 존재 여부), `noticeInstitution`(공고기관), `demandInstitution`(수요기관), `failReasonHint`(유찰 시 참가업체수 기반 추정 사유, 선택).
|
|
526
|
+
|
|
527
|
+
### `PreparPriceDetail` (계열 C, 예비가격상세·집행 단위 집약)
|
|
528
|
+
|
|
529
|
+
`planPrice`(예정가격), `baseAmount`(기초금액), `saJeongRate`(사정률, 숫자 또는 `null`), `totalReserveCount`(총 복수예가수), `drawn`(추첨번호), `reserves`(복수예가 배열: `seq`·`basePlanPrice`).
|
|
530
|
+
|
|
531
|
+
### `BidderDetail` (계열 D, 투찰업체별)
|
|
532
|
+
|
|
533
|
+
`rank`(순위), `name`(업체명), `bizno`(사업자번호), `ceo`(대표자), `amount`(투찰금액), `rate`(투찰율), `remark`(비고), `priceScore`(가격점수), `techScore`(기술점수), `techRawScore`(기술평점), `totalScore`(합산점수), `bidDt`(투찰일시), `isOurs`(자사 여부, `myBizno` 일치 시 `true`).
|
|
534
|
+
|
|
535
|
+
## 개발
|
|
536
|
+
|
|
537
|
+
```bash
|
|
538
|
+
nvm use # Node 24
|
|
539
|
+
pnpm install
|
|
540
|
+
pnpm test # vitest
|
|
541
|
+
pnpm typecheck # tsc --noEmit
|
|
542
|
+
pnpm build # tsup, dist/ 생성
|
|
543
|
+
```
|
|
544
|
+
|
|
545
|
+
## 문제 해결
|
|
546
|
+
|
|
547
|
+
- **인증 오류(코드 30)**: Encoding 키를 넣으면 이중 인코딩으로 실패한다. **Decoding(원본)** 키를 쓴다. 서버가 시작 시 Encoding 키로 보이면 경고 로그를 남긴다.
|
|
548
|
+
- **개찰결과 조회가 느리거나 타임아웃**: `search_openings`는 응답이 무겁다. `pageSize`를 기본값(20) 이하로 유지하고 기관·업종·기간으로 조건을 좁힌다. `truncated: true`가 보이면 스캔이 끝나지 않은 것이다.
|
|
549
|
+
- **결과코드 메시지**: 트래픽 초과, 인증키 만료 등 data.go.kr 결과코드는 한국어 메시지로 정규화되어 반환된다.
|
|
550
|
+
- **도구 동작 점검**: MCP inspector로 직접 호출해 볼 수 있다.
|
|
551
|
+
|
|
552
|
+
```bash
|
|
553
|
+
npx @modelcontextprotocol/inspector npx -y @opendata-kr/narajangteo-opening-mcp
|
|
554
|
+
```
|
|
555
|
+
|
|
556
|
+
## 라이선스
|
|
557
|
+
|
|
558
|
+
[MIT](./LICENSE)
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,443 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
// src/index.ts
|
|
4
|
+
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
5
|
+
|
|
6
|
+
// src/api/gateway.ts
|
|
7
|
+
import { createClient } from "@opendata-kr/core";
|
|
8
|
+
var SERVICE_PATH = "/1230000/as/ScsbidInfoService";
|
|
9
|
+
function createGateway() {
|
|
10
|
+
return createClient({ path: SERVICE_PATH, params: { type: "json" }, timeout: 3e4 });
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
// src/server.ts
|
|
14
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
15
|
+
|
|
16
|
+
// src/version.ts
|
|
17
|
+
var VERSION = "0.1.0";
|
|
18
|
+
|
|
19
|
+
// src/tools/searchAwards.ts
|
|
20
|
+
import { z } from "zod";
|
|
21
|
+
|
|
22
|
+
// src/api/endpoints.ts
|
|
23
|
+
var ALL_BID_KINDS = ["cnstwk", "servc", "thng", "frgcpt"];
|
|
24
|
+
var SUFFIX = {
|
|
25
|
+
cnstwk: "Cnstwk",
|
|
26
|
+
servc: "Servc",
|
|
27
|
+
thng: "Thng",
|
|
28
|
+
frgcpt: "Frgcpt"
|
|
29
|
+
};
|
|
30
|
+
var awardListOp = (k) => `getScsbidListSttus${SUFFIX[k]}`;
|
|
31
|
+
var awardSearchOp = (k) => `getScsbidListSttus${SUFFIX[k]}PPSSrch`;
|
|
32
|
+
var openingListOp = (k) => `getOpengResultListInfo${SUFFIX[k]}`;
|
|
33
|
+
var openingSearchOp = (k) => `getOpengResultListInfo${SUFFIX[k]}PPSSrch`;
|
|
34
|
+
var preparPriceOp = (k) => `getOpengResultListInfo${SUFFIX[k]}PreparPcDetail`;
|
|
35
|
+
var ALL_OPENING_STATUS = ["completed", "failing", "rebid"];
|
|
36
|
+
var D_OPERATION = {
|
|
37
|
+
completed: "getOpengResultListInfoOpengCompt",
|
|
38
|
+
failing: "getOpengResultListInfoFailing",
|
|
39
|
+
rebid: "getOpengResultListInfoRebid"
|
|
40
|
+
};
|
|
41
|
+
function awardInqryDiv(dateType, ppsSrch) {
|
|
42
|
+
if (ppsSrch) return dateType === "notice" ? "3" : dateType === "opened" ? "2" : "1";
|
|
43
|
+
return dateType === "notice" ? "4" : dateType === "opened" ? "3" : "2";
|
|
44
|
+
}
|
|
45
|
+
function openingInqryDiv(dateType, ppsSrch) {
|
|
46
|
+
if (ppsSrch) return dateType === "notice" ? "3" : dateType === "opened" ? "2" : "1";
|
|
47
|
+
return dateType === "notice" ? "4" : dateType === "opened" ? "3" : "2";
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
// src/api/dateWindow.ts
|
|
51
|
+
var MAX_WINDOW_DAYS = 31;
|
|
52
|
+
function toDate(yyyymmdd) {
|
|
53
|
+
const y = Number(yyyymmdd.slice(0, 4)), m = Number(yyyymmdd.slice(4, 6)), d = Number(yyyymmdd.slice(6, 8));
|
|
54
|
+
return new Date(Date.UTC(y, m - 1, d));
|
|
55
|
+
}
|
|
56
|
+
function fmt(dt) {
|
|
57
|
+
const y = dt.getUTCFullYear(), m = String(dt.getUTCMonth() + 1).padStart(2, "0"), d = String(dt.getUTCDate()).padStart(2, "0");
|
|
58
|
+
return `${y}${m}${d}`;
|
|
59
|
+
}
|
|
60
|
+
function splitDateWindows(start, end, maxDays) {
|
|
61
|
+
const windows = [];
|
|
62
|
+
let cur = toDate(start);
|
|
63
|
+
const last = toDate(end);
|
|
64
|
+
while (cur <= last) {
|
|
65
|
+
const winEnd = new Date(cur);
|
|
66
|
+
winEnd.setUTCDate(winEnd.getUTCDate() + maxDays - 1);
|
|
67
|
+
const eff = winEnd > last ? last : winEnd;
|
|
68
|
+
windows.push({ bgn: `${fmt(cur)}0000`, end: `${fmt(eff)}2359` });
|
|
69
|
+
cur = new Date(eff);
|
|
70
|
+
cur.setUTCDate(cur.getUTCDate() + 1);
|
|
71
|
+
}
|
|
72
|
+
return windows;
|
|
73
|
+
}
|
|
74
|
+
async function fetchAllPages(call, op, params, opts) {
|
|
75
|
+
const items = [];
|
|
76
|
+
let totalCount = 0;
|
|
77
|
+
let page = 1;
|
|
78
|
+
for (; page <= opts.maxPages; page++) {
|
|
79
|
+
const r = await call(op, { ...params, pageNo: page, numOfRows: opts.pageSize });
|
|
80
|
+
totalCount = r.totalCount;
|
|
81
|
+
items.push(...r.items);
|
|
82
|
+
if (items.length >= totalCount || r.items.length === 0) {
|
|
83
|
+
return { totalCount, items, truncated: false };
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
return { totalCount, items, truncated: true };
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
// src/format.ts
|
|
90
|
+
var pick = (raw, k) => raw[k] ?? "";
|
|
91
|
+
function compositeKeyOf(raw) {
|
|
92
|
+
const g = (k) => raw[k] ?? "";
|
|
93
|
+
return `${g("bidNtceNo")}|${g("bidNtceOrd")}|${g("bidClsfcNo")}|${g("rbidNo")}`;
|
|
94
|
+
}
|
|
95
|
+
function parseOpengCorpInfo(s) {
|
|
96
|
+
if (!s) return null;
|
|
97
|
+
const [name = "", bizno = "", ceo = "", amount = "", rate = ""] = s.split("^");
|
|
98
|
+
return { name, bizno, ceo, amount, rate };
|
|
99
|
+
}
|
|
100
|
+
function formatAward(raw) {
|
|
101
|
+
return {
|
|
102
|
+
bidNtceNo: pick(raw, "bidNtceNo"),
|
|
103
|
+
bidNtceNm: pick(raw, "bidNtceNm"),
|
|
104
|
+
participants: pick(raw, "prtcptCnum"),
|
|
105
|
+
winner: pick(raw, "bidwinnrNm"),
|
|
106
|
+
winnerBizno: pick(raw, "bidwinnrBizno"),
|
|
107
|
+
winnerCeo: pick(raw, "bidwinnrCeoNm"),
|
|
108
|
+
awardAmount: pick(raw, "sucsfbidAmt"),
|
|
109
|
+
awardRate: pick(raw, "sucsfbidRate"),
|
|
110
|
+
realOpeningDt: pick(raw, "rlOpengDt"),
|
|
111
|
+
demandInstitution: pick(raw, "dminsttNm"),
|
|
112
|
+
finalAwardDate: pick(raw, "fnlSucsfDate")
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
function formatOpening(raw) {
|
|
116
|
+
return {
|
|
117
|
+
bidNtceNo: pick(raw, "bidNtceNo"),
|
|
118
|
+
bidNtceNm: pick(raw, "bidNtceNm"),
|
|
119
|
+
openingDt: pick(raw, "opengDt"),
|
|
120
|
+
participants: pick(raw, "prtcptCnum"),
|
|
121
|
+
progress: pick(raw, "progrsDivCdNm"),
|
|
122
|
+
topBidder: parseOpengCorpInfo(pick(raw, "opengCorpInfo")),
|
|
123
|
+
reservePriceFileExists: pick(raw, "rsrvtnPrceFileExistnceYn"),
|
|
124
|
+
noticeInstitution: pick(raw, "ntceInsttNm"),
|
|
125
|
+
demandInstitution: pick(raw, "dminsttNm")
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
function formatBidder(raw) {
|
|
129
|
+
return {
|
|
130
|
+
rank: pick(raw, "opengRank"),
|
|
131
|
+
name: pick(raw, "prcbdrNm"),
|
|
132
|
+
bizno: pick(raw, "prcbdrBizno"),
|
|
133
|
+
ceo: pick(raw, "prcbdrCeoNm"),
|
|
134
|
+
amount: pick(raw, "bidprcAmt"),
|
|
135
|
+
rate: pick(raw, "bidprcrt"),
|
|
136
|
+
remark: pick(raw, "rmrk"),
|
|
137
|
+
priceScore: pick(raw, "bidPrceEvlVal"),
|
|
138
|
+
techScore: pick(raw, "techEvlVal"),
|
|
139
|
+
techRawScore: pick(raw, "techEvlNaturVal"),
|
|
140
|
+
totalScore: pick(raw, "totalEvlAmtVal"),
|
|
141
|
+
bidDt: pick(raw, "bidprcDt")
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
function aggregatePreparPrice(items) {
|
|
145
|
+
const first = items[0];
|
|
146
|
+
const planPrice = first ? pick(first, "plnprc") : "";
|
|
147
|
+
const baseAmount = first ? pick(first, "bssamt") : "";
|
|
148
|
+
const p = Number(planPrice), b = Number(baseAmount);
|
|
149
|
+
const saJeongRate = first && b > 0 && Number.isFinite(p) && Number.isFinite(b) ? p / b : null;
|
|
150
|
+
return {
|
|
151
|
+
planPrice,
|
|
152
|
+
baseAmount,
|
|
153
|
+
saJeongRate,
|
|
154
|
+
totalReserveCount: first ? pick(first, "totRsrvtnPrceNum") : "",
|
|
155
|
+
drawn: first ? pick(first, "drwtYn") : "",
|
|
156
|
+
reserves: items.map((r) => ({ seq: pick(r, "compnoRsrvtnPrceSno"), basePlanPrice: pick(r, "bsisPlnprc") }))
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
function failReasonHint(participants) {
|
|
160
|
+
const n = Number(participants);
|
|
161
|
+
if (n === 0) return "\uBB34\uC751\uCC30 \uCD94\uC815(\uCC38\uAC00 0). \uC7AC\uB3C4\uC804 \uAE30\uD68C\uC77C \uC218 \uC788\uC74C";
|
|
162
|
+
if (n === 1) return "\uB2E8\uB3C5\uC751\uCC30 \uCD94\uC815(\uCC38\uAC00 1). \uC218\uC758\uACC4\uC57D \uC9C1\uD589 \uAC00\uB2A5, \uAE30\uD68C \uB0AE\uC74C";
|
|
163
|
+
return "\uC801\uACA9\uC790 \uC5C6\uC74C \uB4F1 \uCD94\uC815(\uCC38\uAC00 2+). \uC7AC\uB3C4\uC804 \uAE30\uD68C\uC77C \uC218 \uC788\uC74C";
|
|
164
|
+
}
|
|
165
|
+
function estimateAwardMethod(bidders) {
|
|
166
|
+
const scored = bidders.some((b) => b.totalScore && b.totalScore !== "" || b.techScore && b.techScore !== "");
|
|
167
|
+
return { method: scored ? "negotiated" : "qualification_or_other", uncertain: true };
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
// src/tools/searchAwards.ts
|
|
171
|
+
var searchAwardsInputShape = {
|
|
172
|
+
bidKind: z.array(z.enum(["cnstwk", "servc", "thng", "frgcpt"])).optional().describe("\uC5C5\uBB34\uAD6C\uBD84 \uBC30\uC5F4. \uBBF8\uC9C0\uC815 \uC2DC \uC804 \uAD6C\uBD84 \uBCD1\uB82C"),
|
|
173
|
+
keyword: z.string().optional().describe("\uACF5\uACE0\uBA85 \uBD80\uBD84\uAC80\uC0C9(bidNtceNm)"),
|
|
174
|
+
institution: z.string().optional().describe("\uACF5\uACE0\uAE30\uAD00\uBA85(ntceInsttNm)"),
|
|
175
|
+
demandInstitution: z.string().optional().describe("\uC218\uC694\uAE30\uAD00\uBA85(dminsttNm)"),
|
|
176
|
+
demandInstitutionCode: z.string().optional().describe("\uC218\uC694\uAE30\uAD00\uCF54\uB4DC(dminsttCd). \uC885\uB2E8 \uC2DD\uBCC4\uC5D0 \uC548\uC815\uC801"),
|
|
177
|
+
detailProductCode: z.string().optional().describe("\uC138\uBD80\uD488\uBA85\uBC88\uD638(dtilPrdctClsfcNo)"),
|
|
178
|
+
region: z.string().optional().describe("\uCC38\uAC00\uC81C\uD55C\uC9C0\uC5ED\uBA85(prtcptLmtRgnNm)"),
|
|
179
|
+
industry: z.string().optional().describe("\uC5C5\uC885\uBA85(indstrytyNm)"),
|
|
180
|
+
minPrice: z.number().optional().describe("\uCD94\uC815\uAC00\uACA9 \uD558\uD55C(presmptPrceBgn)"),
|
|
181
|
+
maxPrice: z.number().optional().describe("\uCD94\uC815\uAC00\uACA9 \uC0C1\uD55C(presmptPrceEnd)"),
|
|
182
|
+
bizno: z.string().optional().describe("\uC5C5\uCCB4 \uC0AC\uC5C5\uC790\uBC88\uD638. \uADF8 \uC5C5\uCCB4\uC758 \uB099\uCC30\uAC74\uB9CC \uC870\uD68C(\uC9C4 \uC785\uCC30\uC740 \uBBF8\uD3EC\uD568)"),
|
|
183
|
+
startDate: z.string().optional().describe("\uC870\uD68C \uC2DC\uC791\uC77C YYYYMMDD"),
|
|
184
|
+
endDate: z.string().optional().describe("\uC870\uD68C \uC885\uB8CC\uC77C YYYYMMDD"),
|
|
185
|
+
dateType: z.enum(["posted", "opened"]).optional().describe("\uB0A0\uC9DC \uAE30\uC900. posted=\uACF5\uACE0\uAC8C\uC2DC(\uAE30\uBCF8), opened=\uAC1C\uCC30"),
|
|
186
|
+
pageSize: z.number().int().min(1).max(100).optional().describe("\uCC3D\uB2F9 \uD398\uC774\uC9C0 \uD06C\uAE30(\uAE30\uBCF8 100)"),
|
|
187
|
+
maxPages: z.number().int().min(1).max(50).optional().describe("\uCC3D\uB2F9 \uCD5C\uB300 \uD398\uC774\uC9C0(\uAE30\uBCF8 10)")
|
|
188
|
+
};
|
|
189
|
+
async function runSearchAwards(client, args) {
|
|
190
|
+
const kinds = args.bidKind ?? [...ALL_BID_KINDS];
|
|
191
|
+
const dateType = args.dateType ?? "posted";
|
|
192
|
+
const inqryDiv = awardInqryDiv(dateType, true);
|
|
193
|
+
const base = {
|
|
194
|
+
inqryDiv,
|
|
195
|
+
bidNtceNm: args.keyword,
|
|
196
|
+
ntceInsttNm: args.institution,
|
|
197
|
+
dminsttNm: args.demandInstitution,
|
|
198
|
+
dminsttCd: args.demandInstitutionCode,
|
|
199
|
+
dtilPrdctClsfcNo: args.detailProductCode,
|
|
200
|
+
prtcptLmtRgnNm: args.region,
|
|
201
|
+
indstrytyNm: args.industry,
|
|
202
|
+
presmptPrceBgn: args.minPrice,
|
|
203
|
+
presmptPrceEnd: args.maxPrice,
|
|
204
|
+
bizno: args.bizno
|
|
205
|
+
};
|
|
206
|
+
if (args.startDate && !args.endDate || !args.startDate && args.endDate) {
|
|
207
|
+
throw new Error("startDate\uC640 endDate\uB294 \uD568\uAED8 \uC9C0\uC815\uD574\uC57C \uD569\uB2C8\uB2E4.");
|
|
208
|
+
}
|
|
209
|
+
if (args.startDate && args.endDate && args.startDate > args.endDate) {
|
|
210
|
+
throw new Error("startDate\uAC00 endDate\uBCF4\uB2E4 \uB2A6\uC2B5\uB2C8\uB2E4.");
|
|
211
|
+
}
|
|
212
|
+
const windows = args.startDate && args.endDate ? splitDateWindows(args.startDate, args.endDate, MAX_WINDOW_DAYS) : [{ bgn: void 0, end: void 0 }];
|
|
213
|
+
const pageSize = args.pageSize ?? 100;
|
|
214
|
+
const maxPages = args.maxPages ?? 10;
|
|
215
|
+
const settled = await Promise.allSettled(kinds.map(async (kind) => {
|
|
216
|
+
const items = [];
|
|
217
|
+
let totalCount = 0, truncated = false;
|
|
218
|
+
for (const w of windows) {
|
|
219
|
+
const params = { ...base, inqryBgnDt: w.bgn, inqryEndDt: w.end };
|
|
220
|
+
const r = await fetchAllPages((op, p) => client.call(op, p), awardSearchOp(kind), params, { pageSize, maxPages });
|
|
221
|
+
items.push(...r.items.map(formatAward));
|
|
222
|
+
totalCount += r.totalCount;
|
|
223
|
+
truncated = truncated || r.truncated;
|
|
224
|
+
}
|
|
225
|
+
return { totalCount, items, truncated };
|
|
226
|
+
}));
|
|
227
|
+
const results = {};
|
|
228
|
+
kinds.forEach((kind, i) => {
|
|
229
|
+
const s = settled[i];
|
|
230
|
+
results[kind] = s.status === "fulfilled" ? s.value : { error: s.reason instanceof Error ? s.reason.message : String(s.reason) };
|
|
231
|
+
});
|
|
232
|
+
return {
|
|
233
|
+
query: args,
|
|
234
|
+
results,
|
|
235
|
+
notes: [
|
|
236
|
+
"\uB099\uCC30\uC790\uB9CC \uC870\uD68C\uD55C\uB2E4(\uADF8 \uC5C5\uCCB4\uAC00 \uCC38\uC5EC\uD588\uC73C\uB098 \uC9C4 \uC785\uCC30\uC740 \uC774 API\uB85C \uB3C4\uB2EC \uBD88\uAC00).",
|
|
237
|
+
"\uC5EC\uB7EC \uCC3D(\uC8FC \uB2E8\uC704 \uBD84\uD560)\uC758 totalCount \uD569\uC740 \uCC3D\uBCC4 \uD569\uACC4\uB2E4."
|
|
238
|
+
]
|
|
239
|
+
};
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
// src/tools/searchOpenings.ts
|
|
243
|
+
import { z as z2 } from "zod";
|
|
244
|
+
var searchOpeningsInputShape = {
|
|
245
|
+
bidKind: z2.array(z2.enum(["cnstwk", "servc", "thng", "frgcpt"])).optional().describe("\uC5C5\uBB34\uAD6C\uBD84 \uBC30\uC5F4(cnstwk=\uACF5\uC0AC\xB7servc=\uC6A9\uC5ED\xB7thng=\uBB3C\uD488\xB7frgcpt=\uC678\uC790). \uBBF8\uC9C0\uC815 \uC2DC \uC804 \uAD6C\uBD84 \uBCD1\uB82C"),
|
|
246
|
+
keyword: z2.string().optional().describe("\uACF5\uACE0\uBA85(bidNtceNm)"),
|
|
247
|
+
institution: z2.string().optional().describe("\uACF5\uACE0\uAE30\uAD00\uBA85"),
|
|
248
|
+
demandInstitution: z2.string().optional().describe("\uC218\uC694\uAE30\uAD00\uBA85(dminsttNm)"),
|
|
249
|
+
region: z2.string().optional().describe("\uCC38\uAC00\uC81C\uD55C\uC9C0\uC5ED\uBA85(prtcptLmtRgnNm, \uC608: \uC778\uCC9C\uAD11\uC5ED\uC2DC)"),
|
|
250
|
+
industry: z2.string().optional().describe("\uC5C5\uC885\uBA85(indstrytyNm)"),
|
|
251
|
+
status: z2.enum(["\uAC1C\uCC30\uC644\uB8CC", "\uC720\uCC30", "\uC7AC\uC785\uCC30"]).optional().describe("\uC9C4\uD589\uC0C1\uD0DC \uD544\uD130(\uC751\uB2F5 progrsDivCdNm \uAE30\uC900 \uD074\uB77C\uC774\uC5B8\uD2B8 \uD544\uD130)"),
|
|
252
|
+
startDate: z2.string().optional().describe("\uC870\uD68C \uC2DC\uC791\uC77C YYYYMMDD (endDate\uC640 \uD568\uAED8 \uC9C0\uC815)"),
|
|
253
|
+
endDate: z2.string().optional().describe("\uC870\uD68C \uC885\uB8CC\uC77C YYYYMMDD (startDate\uC640 \uD568\uAED8 \uC9C0\uC815)"),
|
|
254
|
+
dateType: z2.enum(["posted", "opened"]).optional().describe("\uB0A0\uC9DC \uAE30\uC900: posted=\uACF5\uACE0\uAC8C\uC2DC(\uAE30\uBCF8), opened=\uAC1C\uCC30"),
|
|
255
|
+
pageSize: z2.number().int().min(1).max(100).optional().describe("\uCC3D\uB2F9 \uD398\uC774\uC9C0 \uD06C\uAE30(\uAE30\uBCF8 20, \uAC1C\uCC30\uACB0\uACFC\uB294 \uB290\uB824 \uC791\uAC8C \uAD8C\uC7A5)"),
|
|
256
|
+
maxPages: z2.number().int().min(1).max(50).optional().describe("\uCC3D\uB2F9 \uCD5C\uB300 \uD398\uC774\uC9C0(\uAE30\uBCF8 5)")
|
|
257
|
+
};
|
|
258
|
+
async function runSearchOpenings(client, args) {
|
|
259
|
+
if (args.startDate && !args.endDate || !args.startDate && args.endDate) {
|
|
260
|
+
throw new Error("startDate\uC640 endDate\uB294 \uD568\uAED8 \uC9C0\uC815\uD574\uC57C \uD569\uB2C8\uB2E4.");
|
|
261
|
+
}
|
|
262
|
+
if (args.startDate && args.endDate && args.startDate > args.endDate) {
|
|
263
|
+
throw new Error("startDate\uAC00 endDate\uBCF4\uB2E4 \uB2A6\uC2B5\uB2C8\uB2E4.");
|
|
264
|
+
}
|
|
265
|
+
const kinds = args.bidKind ?? [...ALL_BID_KINDS];
|
|
266
|
+
const dateType = args.dateType ?? "posted";
|
|
267
|
+
const inqryDiv = openingInqryDiv(dateType, true);
|
|
268
|
+
const base = {
|
|
269
|
+
inqryDiv,
|
|
270
|
+
bidNtceNm: args.keyword,
|
|
271
|
+
ntceInsttNm: args.institution,
|
|
272
|
+
dminsttNm: args.demandInstitution,
|
|
273
|
+
prtcptLmtRgnNm: args.region,
|
|
274
|
+
indstrytyNm: args.industry
|
|
275
|
+
};
|
|
276
|
+
const windows = args.startDate && args.endDate ? splitDateWindows(args.startDate, args.endDate, MAX_WINDOW_DAYS) : [{ bgn: void 0, end: void 0 }];
|
|
277
|
+
const pageSize = args.pageSize ?? 20, maxPages = args.maxPages ?? 5;
|
|
278
|
+
const settled = await Promise.allSettled(kinds.map(async (kind) => {
|
|
279
|
+
const all = [];
|
|
280
|
+
let before = 0, truncated = false;
|
|
281
|
+
for (const w of windows) {
|
|
282
|
+
const r = await fetchAllPages((op, p) => client.call(op, p), openingSearchOp(kind), { ...base, inqryBgnDt: w.bgn, inqryEndDt: w.end }, { pageSize, maxPages });
|
|
283
|
+
before += r.totalCount;
|
|
284
|
+
truncated = truncated || r.truncated;
|
|
285
|
+
for (const raw of r.items) {
|
|
286
|
+
const o = formatOpening(raw);
|
|
287
|
+
if (o.progress === "\uC720\uCC30") o.failReasonHint = failReasonHint(o.participants);
|
|
288
|
+
all.push(o);
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
const items = args.status ? all.filter((o) => o.progress === args.status) : all;
|
|
292
|
+
return { totalCountBeforeFilter: before, filteredCount: items.length, items, truncated };
|
|
293
|
+
}));
|
|
294
|
+
const results = {};
|
|
295
|
+
kinds.forEach((kind, i) => {
|
|
296
|
+
const s = settled[i];
|
|
297
|
+
results[kind] = s.status === "fulfilled" ? s.value : { error: s.reason instanceof Error ? s.reason.message : String(s.reason) };
|
|
298
|
+
});
|
|
299
|
+
return {
|
|
300
|
+
query: args,
|
|
301
|
+
results,
|
|
302
|
+
notes: [
|
|
303
|
+
"status\uB294 \uC751\uB2F5 progrsDivCdNm \uAE30\uC900 \uD074\uB77C\uC774\uC5B8\uD2B8 \uD544\uD130\uB2E4(API \uC694\uCCAD \uD30C\uB77C\uBBF8\uD130 \uC544\uB2D8). totalCountBeforeFilter\uB294 \uD544\uD130 \uC804 \uAC12.",
|
|
304
|
+
"\uC7AC\uC785\uCC30\uC740 \uB3D9\uC77C \uACF5\uACE0 \uB0B4 \uC7AC\uC785\uCC30\uC774\uBA70 \uC7AC\uACF5\uACE0\uAC00 \uC544\uB2C8\uB2E4(\uC7AC\uACF5\uACE0\uB294 \uC785\uCC30\uACF5\uACE0 \uC11C\uBE44\uC2A4 \uC18C\uAD00).",
|
|
305
|
+
"\uAC1C\uCC30\uACB0\uACFC \uC870\uD68C\uB294 \uC751\uB2F5\uC774 \uB290\uB9AC\uB2E4. \uD398\uC774\uC9C0 \uD06C\uAE30\uB97C \uC791\uAC8C(\uAE30\uBCF8 20) \uC720\uC9C0\uD558\uACE0 \uAC80\uC0C9\uC870\uAC74(\uAE30\uAD00\xB7\uC5C5\uC885\xB7\uAE30\uAC04)\uC744 \uC881\uD600 \uC4F4\uB2E4."
|
|
306
|
+
]
|
|
307
|
+
};
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
// src/tools/getBidResult.ts
|
|
311
|
+
import { z as z3 } from "zod";
|
|
312
|
+
var getBidResultInputShape = {
|
|
313
|
+
bidNtceNo: z3.string().describe("\uC785\uCC30\uACF5\uACE0\uBC88\uD638"),
|
|
314
|
+
bidKind: z3.enum(["cnstwk", "servc", "thng", "frgcpt"]).optional().describe("\uC5C5\uBB34\uAD6C\uBD84. \uBBF8\uC9C0\uC815 \uC2DC A/B/C\uB97C \uC804 \uAD6C\uBD84\uC5D0\uC11C \uC870\uD68C"),
|
|
315
|
+
status: z3.enum(["completed", "failing", "rebid", "all"]).optional().describe("D \uC0C1\uD0DC(\uAE30\uBCF8 all: \uC644\uB8CC\xB7\uC720\uCC30\xB7\uC7AC\uC785\uCC30 \uBCD1\uB82C)"),
|
|
316
|
+
bidNtceOrd: z3.string().optional().describe("\uC785\uCC30\uACF5\uACE0\uCC28\uC218. \uD2B9\uC815 \uC9D1\uD589\uC73C\uB85C \uC881\uD798"),
|
|
317
|
+
bidClsfcNo: z3.string().optional().describe("\uC785\uCC30\uBD84\uB958\uBC88\uD638. \uD2B9\uC815 \uC9D1\uD589\uC73C\uB85C \uC881\uD798"),
|
|
318
|
+
rbidNo: z3.string().optional().describe("\uC7AC\uC785\uCC30\uBC88\uD638. \uD2B9\uC815 \uC9D1\uD589\uC73C\uB85C \uC881\uD798"),
|
|
319
|
+
myBizno: z3.string().optional().describe("\uC790\uC0AC \uC0AC\uC5C5\uC790\uBC88\uD638. \uC77C\uCE58\uD558\uB294 \uD22C\uCC30\uD589\uC5D0 isOurs \uD50C\uB798\uADF8")
|
|
320
|
+
};
|
|
321
|
+
async function safeItems(client, op, params, errors) {
|
|
322
|
+
try {
|
|
323
|
+
return (await client.call(op, { ...params, pageNo: 1, numOfRows: 100 })).items;
|
|
324
|
+
} catch (e) {
|
|
325
|
+
errors.push(`${op}: ${e instanceof Error ? e.message : String(e)}`);
|
|
326
|
+
return [];
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
async function runGetBidResult(client, args) {
|
|
330
|
+
const errors = [];
|
|
331
|
+
const kinds = args.bidKind ? [args.bidKind] : [...ALL_BID_KINDS];
|
|
332
|
+
const statuses = !args.status || args.status === "all" ? [...ALL_OPENING_STATUS] : [args.status];
|
|
333
|
+
const no = args.bidNtceNo;
|
|
334
|
+
const aRaw = [], bRaw = [], cRaw = [], dRaw = [];
|
|
335
|
+
await Promise.all([
|
|
336
|
+
...kinds.map(async (k) => {
|
|
337
|
+
aRaw.push(...await safeItems(client, awardListOp(k), { inqryDiv: awardInqryDiv("notice", false), bidNtceNo: no }, errors));
|
|
338
|
+
}),
|
|
339
|
+
...kinds.map(async (k) => {
|
|
340
|
+
bRaw.push(...await safeItems(client, openingListOp(k), { inqryDiv: openingInqryDiv("notice", false), bidNtceNo: no }, errors));
|
|
341
|
+
}),
|
|
342
|
+
...kinds.map(async (k) => {
|
|
343
|
+
cRaw.push(...await safeItems(client, preparPriceOp(k), { inqryDiv: "2", bidNtceNo: no }, errors));
|
|
344
|
+
}),
|
|
345
|
+
...statuses.map(async (s) => {
|
|
346
|
+
dRaw.push(...await safeItems(client, D_OPERATION[s], { bidNtceNo: no }, errors));
|
|
347
|
+
})
|
|
348
|
+
]);
|
|
349
|
+
const keys = /* @__PURE__ */ new Set();
|
|
350
|
+
for (const r of [...aRaw, ...bRaw, ...cRaw, ...dRaw]) keys.add(compositeKeyOf(r));
|
|
351
|
+
const executions = [...keys].map((key) => {
|
|
352
|
+
const match = (r) => compositeKeyOf(r) === key;
|
|
353
|
+
const [, ord = "", clsfc = "", rbid = ""] = key.split("|");
|
|
354
|
+
const a = aRaw.find(match), b = bRaw.find(match);
|
|
355
|
+
const cItems = cRaw.filter(match), dItems = dRaw.filter(match);
|
|
356
|
+
const bidders = dItems.map(formatBidder).map((b2) => args.myBizno && b2.bizno === args.myBizno ? { ...b2, isOurs: true } : b2);
|
|
357
|
+
return {
|
|
358
|
+
bidNtceOrd: ord,
|
|
359
|
+
bidClsfcNo: clsfc,
|
|
360
|
+
rbidNo: rbid,
|
|
361
|
+
awardMethod: estimateAwardMethod(bidders),
|
|
362
|
+
award: a ? formatAward(a) : null,
|
|
363
|
+
opening: b ? formatOpening(b) : null,
|
|
364
|
+
preparPrice: cItems.length ? aggregatePreparPrice(cItems) : null,
|
|
365
|
+
bidders
|
|
366
|
+
};
|
|
367
|
+
});
|
|
368
|
+
let filtered = executions;
|
|
369
|
+
if (args.bidNtceOrd !== void 0 || args.bidClsfcNo !== void 0 || args.rbidNo !== void 0) {
|
|
370
|
+
filtered = executions.filter((e) => (args.bidNtceOrd === void 0 || e.bidNtceOrd === args.bidNtceOrd) && (args.bidClsfcNo === void 0 || e.bidClsfcNo === args.bidClsfcNo) && (args.rbidNo === void 0 || e.rbidNo === args.rbidNo));
|
|
371
|
+
}
|
|
372
|
+
return {
|
|
373
|
+
bidNtceNo: no,
|
|
374
|
+
executions: filtered,
|
|
375
|
+
errors,
|
|
376
|
+
notes: [
|
|
377
|
+
"A/B/C/D\uB97C \uBCF5\uD569\uD0A4(\uACF5\uACE0\uBC88\uD638+\uCC28\uC218+\uBD84\uB958+\uC7AC\uC785\uCC30\uBC88\uD638)\uB85C \uC870\uC778\uD55C\uB2E4. \uB2E4\uBD84\uB958\xB7\uB2E4\uCC28\uC218\uB294 \uC9D1\uD589 \uB2E8\uC704\uB85C \uBD84\uB9AC\uB41C\uB2E4.",
|
|
378
|
+
"\uB099\uCC30\uBC29\uC2DD \uAD6C\uBD84 \uD544\uB4DC\uAC00 API\uC5D0 \uC5C6\uC5B4 \uC810\uC218 \uCC44\uC6C0\uC73C\uB85C \uCD94\uC815\uD55C\uB2E4(uncertain). \uD611\uC0C1\uACC4\uC57D\uC774 \uC544\uB2C8\uBA74 \uC138\uBD80\uC2EC\uC0AC\uC810\uC218\uB294 \uC81C\uACF5\uB418\uC9C0 \uC54A\uB294\uB2E4."
|
|
379
|
+
]
|
|
380
|
+
};
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
// src/server.ts
|
|
384
|
+
function textResult(payload, isError = false) {
|
|
385
|
+
return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }], ...isError ? { isError: true } : {} };
|
|
386
|
+
}
|
|
387
|
+
function createServer(client) {
|
|
388
|
+
const server = new McpServer({ name: "narajangteo-opening-mcp", version: VERSION });
|
|
389
|
+
server.registerTool("search_awards", {
|
|
390
|
+
title: "\uB099\uCC30 \uACB0\uACFC \uAC80\uC0C9",
|
|
391
|
+
description: "\uB098\uB77C\uC7A5\uD130 \uB099\uCC30 \uACB0\uACFC(\uCD5C\uC885\uB099\uCC30\uC790)\uB97C \uACF5\uACE0\uBA85\xB7\uAE30\uAD00\xB7\uC218\uC694\uAE30\uAD00(\uCF54\uB4DC)\xB7\uC9C0\uC5ED\xB7\uC5C5\uC885\xB7\uCD94\uC815\uAC00\xB7\uC0AC\uC5C5\uC790\uBC88\uD638\xB7\uAE30\uAC04\uC73C\uB85C \uAC80\uC0C9\uD55C\uB2E4. '\uB204\uAC00 \uC5BC\uB9C8\uC5D0 \uB099\uCC30\uBC1B\uC558\uB098', \uACBD\uC7C1\uC0AC(bizno) \uB099\uCC30 \uC774\uB825, \uB418\uD480\uC774 \uC0AC\uC5C5\uC758 \uC885\uB2E8 \uC870\uD68C\uC5D0 \uC4F4\uB2E4. \uD2B9\uC815 \uACF5\uACE0\uC758 \uAC1C\uCC30\xB7\uD22C\uCC30\uC5C5\uCCB4\xB7\uC608\uBE44\uAC00 \uC0C1\uC138\uB294 get_bid_result, \uAC1C\uCC30 \uC9C4\uD589\xB7\uC720\uCC30 \uBC1C\uAD74\uC740 search_openings\uB97C \uC4F4\uB2E4. \uC5C5\uBB34\uAD6C\uBD84 \uBBF8\uC9C0\uC815 \uC2DC \uBB3C\uD488/\uACF5\uC0AC/\uC6A9\uC5ED/\uC678\uC790\uB97C \uBCD1\uB82C \uC870\uD68C\uD55C\uB2E4. \uB099\uCC30\uC790\uB9CC \uBC18\uD658\uD558\uBA70 \uADF8 \uC5C5\uCCB4\uAC00 \uCC38\uC5EC\uD588\uC73C\uB098 \uC9C4 \uC785\uCC30\uC740 \uBBF8\uD3EC\uD568.",
|
|
392
|
+
inputSchema: searchAwardsInputShape,
|
|
393
|
+
annotations: { readOnlyHint: true, openWorldHint: true }
|
|
394
|
+
}, async (args) => {
|
|
395
|
+
try {
|
|
396
|
+
return textResult(await runSearchAwards(client, args));
|
|
397
|
+
} catch (e) {
|
|
398
|
+
return textResult({ error: e instanceof Error ? e.message : String(e) }, true);
|
|
399
|
+
}
|
|
400
|
+
});
|
|
401
|
+
server.registerTool("search_openings", {
|
|
402
|
+
title: "\uAC1C\uCC30\uACB0\uACFC \uAC80\uC0C9",
|
|
403
|
+
description: "\uB098\uB77C\uC7A5\uD130 \uAC1C\uCC30\uACB0\uACFC \uBAA9\uB85D\uC744 \uAC80\uC0C9\uD558\uACE0 \uC9C4\uD589\uC0C1\uD0DC(\uAC1C\uCC30\uC644\uB8CC/\uC720\uCC30/\uC7AC\uC785\uCC30)\uB85C \uD544\uD130\uD55C\uB2E4. \uC720\uCC30\xB7\uC7AC\uC785\uCC30 \uACF5\uACE0 \uBC1C\uAD74\uC5D0 \uC4F4\uB2E4. \uCD5C\uC885\uB099\uCC30\uC790 \uAC80\uC0C9\uC740 search_awards, \uB2E8\uC77C \uACF5\uACE0 \uC0C1\uC138\uB294 get_bid_result\uB97C \uC4F4\uB2E4. status\uB294 API\uAC00 \uC544\uB2C8\uB77C \uC751\uB2F5 \uAE30\uC900 \uD074\uB77C\uC774\uC5B8\uD2B8 \uD544\uD130\uB77C \uC751\uB2F5\uC774 \uB290\uB9AC\uB2C8 \uAE30\uAD00\xB7\uC5C5\uC885\xB7\uAE30\uAC04\uC73C\uB85C \uC881\uD600 \uC4F4\uB2E4(truncated=true\uBA74 \uBBF8\uC644 \uC2A4\uCE94). \uC7AC\uC785\uCC30\uC740 \uB3D9\uC77C \uACF5\uACE0 \uB0B4 \uC7AC\uC785\uCC30\uC774\uBA70 \uC7AC\uACF5\uACE0\uAC00 \uC544\uB2C8\uB2E4(\uC7AC\uACF5\uACE0\uB294 \uC785\uCC30\uACF5\uACE0 \uC11C\uBE44\uC2A4 \uC18C\uAD00).",
|
|
404
|
+
inputSchema: searchOpeningsInputShape,
|
|
405
|
+
annotations: { readOnlyHint: true, openWorldHint: true }
|
|
406
|
+
}, async (args) => {
|
|
407
|
+
try {
|
|
408
|
+
return textResult(await runSearchOpenings(client, args));
|
|
409
|
+
} catch (e) {
|
|
410
|
+
return textResult({ error: e instanceof Error ? e.message : String(e) }, true);
|
|
411
|
+
}
|
|
412
|
+
});
|
|
413
|
+
server.registerTool("get_bid_result", {
|
|
414
|
+
title: "\uACF5\uACE0 \uAC1C\uCC30 \uC0C1\uC138",
|
|
415
|
+
description: "\uC785\uCC30\uACF5\uACE0\uBC88\uD638\uB85C \uADF8 \uACF5\uACE0\uC758 \uB099\uCC30\uC790\xB7\uAC1C\uCC30\uC9C4\uD589\xB7\uC608\uBE44\uAC00\uACA9\uC0C1\uC138(\uC0AC\uC815\uB960)\xB7\uD22C\uCC30\uC5C5\uCCB4\uBCC4 \uC21C\uC704/\uAE08\uC561/\uC810\uC218\uB97C \uBCF5\uD569\uD0A4 \uC815\uD569\uC73C\uB85C \uB2E8\uAC74 \uC870\uD68C\uD55C\uB2E4. \uB51C \uC0AC\uD6C4\uBD84\uC11D\xB7\uD22C\uCC30\uAC00 \uCC38\uACE0\uC5D0 \uC4F4\uB2E4. \uC5EC\uB7EC \uACF5\uACE0\uB97C \uC870\uAC74\uC73C\uB85C \uCC3E\uC73C\uB824\uBA74 search_awards \uB610\uB294 search_openings\uB97C \uC4F4\uB2E4. \uB2E4\uBD84\uB958\xB7\uB2E4\uCC28\uC218 \uACF5\uACE0\uB294 \uC9D1\uD589 \uB2E8\uC704 \uBC30\uC5F4\uB85C \uBD84\uB9AC\uD55C\uB2E4. \uB099\uCC30\uBC29\uC2DD\uC740 \uCD94\uC815\uC774\uBA70(\uD611\uC0C1\uACC4\uC57D\uB9CC \uAE30\uC220\xB7\uAC00\uACA9 \uC810\uC218 \uC81C\uACF5, \uC801\uACA9\uC2EC\uC0AC\uB294 \uAE08\uC561\xB7\uC21C\uC704\uB9CC), myBizno\uB97C \uC8FC\uBA74 \uC790\uC0AC \uD22C\uCC30\uD589\uC5D0 isOurs\uB97C \uD45C\uC2DC\uD55C\uB2E4.",
|
|
416
|
+
inputSchema: getBidResultInputShape,
|
|
417
|
+
annotations: { readOnlyHint: true, openWorldHint: true }
|
|
418
|
+
}, async (args) => {
|
|
419
|
+
try {
|
|
420
|
+
return textResult(await runGetBidResult(client, args));
|
|
421
|
+
} catch (e) {
|
|
422
|
+
return textResult({ error: e instanceof Error ? e.message : String(e) }, true);
|
|
423
|
+
}
|
|
424
|
+
});
|
|
425
|
+
return server;
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
// src/index.ts
|
|
429
|
+
async function main() {
|
|
430
|
+
const client = createGateway();
|
|
431
|
+
if (client.serviceKeyLooksPreEncoded) {
|
|
432
|
+
console.error(
|
|
433
|
+
"[narajangteo-opening-mcp] \uACBD\uACE0: DATA_GO_KR_SERVICE_KEY\uAC00 \uC774\uBBF8 URL \uC778\uCF54\uB529\uB41C \uD0A4\uB85C \uBCF4\uC785\uB2C8\uB2E4. Decoding(\uC6D0\uBCF8) \uD0A4\uB97C \uC0AC\uC6A9\uD558\uC138\uC694."
|
|
434
|
+
);
|
|
435
|
+
}
|
|
436
|
+
const server = createServer(client);
|
|
437
|
+
await server.connect(new StdioServerTransport());
|
|
438
|
+
}
|
|
439
|
+
main().catch((err) => {
|
|
440
|
+
console.error("[narajangteo-opening-mcp] fatal:", err);
|
|
441
|
+
process.exit(1);
|
|
442
|
+
});
|
|
443
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/api/gateway.ts","../src/server.ts","../src/version.ts","../src/tools/searchAwards.ts","../src/api/endpoints.ts","../src/api/dateWindow.ts","../src/format.ts","../src/tools/searchOpenings.ts","../src/tools/getBidResult.ts"],"sourcesContent":["import { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { createGateway } from \"./api/gateway.js\";\nimport { createServer } from \"./server.js\";\n\nasync function main(): Promise<void> {\n const client = createGateway();\n if (client.serviceKeyLooksPreEncoded) {\n console.error(\n \"[narajangteo-opening-mcp] 경고: DATA_GO_KR_SERVICE_KEY가 이미 URL 인코딩된 키로 보입니다. Decoding(원본) 키를 사용하세요.\",\n );\n }\n const server = createServer(client);\n await server.connect(new StdioServerTransport());\n}\n\nmain().catch((err: unknown) => {\n console.error(\"[narajangteo-opening-mcp] fatal:\", err);\n process.exit(1);\n});\n","import { createClient, type DataGoKrClient } from \"@opendata-kr/core\";\n\n// 나라장터 낙찰정보서비스(ScsbidInfoService). 입찰공고(/ad/)와 달리 /as/ 경로다.\nconst SERVICE_PATH = \"/1230000/as/ScsbidInfoService\";\n\nexport function createGateway(): DataGoKrClient {\n // 개찰결과(계열 B)는 응답이 무겁고 느려 기본 타임아웃(~10초)을 넘는 페이지가 있다\n // (라이브: 30~50행에서 8~9초, 100행 타임아웃). 낙찰(계열 A)은 빨라 영향 없다.\n return createClient({ path: SERVICE_PATH, params: { type: \"json\" }, timeout: 30000 });\n}\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { DataGoKrClient } from \"@opendata-kr/core\";\nimport { VERSION } from \"./version.js\";\nimport { searchAwardsInputShape, runSearchAwards, type SearchAwardsArgs } from \"./tools/searchAwards.js\";\nimport { searchOpeningsInputShape, runSearchOpenings, type SearchOpeningsArgs } from \"./tools/searchOpenings.js\";\nimport { getBidResultInputShape, runGetBidResult, type GetBidResultArgs } from \"./tools/getBidResult.js\";\n\nfunction textResult(payload: unknown, isError = false) {\n return { content: [{ type: \"text\" as const, text: JSON.stringify(payload, null, 2) }], ...(isError ? { isError: true } : {}) };\n}\n\nexport function createServer(client: DataGoKrClient): McpServer {\n const server = new McpServer({ name: \"narajangteo-opening-mcp\", version: VERSION });\n\n server.registerTool(\"search_awards\", {\n title: \"낙찰 결과 검색\",\n description:\n \"나라장터 낙찰 결과(최종낙찰자)를 공고명·기관·수요기관(코드)·지역·업종·추정가·사업자번호·기간으로 검색한다. '누가 얼마에 낙찰받았나', 경쟁사(bizno) 낙찰 이력, 되풀이 사업의 종단 조회에 쓴다. 특정 공고의 개찰·투찰업체·예비가 상세는 get_bid_result, 개찰 진행·유찰 발굴은 search_openings를 쓴다. 업무구분 미지정 시 물품/공사/용역/외자를 병렬 조회한다. 낙찰자만 반환하며 그 업체가 참여했으나 진 입찰은 미포함.\",\n inputSchema: searchAwardsInputShape,\n annotations: { readOnlyHint: true, openWorldHint: true },\n }, async (args) => {\n try { return textResult(await runSearchAwards(client, args as SearchAwardsArgs)); }\n catch (e) { return textResult({ error: e instanceof Error ? e.message : String(e) }, true); }\n });\n\n server.registerTool(\"search_openings\", {\n title: \"개찰결과 검색\",\n description:\n \"나라장터 개찰결과 목록을 검색하고 진행상태(개찰완료/유찰/재입찰)로 필터한다. 유찰·재입찰 공고 발굴에 쓴다. 최종낙찰자 검색은 search_awards, 단일 공고 상세는 get_bid_result를 쓴다. status는 API가 아니라 응답 기준 클라이언트 필터라 응답이 느리니 기관·업종·기간으로 좁혀 쓴다(truncated=true면 미완 스캔). 재입찰은 동일 공고 내 재입찰이며 재공고가 아니다(재공고는 입찰공고 서비스 소관).\",\n inputSchema: searchOpeningsInputShape,\n annotations: { readOnlyHint: true, openWorldHint: true },\n }, async (args) => {\n try { return textResult(await runSearchOpenings(client, args as SearchOpeningsArgs)); }\n catch (e) { return textResult({ error: e instanceof Error ? e.message : String(e) }, true); }\n });\n\n server.registerTool(\"get_bid_result\", {\n title: \"공고 개찰 상세\",\n description:\n \"입찰공고번호로 그 공고의 낙찰자·개찰진행·예비가격상세(사정률)·투찰업체별 순위/금액/점수를 복합키 정합으로 단건 조회한다. 딜 사후분석·투찰가 참고에 쓴다. 여러 공고를 조건으로 찾으려면 search_awards 또는 search_openings를 쓴다. 다분류·다차수 공고는 집행 단위 배열로 분리한다. 낙찰방식은 추정이며(협상계약만 기술·가격 점수 제공, 적격심사는 금액·순위만), myBizno를 주면 자사 투찰행에 isOurs를 표시한다.\",\n inputSchema: getBidResultInputShape,\n annotations: { readOnlyHint: true, openWorldHint: true },\n }, async (args) => {\n try { return textResult(await runGetBidResult(client, args as GetBidResultArgs)); }\n catch (e) { return textResult({ error: e instanceof Error ? e.message : String(e) }, true); }\n });\n\n return server;\n}\n","// 버전은 release-please가 릴리스마다 이 마커 사이 값을 교체한다.\n// release-please-config.json의 extra-files에 { type: \"generic\", path: \"src/version.ts\" }로 등록돼 있다.\n// 초기값 0.0.0은 첫 릴리스에서 실제 버전으로 대체된다.\n// x-release-please-start-version\nexport const VERSION = \"0.1.0\";\n// x-release-please-end\n","import { z } from \"zod\";\nimport type { DataGoKrClient } from \"@opendata-kr/core\";\nimport { ALL_BID_KINDS, awardSearchOp, awardInqryDiv, type BidKind, type DateType } from \"../api/endpoints.js\";\nimport { splitDateWindows, fetchAllPages, MAX_WINDOW_DAYS } from \"../api/dateWindow.js\";\nimport { formatAward } from \"../format.js\";\nimport type { AwardResult } from \"../api/types.js\";\n\nexport const searchAwardsInputShape = {\n bidKind: z.array(z.enum([\"cnstwk\", \"servc\", \"thng\", \"frgcpt\"])).optional().describe(\"업무구분 배열. 미지정 시 전 구분 병렬\"),\n keyword: z.string().optional().describe(\"공고명 부분검색(bidNtceNm)\"),\n institution: z.string().optional().describe(\"공고기관명(ntceInsttNm)\"),\n demandInstitution: z.string().optional().describe(\"수요기관명(dminsttNm)\"),\n demandInstitutionCode: z.string().optional().describe(\"수요기관코드(dminsttCd). 종단 식별에 안정적\"),\n detailProductCode: z.string().optional().describe(\"세부품명번호(dtilPrdctClsfcNo)\"),\n region: z.string().optional().describe(\"참가제한지역명(prtcptLmtRgnNm)\"),\n industry: z.string().optional().describe(\"업종명(indstrytyNm)\"),\n minPrice: z.number().optional().describe(\"추정가격 하한(presmptPrceBgn)\"),\n maxPrice: z.number().optional().describe(\"추정가격 상한(presmptPrceEnd)\"),\n bizno: z.string().optional().describe(\"업체 사업자번호. 그 업체의 낙찰건만 조회(진 입찰은 미포함)\"),\n startDate: z.string().optional().describe(\"조회 시작일 YYYYMMDD\"),\n endDate: z.string().optional().describe(\"조회 종료일 YYYYMMDD\"),\n dateType: z.enum([\"posted\", \"opened\"]).optional().describe(\"날짜 기준. posted=공고게시(기본), opened=개찰\"),\n pageSize: z.number().int().min(1).max(100).optional().describe(\"창당 페이지 크기(기본 100)\"),\n maxPages: z.number().int().min(1).max(50).optional().describe(\"창당 최대 페이지(기본 10)\"),\n};\n\nexport type SearchAwardsArgs = {\n bidKind?: BidKind[]; keyword?: string; institution?: string; demandInstitution?: string;\n demandInstitutionCode?: string; detailProductCode?: string; region?: string; industry?: string;\n minPrice?: number; maxPrice?: number; bizno?: string; startDate?: string; endDate?: string;\n dateType?: \"posted\" | \"opened\"; pageSize?: number; maxPages?: number;\n};\n\ntype KindResult = { totalCount: number; items: AwardResult[]; truncated: boolean } | { error: string };\nexport interface SearchAwardsResult { query: SearchAwardsArgs; results: Partial<Record<BidKind, KindResult>>; notes: string[]; }\n\nexport async function runSearchAwards(client: DataGoKrClient, args: SearchAwardsArgs): Promise<SearchAwardsResult> {\n const kinds = args.bidKind ?? [...ALL_BID_KINDS];\n const dateType: DateType = args.dateType ?? \"posted\";\n const inqryDiv = awardInqryDiv(dateType, true);\n const base: Record<string, string | number | undefined> = {\n inqryDiv,\n bidNtceNm: args.keyword, ntceInsttNm: args.institution, dminsttNm: args.demandInstitution,\n dminsttCd: args.demandInstitutionCode, dtilPrdctClsfcNo: args.detailProductCode,\n prtcptLmtRgnNm: args.region, indstrytyNm: args.industry,\n presmptPrceBgn: args.minPrice, presmptPrceEnd: args.maxPrice, bizno: args.bizno,\n };\n\n if ((args.startDate && !args.endDate) || (!args.startDate && args.endDate)) {\n throw new Error(\"startDate와 endDate는 함께 지정해야 합니다.\");\n }\n if (args.startDate && args.endDate && args.startDate > args.endDate) {\n throw new Error(\"startDate가 endDate보다 늦습니다.\");\n }\n\n const windows = args.startDate && args.endDate\n ? splitDateWindows(args.startDate, args.endDate, MAX_WINDOW_DAYS)\n : [{ bgn: undefined as string | undefined, end: undefined as string | undefined }];\n const pageSize = args.pageSize ?? 100;\n const maxPages = args.maxPages ?? 10;\n\n const settled = await Promise.allSettled(kinds.map(async (kind) => {\n const items: AwardResult[] = [];\n let totalCount = 0, truncated = false;\n for (const w of windows) {\n const params = { ...base, inqryBgnDt: w.bgn, inqryEndDt: w.end };\n const r = await fetchAllPages((op, p) => client.call(op, p), awardSearchOp(kind), params, { pageSize, maxPages });\n items.push(...r.items.map(formatAward));\n totalCount += r.totalCount;\n truncated = truncated || r.truncated;\n }\n return { totalCount, items, truncated };\n }));\n\n const results: Partial<Record<BidKind, KindResult>> = {};\n kinds.forEach((kind, i) => {\n const s = settled[i]!;\n results[kind] = s.status === \"fulfilled\" ? s.value : { error: s.reason instanceof Error ? s.reason.message : String(s.reason) };\n });\n return {\n query: args, results,\n notes: [\n \"낙찰자만 조회한다(그 업체가 참여했으나 진 입찰은 이 API로 도달 불가).\",\n \"여러 창(주 단위 분할)의 totalCount 합은 창별 합계다.\",\n ],\n };\n}\n","export type BidKind = \"cnstwk\" | \"servc\" | \"thng\" | \"frgcpt\";\nexport const ALL_BID_KINDS: readonly BidKind[] = [\"cnstwk\", \"servc\", \"thng\", \"frgcpt\"];\nconst SUFFIX: Record<BidKind, string> = {\n cnstwk: \"Cnstwk\", servc: \"Servc\", thng: \"Thng\", frgcpt: \"Frgcpt\",\n};\n\n// 계열 A: 낙찰된 목록 현황\nexport const awardListOp = (k: BidKind): string => `getScsbidListSttus${SUFFIX[k]}`;\nexport const awardSearchOp = (k: BidKind): string => `getScsbidListSttus${SUFFIX[k]}PPSSrch`;\n// 계열 B: 개찰결과 목록\nexport const openingListOp = (k: BidKind): string => `getOpengResultListInfo${SUFFIX[k]}`;\nexport const openingSearchOp = (k: BidKind): string => `getOpengResultListInfo${SUFFIX[k]}PPSSrch`;\n// 계열 C: 예비가격상세\nexport const preparPriceOp = (k: BidKind): string => `getOpengResultListInfo${SUFFIX[k]}PreparPcDetail`;\n\n// 계열 D: 상태별 (업무구분 무관 단일 오퍼레이션)\nexport type OpeningStatus = \"completed\" | \"failing\" | \"rebid\";\nexport const ALL_OPENING_STATUS: readonly OpeningStatus[] = [\"completed\", \"failing\", \"rebid\"];\nexport const D_OPERATION: Record<OpeningStatus, string> = {\n completed: \"getOpengResultListInfoOpengCompt\",\n failing: \"getOpengResultListInfoFailing\",\n rebid: \"getOpengResultListInfoRebid\",\n};\n\n// 날짜 기준. posted=공고(게시), opened=개찰, notice=공고번호 단건.\nexport type DateType = \"posted\" | \"opened\" | \"notice\";\n\n// A 기본판: 1등록 2공고 3개찰 4공고번호 / A PPSSrch: 1공고게시 2개찰 3공고번호\nexport function awardInqryDiv(dateType: DateType, ppsSrch: boolean): string {\n if (ppsSrch) return dateType === \"notice\" ? \"3\" : dateType === \"opened\" ? \"2\" : \"1\";\n return dateType === \"notice\" ? \"4\" : dateType === \"opened\" ? \"3\" : \"2\";\n}\n// B 기본판: 1입력 2공고 3개찰 4공고번호 / B PPSSrch: A PPSSrch와 동일\nexport function openingInqryDiv(dateType: DateType, ppsSrch: boolean): string {\n if (ppsSrch) return dateType === \"notice\" ? \"3\" : dateType === \"opened\" ? \"2\" : \"1\";\n return dateType === \"notice\" ? \"4\" : dateType === \"opened\" ? \"3\" : \"2\";\n}\n","import type { OperationResult, RawItem } from \"@opendata-kr/core\";\n\n// 라이브 검증(2026-07-07): 낙찰 서비스는 1개월 창도 통과(1주 1189·1개월 6096건 정상).\n// 형제 bid 서비스(1주 축소)와 달라 31일로 둔다.\nexport const MAX_WINDOW_DAYS = 31;\n\nfunction toDate(yyyymmdd: string): Date {\n const y = Number(yyyymmdd.slice(0, 4)), m = Number(yyyymmdd.slice(4, 6)), d = Number(yyyymmdd.slice(6, 8));\n return new Date(Date.UTC(y, m - 1, d));\n}\nfunction fmt(dt: Date): string {\n const y = dt.getUTCFullYear(), m = String(dt.getUTCMonth() + 1).padStart(2, \"0\"), d = String(dt.getUTCDate()).padStart(2, \"0\");\n return `${y}${m}${d}`;\n}\n\nexport function splitDateWindows(start: string, end: string, maxDays: number): Array<{ bgn: string; end: string }> {\n const windows: Array<{ bgn: string; end: string }> = [];\n let cur = toDate(start);\n const last = toDate(end);\n while (cur <= last) {\n const winEnd = new Date(cur);\n winEnd.setUTCDate(winEnd.getUTCDate() + maxDays - 1);\n const eff = winEnd > last ? last : winEnd;\n windows.push({ bgn: `${fmt(cur)}0000`, end: `${fmt(eff)}2359` });\n cur = new Date(eff);\n cur.setUTCDate(cur.getUTCDate() + 1);\n }\n return windows;\n}\n\ntype CallFn = (op: string, params: Record<string, string | number | undefined>) => Promise<OperationResult>;\n\nexport async function fetchAllPages(\n call: CallFn, op: string, params: Record<string, string | number | undefined>,\n opts: { pageSize: number; maxPages: number },\n): Promise<{ totalCount: number; items: RawItem[]; truncated: boolean }> {\n const items: RawItem[] = [];\n let totalCount = 0;\n let page = 1;\n for (; page <= opts.maxPages; page++) {\n const r = await call(op, { ...params, pageNo: page, numOfRows: opts.pageSize });\n totalCount = r.totalCount;\n items.push(...r.items);\n if (items.length >= totalCount || r.items.length === 0) {\n return { totalCount, items, truncated: false };\n }\n }\n return { totalCount, items, truncated: true };\n}\n","import type { RawItem } from \"@opendata-kr/core\";\nimport type { AwardResult, OpeningSummary, BidderDetail, CompositeKey, PreparPriceDetail } from \"./api/types.js\";\n\nconst pick = (raw: RawItem, k: string): string => raw[k] ?? \"\";\n\nexport function compositeKeyOf(raw: RawItem | CompositeKey): string {\n const g = (k: string) => (raw as RawItem)[k] ?? \"\";\n return `${g(\"bidNtceNo\")}|${g(\"bidNtceOrd\")}|${g(\"bidClsfcNo\")}|${g(\"rbidNo\")}`;\n}\n\nexport function parseOpengCorpInfo(s: string): { name: string; bizno: string; ceo: string; amount: string; rate: string } | null {\n if (!s) return null;\n const [name = \"\", bizno = \"\", ceo = \"\", amount = \"\", rate = \"\"] = s.split(\"^\");\n return { name, bizno, ceo, amount, rate };\n}\n\nexport function formatAward(raw: RawItem): AwardResult {\n return {\n bidNtceNo: pick(raw, \"bidNtceNo\"), bidNtceNm: pick(raw, \"bidNtceNm\"), participants: pick(raw, \"prtcptCnum\"),\n winner: pick(raw, \"bidwinnrNm\"), winnerBizno: pick(raw, \"bidwinnrBizno\"), winnerCeo: pick(raw, \"bidwinnrCeoNm\"),\n awardAmount: pick(raw, \"sucsfbidAmt\"), awardRate: pick(raw, \"sucsfbidRate\"), realOpeningDt: pick(raw, \"rlOpengDt\"),\n demandInstitution: pick(raw, \"dminsttNm\"), finalAwardDate: pick(raw, \"fnlSucsfDate\"),\n };\n}\n\nexport function formatOpening(raw: RawItem): OpeningSummary {\n return {\n bidNtceNo: pick(raw, \"bidNtceNo\"), bidNtceNm: pick(raw, \"bidNtceNm\"), openingDt: pick(raw, \"opengDt\"),\n participants: pick(raw, \"prtcptCnum\"), progress: pick(raw, \"progrsDivCdNm\"),\n topBidder: parseOpengCorpInfo(pick(raw, \"opengCorpInfo\")),\n reservePriceFileExists: pick(raw, \"rsrvtnPrceFileExistnceYn\"),\n noticeInstitution: pick(raw, \"ntceInsttNm\"), demandInstitution: pick(raw, \"dminsttNm\"),\n };\n}\n\nexport function formatBidder(raw: RawItem): BidderDetail {\n return {\n rank: pick(raw, \"opengRank\"), name: pick(raw, \"prcbdrNm\"), bizno: pick(raw, \"prcbdrBizno\"), ceo: pick(raw, \"prcbdrCeoNm\"),\n amount: pick(raw, \"bidprcAmt\"), rate: pick(raw, \"bidprcrt\"), remark: pick(raw, \"rmrk\"),\n priceScore: pick(raw, \"bidPrceEvlVal\"), techScore: pick(raw, \"techEvlVal\"), techRawScore: pick(raw, \"techEvlNaturVal\"),\n totalScore: pick(raw, \"totalEvlAmtVal\"), bidDt: pick(raw, \"bidprcDt\"),\n };\n}\n\nexport function aggregatePreparPrice(items: RawItem[]): PreparPriceDetail {\n const first = items[0];\n const planPrice = first ? pick(first, \"plnprc\") : \"\";\n const baseAmount = first ? pick(first, \"bssamt\") : \"\";\n const p = Number(planPrice), b = Number(baseAmount);\n const saJeongRate = first && b > 0 && Number.isFinite(p) && Number.isFinite(b) ? p / b : null;\n return {\n planPrice, baseAmount, saJeongRate,\n totalReserveCount: first ? pick(first, \"totRsrvtnPrceNum\") : \"\",\n drawn: first ? pick(first, \"drwtYn\") : \"\",\n reserves: items.map((r) => ({ seq: pick(r, \"compnoRsrvtnPrceSno\"), basePlanPrice: pick(r, \"bsisPlnprc\") })),\n };\n}\n\n// 유찰 사유는 API에 없다. 참가업체수(prtcptCnum)로 추론 힌트만 제공(spec §6, S4).\nexport function failReasonHint(participants: string): string {\n const n = Number(participants);\n if (n === 0) return \"무응찰 추정(참가 0). 재도전 기회일 수 있음\";\n if (n === 1) return \"단독응찰 추정(참가 1). 수의계약 직행 가능, 기회 낮음\";\n return \"적격자 없음 등 추정(참가 2+). 재도전 기회일 수 있음\";\n}\n\n// 낙찰방식 구분 필드가 API에 없다. D 점수 채움 패턴으로 추정(spec §6, S5).\nexport function estimateAwardMethod(bidders: BidderDetail[]): { method: \"negotiated\" | \"qualification_or_other\"; uncertain: true } {\n const scored = bidders.some((b) => (b.totalScore && b.totalScore !== \"\") || (b.techScore && b.techScore !== \"\"));\n return { method: scored ? \"negotiated\" : \"qualification_or_other\", uncertain: true };\n}\n","import { z } from \"zod\";\nimport type { DataGoKrClient } from \"@opendata-kr/core\";\nimport { ALL_BID_KINDS, openingSearchOp, openingInqryDiv, type BidKind, type DateType } from \"../api/endpoints.js\";\nimport { splitDateWindows, fetchAllPages, MAX_WINDOW_DAYS } from \"../api/dateWindow.js\";\nimport { formatOpening, failReasonHint } from \"../format.js\";\nimport type { OpeningSummary } from \"../api/types.js\";\n\nexport const searchOpeningsInputShape = {\n bidKind: z.array(z.enum([\"cnstwk\", \"servc\", \"thng\", \"frgcpt\"])).optional().describe(\"업무구분 배열(cnstwk=공사·servc=용역·thng=물품·frgcpt=외자). 미지정 시 전 구분 병렬\"),\n keyword: z.string().optional().describe(\"공고명(bidNtceNm)\"),\n institution: z.string().optional().describe(\"공고기관명\"),\n demandInstitution: z.string().optional().describe(\"수요기관명(dminsttNm)\"),\n region: z.string().optional().describe(\"참가제한지역명(prtcptLmtRgnNm, 예: 인천광역시)\"),\n industry: z.string().optional().describe(\"업종명(indstrytyNm)\"),\n status: z.enum([\"개찰완료\", \"유찰\", \"재입찰\"]).optional().describe(\"진행상태 필터(응답 progrsDivCdNm 기준 클라이언트 필터)\"),\n startDate: z.string().optional().describe(\"조회 시작일 YYYYMMDD (endDate와 함께 지정)\"),\n endDate: z.string().optional().describe(\"조회 종료일 YYYYMMDD (startDate와 함께 지정)\"),\n dateType: z.enum([\"posted\", \"opened\"]).optional().describe(\"날짜 기준: posted=공고게시(기본), opened=개찰\"),\n pageSize: z.number().int().min(1).max(100).optional().describe(\"창당 페이지 크기(기본 20, 개찰결과는 느려 작게 권장)\"),\n maxPages: z.number().int().min(1).max(50).optional().describe(\"창당 최대 페이지(기본 5)\"),\n};\n\nexport type SearchOpeningsArgs = {\n bidKind?: BidKind[]; keyword?: string; institution?: string; demandInstitution?: string;\n region?: string; industry?: string; status?: \"개찰완료\" | \"유찰\" | \"재입찰\";\n startDate?: string; endDate?: string; dateType?: \"posted\" | \"opened\"; pageSize?: number; maxPages?: number;\n};\n\ntype KindResult = { totalCountBeforeFilter: number; filteredCount: number; items: OpeningSummary[]; truncated: boolean } | { error: string };\nexport interface SearchOpeningsResult { query: SearchOpeningsArgs; results: Partial<Record<BidKind, KindResult>>; notes: string[]; }\n\nexport async function runSearchOpenings(client: DataGoKrClient, args: SearchOpeningsArgs): Promise<SearchOpeningsResult> {\n if ((args.startDate && !args.endDate) || (!args.startDate && args.endDate)) {\n throw new Error(\"startDate와 endDate는 함께 지정해야 합니다.\");\n }\n if (args.startDate && args.endDate && args.startDate > args.endDate) {\n throw new Error(\"startDate가 endDate보다 늦습니다.\");\n }\n\n const kinds = args.bidKind ?? [...ALL_BID_KINDS];\n const dateType: DateType = args.dateType ?? \"posted\";\n const inqryDiv = openingInqryDiv(dateType, true);\n const base: Record<string, string | number | undefined> = {\n inqryDiv, bidNtceNm: args.keyword, ntceInsttNm: args.institution, dminsttNm: args.demandInstitution,\n prtcptLmtRgnNm: args.region, indstrytyNm: args.industry,\n };\n const windows = args.startDate && args.endDate\n ? splitDateWindows(args.startDate, args.endDate, MAX_WINDOW_DAYS)\n : [{ bgn: undefined as string | undefined, end: undefined as string | undefined }];\n // 개찰결과(계열 B)는 응답이 무겁고 느려 큰 페이지는 타임아웃한다(라이브: 20행 0.6초, 50행 9초, 100행 타임아웃).\n // 기본 페이지를 작게 둔다.\n const pageSize = args.pageSize ?? 20, maxPages = args.maxPages ?? 5;\n\n const settled = await Promise.allSettled(kinds.map(async (kind) => {\n const all: OpeningSummary[] = [];\n let before = 0, truncated = false;\n for (const w of windows) {\n const r = await fetchAllPages((op, p) => client.call(op, p), openingSearchOp(kind), { ...base, inqryBgnDt: w.bgn, inqryEndDt: w.end }, { pageSize, maxPages });\n before += r.totalCount; truncated = truncated || r.truncated;\n for (const raw of r.items) {\n const o = formatOpening(raw);\n if (o.progress === \"유찰\") o.failReasonHint = failReasonHint(o.participants);\n all.push(o);\n }\n }\n const items = args.status ? all.filter((o) => o.progress === args.status) : all;\n return { totalCountBeforeFilter: before, filteredCount: items.length, items, truncated };\n }));\n\n const results: Partial<Record<BidKind, KindResult>> = {};\n kinds.forEach((kind, i) => {\n const s = settled[i]!;\n results[kind] = s.status === \"fulfilled\" ? s.value : { error: s.reason instanceof Error ? s.reason.message : String(s.reason) };\n });\n return {\n query: args, results,\n notes: [\n \"status는 응답 progrsDivCdNm 기준 클라이언트 필터다(API 요청 파라미터 아님). totalCountBeforeFilter는 필터 전 값.\",\n \"재입찰은 동일 공고 내 재입찰이며 재공고가 아니다(재공고는 입찰공고 서비스 소관).\",\n \"개찰결과 조회는 응답이 느리다. 페이지 크기를 작게(기본 20) 유지하고 검색조건(기관·업종·기간)을 좁혀 쓴다.\",\n ],\n };\n}\n","import { z } from \"zod\";\nimport type { DataGoKrClient, RawItem } from \"@opendata-kr/core\";\nimport {\n ALL_BID_KINDS, ALL_OPENING_STATUS, awardListOp, openingListOp, preparPriceOp,\n D_OPERATION, awardInqryDiv, openingInqryDiv, type BidKind, type OpeningStatus,\n} from \"../api/endpoints.js\";\nimport {\n formatAward, formatOpening, formatBidder, aggregatePreparPrice, estimateAwardMethod, compositeKeyOf,\n} from \"../format.js\";\nimport type { AwardResult, OpeningSummary, PreparPriceDetail, BidderDetail } from \"../api/types.js\";\n\nexport const getBidResultInputShape = {\n bidNtceNo: z.string().describe(\"입찰공고번호\"),\n bidKind: z.enum([\"cnstwk\", \"servc\", \"thng\", \"frgcpt\"]).optional().describe(\"업무구분. 미지정 시 A/B/C를 전 구분에서 조회\"),\n status: z.enum([\"completed\", \"failing\", \"rebid\", \"all\"]).optional().describe(\"D 상태(기본 all: 완료·유찰·재입찰 병렬)\"),\n bidNtceOrd: z.string().optional().describe(\"입찰공고차수. 특정 집행으로 좁힘\"),\n bidClsfcNo: z.string().optional().describe(\"입찰분류번호. 특정 집행으로 좁힘\"),\n rbidNo: z.string().optional().describe(\"재입찰번호. 특정 집행으로 좁힘\"),\n myBizno: z.string().optional().describe(\"자사 사업자번호. 일치하는 투찰행에 isOurs 플래그\"),\n};\nexport type GetBidResultArgs = {\n bidNtceNo: string; bidKind?: BidKind; status?: \"completed\" | \"failing\" | \"rebid\" | \"all\";\n bidNtceOrd?: string; bidClsfcNo?: string; rbidNo?: string; myBizno?: string;\n};\n\nexport interface Execution {\n bidNtceOrd: string; bidClsfcNo: string; rbidNo: string;\n awardMethod: { method: \"negotiated\" | \"qualification_or_other\"; uncertain: true };\n award: AwardResult | null; opening: OpeningSummary | null;\n preparPrice: PreparPriceDetail | null; bidders: BidderDetail[];\n}\nexport interface GetBidResultResult { bidNtceNo: string; executions: Execution[]; errors: string[]; notes: string[]; }\n\nasync function safeItems(client: DataGoKrClient, op: string, params: Record<string, string | number | undefined>, errors: string[]): Promise<RawItem[]> {\n try { return (await client.call(op, { ...params, pageNo: 1, numOfRows: 100 })).items; }\n catch (e) { errors.push(`${op}: ${e instanceof Error ? e.message : String(e)}`); return []; }\n}\n\nexport async function runGetBidResult(client: DataGoKrClient, args: GetBidResultArgs): Promise<GetBidResultResult> {\n const errors: string[] = [];\n const kinds: BidKind[] = args.bidKind ? [args.bidKind] : [...ALL_BID_KINDS];\n const statuses: OpeningStatus[] = !args.status || args.status === \"all\" ? [...ALL_OPENING_STATUS] : [args.status];\n const no = args.bidNtceNo;\n\n // A/B/C: 업무구분 병렬 시도(inqryDiv=공고번호). D: 상태 오퍼레이션 병렬.\n const aRaw: RawItem[] = [], bRaw: RawItem[] = [], cRaw: RawItem[] = [], dRaw: RawItem[] = [];\n await Promise.all([\n ...kinds.map(async (k) => { aRaw.push(...await safeItems(client, awardListOp(k), { inqryDiv: awardInqryDiv(\"notice\", false), bidNtceNo: no }, errors)); }),\n ...kinds.map(async (k) => { bRaw.push(...await safeItems(client, openingListOp(k), { inqryDiv: openingInqryDiv(\"notice\", false), bidNtceNo: no }, errors)); }),\n ...kinds.map(async (k) => { cRaw.push(...await safeItems(client, preparPriceOp(k), { inqryDiv: \"2\", bidNtceNo: no }, errors)); }),\n ...statuses.map(async (s) => { dRaw.push(...await safeItems(client, D_OPERATION[s], { bidNtceNo: no }, errors)); }),\n ]);\n\n // 복합키로 집행 그룹핑\n const keys = new Set<string>();\n for (const r of [...aRaw, ...bRaw, ...cRaw, ...dRaw]) keys.add(compositeKeyOf(r));\n\n const executions: Execution[] = [...keys].map((key) => {\n const match = (r: RawItem) => compositeKeyOf(r) === key;\n const [, ord = \"\", clsfc = \"\", rbid = \"\"] = key.split(\"|\");\n const a = aRaw.find(match), b = bRaw.find(match);\n const cItems = cRaw.filter(match), dItems = dRaw.filter(match);\n const bidders = dItems.map(formatBidder).map((b) =>\n args.myBizno && b.bizno === args.myBizno ? { ...b, isOurs: true } : b);\n return {\n bidNtceOrd: ord, bidClsfcNo: clsfc, rbidNo: rbid,\n awardMethod: estimateAwardMethod(bidders),\n award: a ? formatAward(a) : null,\n opening: b ? formatOpening(b) : null,\n preparPrice: cItems.length ? aggregatePreparPrice(cItems) : null,\n bidders,\n };\n });\n\n let filtered = executions;\n if (args.bidNtceOrd !== undefined || args.bidClsfcNo !== undefined || args.rbidNo !== undefined) {\n filtered = executions.filter((e) =>\n (args.bidNtceOrd === undefined || e.bidNtceOrd === args.bidNtceOrd) &&\n (args.bidClsfcNo === undefined || e.bidClsfcNo === args.bidClsfcNo) &&\n (args.rbidNo === undefined || e.rbidNo === args.rbidNo));\n }\n\n return {\n bidNtceNo: no, executions: filtered, errors,\n notes: [\n \"A/B/C/D를 복합키(공고번호+차수+분류+재입찰번호)로 조인한다. 다분류·다차수는 집행 단위로 분리된다.\",\n \"낙찰방식 구분 필드가 API에 없어 점수 채움으로 추정한다(uncertain). 협상계약이 아니면 세부심사점수는 제공되지 않는다.\",\n ],\n };\n}\n"],"mappings":"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","names":["z","z","z","z","b"]}
|
package/package.json
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@opendata-kr/narajangteo-opening-mcp",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "나라장터 낙찰정보서비스 Open API를 위한 로컬 MCP 서버",
|
|
5
|
+
"mcpName": "io.github.opendata-kr/narajangteo-opening",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"bin": {
|
|
8
|
+
"narajangteo-opening-mcp": "dist/index.js"
|
|
9
|
+
},
|
|
10
|
+
"files": [
|
|
11
|
+
"dist"
|
|
12
|
+
],
|
|
13
|
+
"publishConfig": {
|
|
14
|
+
"access": "public"
|
|
15
|
+
},
|
|
16
|
+
"repository": {
|
|
17
|
+
"type": "git",
|
|
18
|
+
"url": "git+https://github.com/opendata-kr/narajangteo-opening-mcp.git"
|
|
19
|
+
},
|
|
20
|
+
"homepage": "https://github.com/opendata-kr/narajangteo-opening-mcp#readme",
|
|
21
|
+
"bugs": "https://github.com/opendata-kr/narajangteo-opening-mcp/issues",
|
|
22
|
+
"engines": {
|
|
23
|
+
"node": ">=24"
|
|
24
|
+
},
|
|
25
|
+
"keywords": [
|
|
26
|
+
"mcp",
|
|
27
|
+
"modelcontextprotocol",
|
|
28
|
+
"나라장터",
|
|
29
|
+
"낙찰정보",
|
|
30
|
+
"개찰",
|
|
31
|
+
"data.go.kr"
|
|
32
|
+
],
|
|
33
|
+
"license": "MIT",
|
|
34
|
+
"dependencies": {
|
|
35
|
+
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
36
|
+
"@opendata-kr/core": "^0.1.3",
|
|
37
|
+
"zod": "^4.4.3"
|
|
38
|
+
},
|
|
39
|
+
"devDependencies": {
|
|
40
|
+
"@types/node": "^26.1.0",
|
|
41
|
+
"tsup": "^8.5.1",
|
|
42
|
+
"tsx": "^4.23.0",
|
|
43
|
+
"typescript": "^6.0.3",
|
|
44
|
+
"vitest": "^4.1.9"
|
|
45
|
+
},
|
|
46
|
+
"scripts": {
|
|
47
|
+
"build": "tsup",
|
|
48
|
+
"dev": "tsx src/index.ts",
|
|
49
|
+
"typecheck": "tsc --noEmit",
|
|
50
|
+
"test": "vitest run",
|
|
51
|
+
"test:watch": "vitest",
|
|
52
|
+
"verify:package": "node scripts/verify-npm-package.mjs",
|
|
53
|
+
"verify:server-json": "node scripts/verify-server-json.mjs"
|
|
54
|
+
}
|
|
55
|
+
}
|