Back to Skills

g2b-sanctioned-supplier

조달청 나라장터 부정당제재업체정보를 공공데이터포털 API(k-skill-proxy 경유)로 조회한다. 사업자등록번호 정확 일치로 조회시점 현재 유효한 입찰참가자격 제한(부정당제재)의 기간·제재기관·근거법률을 확인한다.

7,205stars884forksUpdated 8/17/2026

Security Assessment

Safe(94/100)
Security Score94/100

About g2b-sanctioned-supplier

This skill checks whether a Korean supplier currently carries an active bidding-restriction sanction (부정당제재) by querying the Public Procurement Service's Nara Marketplace user-information service (data.go.kr dataset 15129466, `getUnptRsttCorpInfo02`) through the `k-skill-proxy`. Given a 10-digit business registration number for an exact match, it returns the sanction start/end dates, sanctioning agency, contract-law classification, and legal basis as raw upstream fields. It solves the pre-transaction due-diligence need of confirming, at query time, whether a counterparty is barred from public bidding.

A key design boundary is honesty about coverage: the upstream service only returns sanctions that are valid as of the query moment. Expired or lifted sanctions, and sanctions against unregistered suppliers or individuals, are not provided — so this is not a historical-record lookup, and the instructions direct users to Nara Marketplace (g2b.go.kr) for manual checks of expired history. The skill reports only upstream facts, sources, and coverage limits, with no invented scoring or grading.

The published entry is a CLI stub that defers to `npx -y @nomadamas/k-skill@0 instruct g2b-sanctioned-supplier` for live instructions, and runs the bundled `scripts/g2b_sanctioned_supplier.py` helper with a required `--bizno`. It targets procurement, compliance, and vendor-risk users. No user-side secret is required; the data.go.kr key lives only on the proxy, and the skill's hard rules forbid storing plaintext credentials and bypassing legal boundaries.

FAQ

What input does it need?

A required `--bizno`: a 10-digit business registration number (hyphens allowed). It matches exactly against currently-valid sanctions.

Does it show past or expired sanctions?

No. The upstream service only returns sanctions valid at query time. Expired/lifted sanctions and sanctions against unregistered suppliers or individuals are not provided; check g2b.go.kr manually for expired history.

Are any credentials required from me?

No user-side secret. `DATA_GO_KR_API_KEY` is set only on the proxy server, which must be approved for dataset 15129466. Optionally set `KSKILL_PROXY_BASE_URL` for a self-hosted proxy.

What does a zero-count result mean?

`total_count = 0` means no sanction is currently valid for that business number — but remember expired and unregistered-entity sanctions are simply not covered by this dataset.

All Files

4 files
instruction.md1.7 KB
View
scripts/g2b_sanctioned_supplier.py4.3 KB
View
skill.json0.5 KB
View
SKILL.md1.4 KB
View

Install g2b-sanctioned-supplier

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill