hometax
A command-line tool that logs into Hometax with a certificate to query e-tax invoices, business cards, card sales, cash receipts, business accounts and counterparties. Unofficial — use only with your own certificate and business, at your own risk.
#hometax#tax-invoice#korea#accounting#cli#unofficial#plugin
Install
Installation
/plugin marketplace add hjsh200219/hometax
/plugin install hometax@hometaxRequirements
- Claude Code (플러그인) 또는 uv로 명령줄 도구만 설치: `uv tool install git+https://github.com/hjsh200219/hometax`
- Python 3.12 이상, 사업자용 공동인증서(NPKI) — 개인 인증서로는 사업자 자료가 조회되지 않음
- 공식 API가 아님 — 홈택스 웹 화면의 내부 요청을 재현한 것이라 포털 규격이 바뀌면 멈추고, 국세청이 자동화 접근을 차단할 수 있음
- 본인 인증서와 본인 사업자에 대해서만 본인 책임으로 사용. 타인 자료를 대신 조회하는 용도는 국세청과 먼저 협의 필요(세무대리인 로그인은 미지원)
- 발행·정정·취소는 실제 세금 문서를 만듦 — README 기준 실제 전송 호환성은 미검증(모의 HTTP와 XML 서명까지만 확인), 거래처 등록·수정·삭제의 실제 반영도 미검증
- 플랫폼 검증은 macOS Apple Silicon만, 인증서 호환성은 보장하지 않음
Capabilities
What it does
- 01파일 기반 공동인증서(NPKI)로 로그인 — 명령줄 도구(`hometax`)·Python 라이브러리·로컬 HTTP API 세 경로가 같은 구현을 사용
- 02전자세금계산서 매출·매입 목록·합계·상세, 월별 매입매출과 거래처별 표, 예상 부가세
- 03사업용 신용카드 등록·매입내역, 신용카드 매출, 현금영수증 매입·매출, 사업용계좌, 등록 거래처 조회
- 04여러 사업자 — 인증서별 별칭·`--company`로 선택하고 세션은 인증서마다 따로 10분 보관해 자료가 섞이지 않음
- 05세금계산서 발행·정정·취소와 거래처 등록·수정·삭제는 `--yes` 없이는 홈택스로 아무것도 보내지 않는 미리보기 방식
- 06비밀번호는 저장하지 않고 명령 인자로도 받지 않음 — `HOMETAX_PW` 환경변수 또는 프롬프트
- 07홈택스가 한 번에 3개월까지만 조회하므로 긴 기간은 자동으로 나눠 불러 합침
About
About
hometax logs into the Korean tax portal Hometax with a file-based public certificate (NPKI) and reads e-tax invoices, business cards, card sales, cash receipts, business accounts and registered counterparties. The same implementation is exposed as a command-line tool, a Python library and a local HTTP API, and also installs as a Claude Code plugin.
It is explicitly unofficial: it replays requests used by the Hometax web screens rather than any API issued by the tax service, so it stops if the portal changes and the tax service may block automated access. It should be used only with your own certificate and business, at your own risk, and anyone querying other people's data on their behalf is told to consult the tax service first. Issuing, correcting and cancelling invoices create real tax documents and only send with --yes; the README states that real-world transmission of these is still unverified, as is applying counterparty edits. Verification so far covers macOS on Apple Silicon.
Related
More in this category
hiworksA plugin that logs into Hiworks without a browser and exposes mail, leave, approvals, calendar and the org chart as JSON. The password lives only in the OS keychain. Unofficial — not affiliated with Hiworks.lyn-lawfirmThe plugin that bundles the six lyn-* legal skills — complaint, certified letter, criminal settlement and fact confirmation drafting, a criminal procedure simulator and a sentencing predictor — plus a K Data MCP connection for law and case search. AI can make mistakes; not legal advice.sttImports Clova Note transcripts and transcribes Apple Voice Memos or exported recordings locally on your Mac with whisper.cpp, saving everything as Markdown notes for a vault. Apple recordings are never uploaded.