g2b-order-plan-search

Search Korean government procurement order plans via the data.go.kr OrderPlanSttusService API.

7.4k|904|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill g2b-order-plan-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: g2b-order-plan-search
Source: https://github.com/NomaDamas/k-skill/tree/main/g2b-order-plan-search
Command: npx skills add https://github.com/NomaDamas/k-skill --skill g2b-order-plan-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Finding upcoming Korean public procurement opportunities requires manually searching the 나라장터 (KONEPS) portal across goods, construction, service, and foreign procurement categories. This Skill queries the official 조달청 발주계획현황서비스 API through a proxy so you can search order plans by keyword, agency, region, and date range without handling API keys.

Core Features & Use Cases

  • Multi-category search: Query goods, construction, service, and foreign procurement order plans, or merge all four categories in one request.
  • Flexible filters: Narrow results by business name keyword, ordering institution name or code, region, procurement method, product code, and order/posting date ranges.
  • Structured output: Returns JSON with total counts, pagination, and upstream fields such as 사업명, 발주기관명, 발주월, 발주금액, and linked bid notice numbers.
  • Use Case: Ask your agent to find cleaning service order plans posted by Seoul agencies in Q1 2025, and receive a filtered list with amounts, contacts, and manual verification links to g2b.go.kr.

Quick Start

Ask the agent to search 나라장터 order plans for a keyword like "청소 용역" with an order month range such as 2025-01 to 2025-03.

Frequently Asked Questions about g2b-order-plan-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search 나라장터 order plans by keyword?

Run the helper script with --kind and --keyword flags, for example --kind service --keyword 청소 plus an order month range. The script calls the k-skill-proxy /v1/g2b/order-plans route and prints matching plans as JSON.

What procurement categories does the data.go.kr order plan API support?

The service supports four categories: goods (물품), construction (공사), service (용역), and foreign procurement (외자). Passing kind=all queries all four endpoints and merges the results with a category marker field.

Do I need a data.go.kr API key to use this skill?

No user-side key is required. The DATA_GO_KR_API_KEY lives only on the k-skill-proxy server, so you just need internet access and Python 3. Self-hosting users set KSKILL_PROXY_BASE_URL to their own proxy.

Can this skill submit bids or automate 나라장터 login?

No. It is strictly read-only search of order plan data. It does not automate login, bid submission, certificate operations, contracts, or payments, and it directs users to g2b.go.kr for manual verification.

Why does the order plan search return zero results?

A total_count of 0 means no plans matched your filters, or upstream returned resultCode 03 for no data. Also check for 503 upstream_not_configured, which means the proxy server lacks a valid data.go.kr API key.