g2b-cli

Command-line wrapper for 조달청 나라장터 OpenAPI — Korea's first-party public-procurement system. 나라장터 (g2b.go.kr) is the single national platform every Korean government agency, public university, and SOC project must use to post tenders worth roughly ₩200T per year. The 조달청 (Public Procurement Service) exposes three OpenAPI services on data.go.kr that mirror the website's three core surfaces: 입찰공고, 계약현황, and the 개방표준 data feed.

Three subcommands wrap the surface:

All output is JSONL — one row per record — so it pipes directly into jq, csvkit, pandas, or downstream skills. Pass --meta to any subcommand to get {totalCount, pageNo, numOfRows} instead of the items, which is the right shape for paging loops.

When to use this skill

• Tender-monitoring dashboards — bid.sh --type servc --keyword "AI" every hour to surface new AI-related RFPs nationwide. Pair with email/Slack alerts.
• Awarded-contract scrapers — std.sh --what awarded --from 202601010000 --to 202612310000 to backfill the year's 낙찰 records into a warehouse with a single, schema-stable feed.
• Supplier KYB on awardees — pull bizrno from awarded records, fan out to nts-bizno-cli status to confirm the company is still 정상사업자 before you sign downstream paperwork.
• B2B sales prospecting — bid.sh --type thng --inquiry-div 5 --dminstt-cd <기관> to monitor a target buyer institution's tender pipeline.
• Construction / SOC analysts — contract.sh --type cnstwk --from --to for monthly 공사 contract volumes by region; pair with kosis-cli for population/GDP normalisation.
• Compliance audits — repeated calls with --meta give totals; reconcile against a third-party data vendor's claims.
• News grounding for AI agents — when an LLM answers "who won the Seoul subway camera tender?", cite real records from std.sh --what awarded instead of hallucinating.

Do not use this skill for

• Bid submission — the OpenAPI is read-only. Actual bid filing requires the 나라장터 GPKI/GBKI digital cert + browser session — that's still a Windows-only ActiveX/exe flow as of 2026.
• Pre-RFP procurement plans (사전공고) — those live on a separate 조달정보표준 service not yet covered here.
• Sub-minute polling — data.go.kr dev keys are 1,000 req/day. For live aggregation in production, request the prod tier on data.go.kr (justification + use-case form, ~3 business days).
• Outside-Korea procurement — only 나라장터-listed Korean public tenders. For EU TED, US SAM.gov, or KONEPS/KOICA-funded foreign tenders, use those systems directly.
• Sub-public tenders (private B2B RFPs) — Korea's 나라장터 does not host private-sector RFPs. Use third-party platforms (BidWeb, EProcurement) for that.

Prerequisites

1. Register at https://www.data.go.kr/ (free, no business required).
2. Apply for all three services (instant approval, dev tier; production tier needs a usage-case form):
   • "조달청_나라장터 입찰공고정보서비스" (BidPublicInfoService)
   • "조달청_나라장터 계약현황정보" (CntrctInfoService)
   • "조달청_나라장터 공공데이터개방표준서비스" (PubDataOpnStdService)
3. Copy the Decoding key (the raw form, not URL-encoded) and export:

   export G2B_SERVICE_KEY='your_decoded_key_here'
   

4. Optional overrides (rarely needed; useful for staging):

   export G2B_BID_BASE='https://apis.data.go.kr/1230000/ad/BidPublicInfoService'
   export G2B_CNTRCT_BASE='https://apis.data.go.kr/1230000/ao/CntrctInfoService'
   export G2B_STD_BASE='https://apis.data.go.kr/1230000/ao/PubDataOpnStdService'
   

Common workflows

A) Today's new 용역 (services) tenders

scripts/bid.sh --type servc --rows 200 \
  | jq -c '{bidNtceNo, bidNtceNm, ntceInsttNm, dminsttNm, presmptPrce, bidNtceDt, bidBeginDt}'

B) Keyword-driven RFP alert (AI-related 용역)

scripts/bid.sh --keyword "인공지능" --rows 50 \
  | jq -c 'select(.bidNtceDt >= "2026-04-01") | {bidNtceNo, bidNtceNm, presmptPrce, ntceInsttNm}' \
  | tee today_ai_rfps.jsonl

C) Last-week awarded contracts → warehouse

# Use the open-standard feed for warehouse-ready, schema-stable rows.
scripts/std.sh --what awarded --from 202604220000 --to 202604290000 --rows 500 \
  > awarded_2026wk17.jsonl

