← Back to Skills Marketplace
NTS BizNo CLI
by
Chloe Park
· GitHub ↗
· v0.1.0
· MIT-0
58
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install nts-bizno-cli
Description
Verify Korean business registration numbers (사업자등록번호) via the official NTS (국세청) public API. Operating-status lookup (계속/휴업/폐업), full authenticity check (b_n...
Usage Guidance
This skill's code matches its description: it locally validates and formats Korean business numbers and calls the official NTS endpoints via api.odcloud.kr. However the registry metadata is incorrect/missing: the scripts require an NTS_API_KEY (the encoded serviceKey from data.go.kr) and runtime binaries (bash, curl, jq), but the metadata states none. Before installing or running: 1) Inspect the scripts (they are plain bash) and confirm NTS_BASE points to the official api.odcloud.kr. 2) Do not paste your main long-lived credentials in places that other users/processes can see; the script sends the API key as a URL query parameter (serviceKey=...), which can appear in proxy logs or process arguments on some systems — consider using ephemeral/rotated keys and store the key in a secrets manager. 3) Ask the publisher (or upstream source) to correct the registry metadata to declare NTS_API_KEY and required binaries. 4) Run the scripts in a controlled environment (non-root, limited network scope) the first time and verify outputs. 5) If you plan to run bulk checks in CI or servers, ensure quota and rate limits are acceptable and that the encoded key is handled securely. If you cannot verify the origin (source unknown), prefer to review and run the included scripts locally rather than granting any automated agent persistent access.
Capability Analysis
Type: OpenClaw Skill
Name: nts-bizno-cli
Version: 0.1.0
The nts-bizno-cli skill bundle is a legitimate utility for verifying Korean business registration numbers via the official National Tax Service (NTS) API. The scripts (status.sh, validate.sh, bulk.sh) use standard tools like curl and jq to interact with the authorized api.odcloud.kr endpoint. The bundle includes a local checksum implementation in _common.sh that matches the official NTS algorithm, and there is no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Tags
Capability Assessment
Purpose & Capability
The code and SKILL.md consistently implement NTS business-number status/validation and local checksum formatting (matches the stated purpose). However the registry metadata claims 'Required env vars: none' and 'Required binaries: none' while the runtime scripts clearly require NTS_API_KEY and tools like curl and jq. This metadata omission is an incoherence that could mislead users or automated systems about the skill's true needs.
Instruction Scope
SKILL.md and the scripts limit actions to: local checksum/formatting, batching, and POSTing JSON to the documented odcloud/api endpoints (NTS via api.odcloud.kr). The scripts do not attempt to read other system secrets, home directories, or send data to unexpected endpoints. Error handling is explicit and network calls target the declared NTS_BASE (default api.odcloud.kr).
Install Mechanism
There is no external installer or download — the repository includes bash scripts and docs. No package downloads or extracted archives are present. This reduces supply-chain risk; you still need to inspect and run the included scripts locally.
Credentials
The runtime needs a single API credential (NTS_API_KEY / encoded serviceKey) which is appropriate for calling the NTS service. However the skill registry metadata does not declare this required environment variable or the required binaries (bash, curl, jq). The single credential requested is proportional to purpose, but the missing declaration is misleading and could cause accidental exposure or misconfiguration.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide settings, and does not persist credentials beyond standard environment variables. It only runs as invoked and makes outbound requests to the NTS endpoint.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nts-bizno-cli - After installation, invoke the skill by name or use
/nts-bizno-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release.
- status: POST /v1/status — 사업자 상태조회 (계속/휴업/폐업, 과세유형). Up to 100 b_no per call.
- validate: POST /v1/validate — 진위확인 (b_no + 개업일 + 대표자명 NTS match).
- format: local checksum + XXX-XX-XXXXX formatter. No API key required.
- bulk: file-driven sweep with checksum pre-filter, auto-batched 100/req.
Pure bash + curl + jq. JSONL output for jq pipelines.
Pairs with unified-invoice, opendart-cli, juso-address-cli.
Metadata
Frequently Asked Questions
What is NTS BizNo CLI?
Verify Korean business registration numbers (사업자등록번호) via the official NTS (국세청) public API. Operating-status lookup (계속/휴업/폐업), full authenticity check (b_n... It is an AI Agent Skill for Claude Code / OpenClaw, with 58 downloads so far.
How do I install NTS BizNo CLI?
Run "/install nts-bizno-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is NTS BizNo CLI free?
Yes, NTS BizNo CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does NTS BizNo CLI support?
NTS BizNo CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created NTS BizNo CLI?
It is built and maintained by Chloe Park (@chloepark85); the current version is v0.1.0.
More Skills