g2b-order-plan-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

나라장터 발주계획 검색

国家电子采购平台（나라장터）招标计划搜索

What this skill does

本Skill的功能

g2b-order-plan-search

는 공공데이터포털의 조달청_나라장터 발주계획현황서비스(data.go.kr 15129462,

OrderPlanSttusService

)를

k-skill-proxy

경유로 호출해 나라장터에 등록된 발주계획 목록을 조회한다.

대상 업무: 물품, 공사, 용역, 외자
검색 조건: 발주년월 범위, 게시일시 범위, 발주기관명/코드, 사업명 키워드, 조달방식, 기관소재지, 세부품명번호, 업무유형, 공종 등
반환: 발주년도/월, 발주기관, 사업명, 계약방법, 발주금액, 담당부서/담당자/전화번호, 입찰공고번호목록 등 upstream 원문 필드

입찰 참가, 로그인, 입찰서 제출, 인증서 작업, 결제, 낙찰/계약 처리 자동화는 하지 않는다.

g2b-order-plan-search

通过

k-skill-proxy

调用公共数据门户的采购厅_国家电子采购平台招标计划现状服务（data.go.kr 15129462，

OrderPlanSttusService

），查询国家电子采购平台上已登记的招标计划列表。

目标业务：物品、工程、服务、外资
搜索条件：招标年月范围、发布时间范围、招标机构名称/代码、项目名称关键词、采购方式、机构所在地、详细品目编号、业务类型、工种等
返回内容：招标年度/月份、招标机构、项目名称、签约方式、招标金额、负责部门/负责人/电话号码、招标公告编号列表等上游原始字段

不支持投标参与、登录、投标书提交、证书操作、支付、中标/合同处理自动化。

Public access path discovered

已发现的公开访问路径

Primary source: 공공데이터포털 API through k-skill-proxy

主要来源：通过k-skill-proxy访问公共数据门户API

data.go.kr dataset: https://www.data.go.kr/data/15129462/openapi.do

upstream base:

https://apis.data.go.kr/1230000/ao/OrderPlanSttusService

proxy route:
```
GET /v1/g2b/order-plans
```
API key location: proxy server only (
```
DATA_GO_KR_API_KEY
```
)

Operations used:

kind	endpoint
`goods` / `물품`	`getOrderPlanSttusListThngPPSSrch`
`construction` / `공사`	`getOrderPlanSttusListCnstwkPPSSrch`
`service` / `용역`	`getOrderPlanSttusListServcPPSSrch`
`foreign` / `외자`	`getOrderPlanSttusListFrgcptPPSSrch`
`all` / `전체`	above four endpoints, merged with `_order_plan_kind`

The API is a free data.go.kr service that requires an application key, so it follows the repository's free-API proxy policy and does not expose the key to users.

data.go.kr数据集：https://www.data.go.kr/data/15129462/openapi.do

上游基础地址：

https://apis.data.go.kr/1230000/ao/OrderPlanSttusService

代理路由：
```
GET /v1/g2b/order-plans
```
API密钥位置：仅在代理服务器中（
```
DATA_GO_KR_API_KEY
```
）

使用的操作：

类型	端点
`goods` / `物品`	`getOrderPlanSttusListThngPPSSrch`
`construction` / `工程`	`getOrderPlanSttusListCnstwkPPSSrch`
`service` / `服务`	`getOrderPlanSttusListServcPPSSrch`
`foreign` / `外资`	`getOrderPlanSttusListFrgcptPPSSrch`
`all` / `全部`	上述四个端点，通过 `_order_plan_kind` 合并结果

该API是data.go.kr提供的免费服务，需要应用密钥，因此遵循仓库的免费API代理策略，不会向用户暴露密钥。

When to use

使用场景

"나라장터 발주목록에서 청소 용역 찾아줘"
"조달청 물품 발주계획 2025년 1월 목록 조회"
"서울 기관 공사 발주계획 검색"
"발주기관명으로 나라장터 발주계획 보여줘"

"帮我在国家电子采购平台招标列表中查找清洁服务"
"查询采购厅2025年1月的物品招标计划列表"
"搜索首尔地区机构的工程招标计划"
"按招标机构名称查看国家电子采购平台的招标计划"