D) Awardee KYB chain (g2b → nts-bizno)

# 1. Pull awarded list.
scripts/std.sh --what awarded --rows 100 > awarded.jsonl

# 2. For each awardee 사업자번호, confirm 정상사업자 status.
jq -r '.bizrno // empty' awarded.jsonl | sort -u | while read brn; do
  nts-bizno-cli status --b-no "$brn" \
    | jq --arg brn "$brn" '{bizrno: $brn, taxType: .tax_type, businessStatus: .b_stt}'
done > awardee_kyb.jsonl

E) One specific 공고 detail (when you have the bidNtceNo)

scripts/bid.sh --type thng --bid-no 20240412345-00 --rows 1 | jq .

F) Buyer-institution tender pipeline (수요기관 기준)

# 6110000 = 서울특별시청 (example dminsttCd; look up via the 나라장터 institution dictionary).
scripts/bid.sh --type cnstwk --inquiry-div 5 --dminstt-cd 6110000 --rows 200 \
  | jq -c '{bidNtceNo, bidNtceNm, presmptPrce, opengDt}'

G) Pagination loop (full month dump)

month_from=202604010000; month_to=202604300000
scripts/std.sh --what bid --from $month_from --to $month_to --meta
# {"totalCount":4982,"pageNo":1,"numOfRows":100}

for p in $(seq 1 50); do
  scripts/std.sh --what bid --from $month_from --to $month_to --rows 100 --page $p \
    >> bid_2026_04.jsonl
done

Data shapes (high-signal fields)

bid.sh (BidPublicInfoService) — non-exhaustive list:

contract.sh (CntrctInfoService) — non-exhaustive list:

std.sh --what awarded — non-exhaustive list:

Field names are stable inside each --what mode of std.sh but vary across the four 업무구분 in the non-std endpoints — always inspect a row before assuming a key exists.

Pairs naturally with

• nts-bizno-cli — resolve every bizrno in awarded records to a tax-type + business-status (KYB on the supplier side).
• juso-address-cli — geocode 수요기관/공고기관 addresses to a 행정동 + WGS84.
• kakao-local-cli — map-pin the resolved coordinates for a regional tender map.
• opendart-cli — cross-check listed-company awardees against their public disclosures (ownership, financials, related-party).
• kr-holiday-cli — calendar-overlay tenders to detect off-cycle posting (often a sign of urgency or favoritism).
• tistory-api-cli / velog-cli — publish daily/weekly tender-digest posts (e.g., "AI 입찰 모음 — 2026-04-29").

Implementation notes

• All endpoints accept both XML and JSON (type=json). This skill always asks for JSON; the wrapper will hard-fail with a clear message if the upstream returns XML (the 조달청 service silently falls back to XML on a serviceKey error).
• Date params on g2b are 12-digit YYYYMMDDHHMM — the wrapper validates this and provides a sensible default (last 7 days) when neither --from/--to nor --bid-no is given.
• inqryDiv (조회구분) defaults match what the official portal example shows: 1 for date-window queries, 3 for --bid-no, 4 for --instt-cd, 5 for --dminstt-cd. Override with --inquiry-div if you need 등록 vs. 공고게시 vs. 개찰일자 selection.
• The keyword search (--keyword) targets getBidPblancListInfoServcPPSSrch — only 용역 has a documented PPS keyword endpoint. For 물품/공사/외자, post-filter with jq 'select(.bidNtceNm | test("키워드"))' instead.
• The wrapper validates the response.header.resultCode == "00" envelope and surfaces resultMsg on failure — common codes: 30 (서비스키 미등록), 22 (LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS — daily quota hit), 11 (NODATA_ERROR — empty result, not a failure shape; the wrapper still treats this as an error so you'll know upstream returned nothing).

Examples

See examples/ for end-to-end recipes including: AI-keyword RFP digest, weekly 낙찰 ETL, awardee KYB pipeline, regional construction-contract map.

Key takeaways

• Three subcommands cover the entire 조달청 OpenAPI public surface. Pick std.sh first when you want one canonical schema; pick bid.sh / contract.sh when you need the per-업무구분 fields the open-standard feed strips.
• This is the read side of 나라장터; bid submission is intentionally out of scope.
• Pair with nts-bizno-cli for end-to-end awardee-vetting in a single shell pipeline — the missing piece between "the contract was awarded" and "the awardee is currently a 정상사업자".