skatteetaten-shared
skt CLI의 기반 스킬입니다. 비공식, 읽기 전용 클라이언트로, 개인이 자신의 노르웨이 세금 데이터를 Skatteetaten의 Min skatt 포털에서 가져옵니다. 다른 skatteetaten 스킬을 사용하기 전에 이 문서를 먼저 읽으십시오.
이것은 실제 민감한 세금 데이터이며, 이 도구는 비공식입니다. 신중하게 사용하십시오. skt는 공식 API가 없습니다. 브라우저처럼 사용자의 BankID로 로그인한 후, 포털의 문서화되지 않은 내부 JSON 엔드포인트를 세션 쿠키로 읽습니다. 읽기 전용이며(제출하거나 수정하지 않음), 오직 사용자 본인의 데이터에만 사용해야 합니다. 금액, 계좌 번호, 연도를 절대 임의로 생성하지 말고, 명령어가 반환하는 값이나 사용자가 명시한 값만을 사용하십시오. 사용자가 제출/편집/변경을 요청하면 거절하십시오. 이는 의도적으로 범위 밖입니다. TERMS.md를 참조하십시오.
설치 및 첫 설정
cargo install --path . # `skt` 바이너리 설치
한 번, 사용자가 직접 수행해야 합니다(BankID와 브라우저 필요):
- Google Chrome 또는 Chromium이 설치되어 있어야 합니다(로그인 시에만 사용됨).
skt login— 브라우저가 열리면 사용자가 BankID 인증을 완료하고,skt는 CDP를 통해 Min skatt 세션 쿠키를 캡처하여 저장합니다.
사용자 허락 없이 skt login을 실행하지 마십시오. 브라우저를 열고 대화형 BankID 흐름을 시작합니다.
인증 및 세션 모델
skt status # 캡처 시간? 어떤 스토리지 백엔드?
skt whoami # 가장 저렴한 실시간 확인 — 세션을 검증하고 사용자 이름 출력
skt logout # 저장된 세션 제거
리프레시 토큰이 없습니다. 일반 OAuth CLI와 달리 Min skatt 세션은 수명이 짧고 조용히 만료됩니다. 결과:
- 읽기 명령이 인증 오류로 실패하거나
skt whoami가 실패하면 세션이 만료된 것입니다. 사용자에게skt login을 다시 실행하라고 알리십시오. 루프로 재시도하지 마십시오. skt status는 캡처 시간을 보여주지만 유효성을 증명할 수 없습니다. 요청을 보내야만 확인 가능합니다. 읽기 배치 전에skt whoami를 사용하여 확인하십시오.
비밀 정보는 SKT_STORE 환경 변수로 선택된 세 가지 백엔드 중 하나에 저장됩니다:
SKT_STORE | 위치 |
|---|---|
설정 안 함 / keychain | OS 키체인(macOS Keychain / Linux keyutils / Windows Credential Manager), 기본값 |
op / 1password | 1Password (op CLI 사용, SKT_OP_VAULT, SKT_OP_ACCOUNT) |
file | ~/.config/skatteetaten-cli/*.json (0600 권한), 평문, 헤드리스 사용을 위해 선택 사항 |
출력 및 플래그
- 기본 출력은 사람이 읽을 수 있는 테이블입니다(노르웨이 금액 형식:
kr 1 234,56). - 모든 명령어에
--json을 추가하여 기계가 읽을 수 있는 출력을 얻을 수 있습니다. 프로그램적으로 파싱할 때는 항상 사용하십시오. --mask를 사용하면 테이블에서 금액과 계좌 번호를 숨깁니다(스크린샷용).- 오류는 stderr에 출력되며 0이 아닌 종료 코드를 반환합니다.
명령어 맵
| 명령어 | 목적 |
|---|---|
login / logout / status / whoami | 인증 및 세션 상태 확인 |
skattekort | 현재 과세 연도의 세금 카드 항목(포털 사전의 레이블과 결합됨) |
skattemelding [--year N] | 특정 연도의 세금 신고(기본값: 가장 최근에 제출된 것) |
oppgjor | 세금 정산 / Min skatt 랜딩 페이지(잔여 세금, 계좌, KID) — 원시 JSON |
연도: skattekort는 포털 설정의 현재 소득 연도를 사용합니다. skattemelding은 기본적으로 그 전 연도로 설정됩니다. --year를 사용하여 다른 연도를 선택할 수 있습니다.
은행 계좌와 대조하기 (주 사용 사례)
skt의 목적은 세무청의 숫자를 실제와 비교하는 것입니다:
skt skattemelding --json | jq '.visningsdata.konto[]
| {bank: .bankensNavn, konto: .kontonummer,
innskudd: .innskudd.beloep, renter: .opptjenteRenter.beloep}'
각 konto 항목은 은행 계좌이며, Skatteetaten이 기록한 입금액과 이자 소득이 포함되어 있습니다. 이를 sb1(SpareBank 1 CLI)과 대조하십시오: 잔액과 이자가 은행이 실제로 보고하는 것과 일치합니까? 은행 측에는 sparebank1-* 스킬을 사용하십시오.
에티켓
문서화되지 않은 비공식 엔드포인트입니다. 호출당 한 번의 요청만 보내십시오. 절대 재시도/폴링 루프를 추가하지 마십시오. 모든 것을 읽기 전용으로 유지하고 사용자 본인의 데이터에 대해서만 작업하십시오. 세션 쿠키를 출력에 노출하지 마십시오(CLI는 이미 이를 삭제합니다).