Prerequisites

前置条件

인터넷 연결,
```
python3
```
hosted/self-host
```
k-skill-proxy
```
의
```
/v1/g2b/order-plans
```
route 접근 가능
proxy 운영 서버의
```
DATA_GO_KR_API_KEY
```
가 data.go.kr 15129462에 활용신청되어 있어야 함

사용자 측 필수 시크릿은 없다. Self-host proxy를 쓸 때만

KSKILL_PROXY_BASE_URL

을 설정한다.

互联网连接、
```
python3
```
环境
可访问托管/自托管的
```
k-skill-proxy
```
的
```
/v1/g2b/order-plans
```
路由
代理服务器的
```
DATA_GO_KR_API_KEY
```
已申请用于data.go.kr的15129462服务

用户无需提供密钥。仅在使用自托管代理时需要设置

KSKILL_PROXY_BASE_URL

。

Inputs

输入参数

CLI flags:

--kind

goods

물품

construction

공사

service

용역

foreign

외자

all

전체

(default

goods

)

```
--keyword
```
,
```
-q
```
: 사업명 검색어 (
```
bizNm
```
)
```
--order-from
```
,
```
--order-to
```
: 발주년월 범위 (
```
YYYY-MM
```
또는
```
YYYYMM
```
)

--posted-from

--posted-to

: 게시일시 범위 (

YYYY-MM-DD

YYYYMMDD

YYYYMMDDHHMM

)

```
--institution
```
: 발주기관명
```
--institution-code
```
: 발주기관코드
```
--region
```
: 기관소재지명
```
--procurement-method
```
: 조달방식
```
--product-code
```
: 세부품명번호(물품)
```
--business-type
```
: 업무유형명/업무유형코드(공사·용역·외자)
```
--construction-type
```
: 공종구분명(공사)
```
--page
```
,
```
--limit
```
: 페이지와 한 페이지 결과 수(최대 100)

CLI参数：

--kind

：

goods

物品

construction

工程

service

服务

foreign

外资

all

全部

（默认值

goods

）

```
--keyword
```
,
```
-q
```
：项目名称搜索关键词（对应
```
bizNm
```
字段）
```
--order-from
```
,
```
--order-to
```
：招标年月范围（格式为
```
YYYY-MM
```
或
```
YYYYMM
```
）

--posted-from

--posted-to

：发布时间范围（格式为

YYYY-MM-DD

YYYYMMDD

YYYYMMDDHHMM

）

```
--institution
```
：招标机构名称
```
--institution-code
```
：招标机构代码
```
--region
```
：机构所在地名称
```
--procurement-method
```
：采购方式
```
--product-code
```
：详细品目编号（仅物品类）
```
--business-type
```
：业务类型名称/业务类型代码（工程、服务、外资类）
```
--construction-type
```
：工种分类名称（仅工程类）
```
--page
```
,
```
--limit
```
：页码和每页结果数量（最大100）

Workflow

工作流程

1. Search order plans

1. 搜索招标计划

bash

python3 g2b-order-plan-search/scripts/g2b_order_plan.py \
  --kind service \
  --keyword 청소 \
  --order-from 2025-01 \
  --order-to 2025-03 \
  --posted-from 2025-01-01 \
  --posted-to 2025-01-31 \
  --limit 10

bash

python3 g2b-order-plan-search/scripts/g2b_order_plan.py \
  --kind service \
  --keyword 청소 \
  --order-from 2025-01 \
  --order-to 2025-03 \
  --posted-from 2025-01-01 \
  --posted-to 2025-01-31 \
  --limit 10

2. Narrow by institution or location

2. 按机构或地点筛选

bash

python3 g2b-order-plan-search/scripts/g2b_order_plan.py \
  --kind goods \
  --institution 조달청 \
  --region 대전 \
  --order-from 2025-01 \
  --order-to 2025-01

bash

python3 g2b-order-plan-search/scripts/g2b_order_plan.py \
  --kind goods \
  --institution 조달청 \
  --region 대전 \
  --order-from 2025-01 \
  --order-to 2025-01

3. Read output conservatively

3. 解读输出结果

The result is the proxy JSON response. Important fields:

