popbill

nomadamas/k-skill

Safely call Popbill Korean tax invoice, receipt, and business info APIs in test/production environments.

What is popbill?

Popbill is a Korean business service API for electronic tax invoices, statements, cash receipts, messaging, and corporate information lookup. Use this skill to integrate Popbill API calls into your agent workflows while respecting legal boundaries and requiring explicit user approval for sensitive operations.

Call Popbill APIs for e-tax invoices, e-statements, and cash receipts in test or production mode
Send messages via SMS, KakaoTalk, and fax through Popbill
Look up business closure/opening status and corporate information
Query account information and HomeTax data collection
Execute follow-up actions through official Popbill surfaces in Dolshoi vault/CloakBrowser environments
Enforce hard rules: no payment execution, credential storage, or boundary bypass without explicit user approval

How to install popbill

npx skills add https://github.com/nomadamas/k-skill --skill popbill

Prerequisites

Node.js 18 or later
Popbill API credentials (API key and account)
Access to test or production Popbill environment

Claude Code

Cursor

Windsurf

Cline

How to use popbill

1.Run `npx -y @nomadamas/k-skill@0 instruct popbill` to get runtime-specific instructions
2.Review the legal disclaimer by running `npx -y @nomadamas/k-skill@0 read popbill references/DISCLAIMER.md`
3.Obtain and securely store your Popbill API credentials (never in plaintext)
4.Call the appropriate Popbill API endpoint for your use case (invoices, receipts, messaging, or lookup)
5.For sensitive operations (payments, submissions, cancellations), obtain explicit user approval before execution
6.Keep the skill and CLI updated with `npx -y @nomadamas/k-skill@0 update`

Use cases

Good for

Automate Korean business invoice and receipt generation workflows
Integrate corporate information verification into onboarding processes
Send bulk business notifications via SMS, KakaoTalk, or fax
Query business status and account details for compliance checks
Test Popbill integrations safely before production deployment

Who it's for

Korean business developers integrating Popbill APIs
Finance and accounting teams automating invoice workflows
Compliance and verification specialists
Agents requiring Korean business data lookup capabilities

popbill FAQ

Do I need explicit user approval for all Popbill operations?

No. Only payment execution, message/email delivery, final submission, cancellation, and public posting require explicit user approval immediately beforehand. Lookups and reads do not.

Can I use this skill for bulk crawling or database building?

No. Automated collection must be limited to personal, non-organizational lookup only. Systematic crawling, database building, or interference with third-party services is prohibited.

What should I do if I don't have the CLI available?

Install Node.js 18+ or follow the GitHub readme at https://github.com/NomaDamas/k-skill. You can also read source instructions at https://github.com/NomaDamas/k-skill/blob/main/popbill/instruction.md.

How do I handle credentials securely?

Never ask for, print, or store plaintext credentials in chat, files, or shell arguments. Use your agent's secure credential storage mechanism.

What runtimes does this skill support?

The skill detects your runtime (Dolshoi vault/CloakBrowser vs generic) and prints only applicable instructions via the CLI.

Full instructions (SKILL.md)

Source of truth, from nomadamas/k-skill.

name: popbill description: 팝빌 전자세금계산서·전자명세서·현금영수증·문자·카카오톡·팩스·휴폐업/기업정보·계좌조회·홈택스 수집을 테스트/운영 환경에서 안전하게 호출한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다. license: MIT metadata: category: business locale: ko-KR phase: v1

popbill

Get the full instructions (required first step)

Run this and follow its output as the primary instructions for this skill:

npx -y @nomadamas/k-skill@0 instruct popbill

The CLI detects the current runtime (Dolshoi vault/CloakBrowser vs generic) and prints only the applicable instructions, always up to date. Helper files bundled with the CLI are listed by:

npx -y @nomadamas/k-skill@0 files popbill

Keep the CLI and every coding-agent skill install current (including Vercel Agent Skills) with:

npx -y @nomadamas/k-skill@0 update

If npx is unavailable, install Node.js 18+ or follow https://github.com/NomaDamas/k-skill#readme, or read the source instructions at https://github.com/NomaDamas/k-skill/blob/main/popbill/instruction.md.

Legal disclaimer (required)

This skill is not an official feature of, officially supported by, affiliated with, sponsored by, approved by, or developed in collaboration with any third-party trademark owner or service operator it identifies. Third-party names are used only to describe the skill's function, lookup target, or compatibility.

Any automated collection of publicly accessible information must be limited to personal, non-organizational lookup. Do not use this skill for systematic or bulk crawling, database building, access-control or block circumvention, or conduct that interferes with a third party's business or service.

Read the full Korean legal disclaimer, including the cited Korean Supreme Court precedents and statutory limits, before use:

npx -y @nomadamas/k-skill@0 read popbill references/DISCLAIMER.md

Hard rules even without the CLI

Never execute payment, message/email delivery, final submission, cancellation, or public posting without the user's explicit approval immediately beforehand.
Never ask for, print, or store plaintext credentials in chat, files, or shell arguments.
Never bypass legal, physical-presence, CAPTCHA, identity-proofing, or electronic-signature boundaries.