hometax
공동인증서로 홈택스에 로그인해 전자세금계산서·사업용카드·카드매출·현금영수증·사업용계좌·거래처를 조회하는 명령줄 도구. 비공식이며 본인 인증서·본인 사업자에만, 본인 책임으로 사용해야 한다.
#hometax#tax-invoice#korea#accounting#cli#unofficial#plugin
Install
설치
/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
주요 기능
- 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
같은 카테고리의 다른 도구
hiworks브라우저 없이 하이웍스 로그인 세션을 만들어 메일·휴가·결재·일정·조직도를 JSON으로 다루는 플러그인. 비밀번호는 OS 키체인에만 저장한다. 하이웍스와 무관한 비공식 프로젝트.lyn-lawfirm고소장·내용증명·형사합의서·사실확인서 작성, 형사절차 시뮬레이터, 양형 예측 등 lyn-* 법률 스킬 6종을 한 번에 설치하는 플러그인. 법령·판례 검색은 K Data MCP 연결 설정을 포함한다. AI는 실수할 수 있으며 법률 자문이 아니다.stt클로바노트 전사를 가져오고 Apple 음성 메모·내보낸 녹음은 이 Mac에서 whisper.cpp로 로컬 전사해 Markdown 노트(vault)로 저장하는 플러그인. Apple 녹음은 외부로 업로드하지 않는다.