hometax
使用公认证书登录 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无需浏览器即可建立 Hiworks 登录会话,并以 JSON 处理邮件、休假、审批、日程与组织架构的插件。密码仅保存在系统钥匙串中。非官方项目,与 Hiworks 无关。lyn-lawfirm一次安装 lyn-* 六项法律技能的插件:起诉状、内容证明、刑事和解书、事实确认书的起草,刑事程序模拟器与量刑预测,并含用于法令、判例检索的 K Data MCP 连接配置。AI 可能出错,不构成法律意见。stt导入 Clova Note 转写内容,并用 whisper.cpp 在本机转写 Apple 语音备忘录或导出的录音,统一保存为 Markdown 笔记(vault)的插件。Apple 录音不会上传到外部。