```
query
```
: normalized upstream parameters and selected operation
```
total_count
```
,
```
page
```
,
```
page_size
```
```
items[]
```
: upstream order-plan rows
```
items[].orderPlanUntyNo
```
: 발주계획통합번호
```
items[].bizNm
```
: 사업명
```
items[].orderInsttNm
```
: 발주기관명
```
items[].orderMnth
```
: 발주월
```
items[].sumOrderAmt
```
,
```
items[].orderContrctAmt
```
: 발주금액 fields when upstream provides them
```
items[].bidNtceNoList
```
: linked bid notice numbers when upstream provides them

When answering, show the official source (data.go.kr dataset and g2b.go.kr manual verification URL) and state that 발주계획은 사전계획이며 실제 사전규격/입찰공고/계약과 1:1로 보장되지 않는다.

结果为代理返回的JSON响应，重要字段包括：

```
query
```
：标准化后的上游参数及所选操作
```
total_count
```
,
```
page
```
,
```
page_size
```
```
items[]
```
：上游返回的招标计划行数据
```
items[].orderPlanUntyNo
```
：招标计划统一编号
```
items[].bizNm
```
：项目名称
```
items[].orderInsttNm
```
：招标机构名称
```
items[].orderMnth
```
：招标月份
```
items[].sumOrderAmt
```
,
```
items[].orderContrctAmt
```
：上游提供时返回的招标金额字段
```
items[].bidNtceNoList
```
：上游提供时返回的关联招标公告编号

回复时需注明官方来源（data.go.kr数据集及g2b.go.kr手动验证地址），并说明招标计划为事前规划，无法与实际事前规格/招标公告/合同一一对应。

Done when

完成标准

The proxy route
```
/v1/g2b/order-plans
```
was queried.
The selected
```
kind
```
mapped to the correct PPS order-plan endpoint.
Date/month filters and keyword/institution filters are reflected in
```
query
```
.
Results include source fields and manual verification guidance.
No login, bidding, certificate, submission, or payment flow was automated.

已调用代理路由
```
/v1/g2b/order-plans
```
所选
```
kind
```
已映射到正确的PPS招标计划端点
日期/月份筛选器及关键词/机构筛选器已反映在
```
query
```
中
结果包含源字段及手动验证指引
未自动化登录、投标、证书、提交或支付流程

Failure modes

失败场景

503 upstream_not_configured

: proxy server has no

DATA_GO_KR_API_KEY

```
502 upstream_forbidden
```
: proxy key is not approved for data.go.kr service 15129462.
```
400 bad_request
```
: invalid kind, date/month, page, or limit input.
```
total_count = 0
```
: no order plans matched the selected conditions.
Upstream resultCode
```
03
```
: data.go.kr reports no data.
API changed endpoint names, parameters, or envelope shape.
발주계획은 실제 입찰공고 등록의 필수 선행조건이 아니며, 발주계획에 없는 사전규격·입찰공고·계약도 있을 수 있다.

503 upstream_not_configured

：代理服务器未配置

DATA_GO_KR_API_KEY

```
502 upstream_forbidden
```
：代理密钥未获得data.go.kr 15129462服务的授权
```
400 bad_request
```
：输入的类型、日期/月份、页码或数量无效
```
total_count = 0
```
：没有符合所选条件的招标计划
上游返回
```
resultCode 03
```
：data.go.kr报告无数据
API更改了端点名称、参数或响应结构
招标计划并非实际招标公告登记的必要前置条件，可能存在未列入招标计划的事前规格、招标公告或合同

Official surfaces

官方渠道

공공데이터포털: https://www.data.go.kr/data/15129462/openapi.do

upstream:

https://apis.data.go.kr/1230000/ao/OrderPlanSttusService

수동 대조: 나라장터 https://www.g2b.go.kr
proxy route:
```
GET /v1/g2b/order-plans
```

公共数据门户：https://www.data.go.kr/data/15129462/openapi.do

上游地址：

https://apis.data.go.kr/1230000/ao/OrderPlanSttusService

手动核对：国家电子采购平台 https://www.g2b.go.kr
代理路由：
```
GET /v1/g2b/order-plans
```