OpenParable
Skip to content
← Back to skills

G2b Order Plan Search

Research
g2b-order-plan-search

G2b Order Plan Search is an Agent Skill for research published in the NomaDamas/k-skill repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

조달청 나라장터 발주계획현황서비스로 물품·공사·용역·외자 발주계획 목록을 검색한다.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/NomaDamas/k-skill/blob/HEAD/g2b-order-plan-search/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/g2b-order-plan-search, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

나라장터 발주계획 검색

What this skill does

g2b-order-plan-search는 공공데이터포털의 조달청_나라장터 발주계획현황서비스(data.go.kr 15129462, OrderPlanSttusService)를 k-skill-proxy 경유로 호출해 나라장터에 등록된 발주계획 목록을 조회한다.

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

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

Public access path discovered

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

  • 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:

kindendpoint
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.

When to use

  • "나라장터 발주목록에서 청소 용역 찾아줘"
  • "조달청 물품 발주계획 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을 설정한다.

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)

Workflow

1. Search order plans

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

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

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로 보장되지 않는다.

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.

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.
  • 발주계획은 실제 입찰공고 등록의 필수 선행조건이 아니며, 발주계획에 없는 사전규격·입찰공고·계약도 있을 수 있다.

Official surfaces