skatteetaten-shared
skt CLI 的基础技能,这是一个非官方、只读的客户端,用于个人在挪威税务局(Skatteetaten)我的税务(Min skatt)门户上的挪威税务数据。在使用任何其他 skatteetaten 技能之前,请先阅读本文。
这是真实、敏感的税务数据,且该工具非官方。请谨慎使用。 skt 背后没有官方 API:它像浏览器一样通过用户的 BankID 登录,并使用会话 cookie 读取门户的未公开的内部 JSON 端点。它是只读的(从不提交或编辑),且必须仅用于用户自己的数据。切勿虚构金额、账号或年份,只能基于命令返回的内容或用户明确说明的信息进行操作。如果用户要求提交/编辑/修改,请拒绝——这已明确超出范围。参见 TERMS.md。
安装与首次设置
cargo install --path . # 安装 `skt` 可执行文件
一次性操作,用户必须自行完成(需要其 BankID 和浏览器):
- 安装 Google Chrome 或 Chromium(仅在登录期间使用)。
- 运行
skt login——这会打开一个浏览器;用户完成 BankID 验证;skt通过 CDP 捕获“我的税务”会话 cookie 并存储。
请勿未经询问就代表用户运行 skt login——它会打开浏览器并触发交互式 BankID 流程。
身份验证与会话模型
skt status # 捕获时间?哪个存储后端?
skt whoami # 最便宜的实时检查——验证会话,打印用户姓名
skt logout # 删除存储的会话
没有刷新令牌。 与普通的 OAuth CLI 不同,“我的税务”会话是短暂的,并且会静默超时。对您的影响:
- 如果读取操作因身份验证错误而失败(或
skt whoami失败),则表示会话已过期——告诉用户再次运行skt login。请勿在循环中重试。 skt status显示捕获时间,但无法证明有效性;只有发起请求才能验证。在批量读取之前,使用skt whoami进行检查。
凭据存储在三个后端之一,由 SKT_STORE 选择:
SKT_STORE | 存储位置 |
|---|---|
未设置 / keychain | 操作系统钥匙串(macOS 钥匙串 / Linux keyutils / Windows 凭据管理器),默认 |
op / 1password | 通过 op CLI 的 1Password(SKT_OP_VAULT、SKT_OP_ACCOUNT) |
file | ~/.config/skatteetaten-cli/*.json(0600 权限),明文,选择加入,用于无头使用 |
输出与标志
- 默认输出是人类可读的表格(挪威语金额格式:
kr 1 234,56)。 - 在任何命令后添加
--json可获得机器可读输出——在编程解析时请始终使用此选项。 - 添加
--mask可隐藏表格中的金额和账号(用于截图)。 - 错误信息会打印到标准错误流(stderr),并返回非零退出码。
命令映射
| 命令 | 用途 |
|---|---|
login / logout / status / whoami | 身份验证与会话健康检查 |
skattekort | 当前有效年度的税务卡明细项目(标签来自门户的字典) |
skattemelding [--year N] | 指定年度的税务申报(默认为最近提交的年度) |
oppgjor | 税务结算 / “我的税务”首页(欠税、账户、KID)——原始 JSON 输出 |
年份:skattekort 使用门户配置中的当前收入年份;skattemelding 默认为前一年。使用 --year 选择其他年份。
与银行核对(主要用例)
skt 的目的是将税务局的数字与实际数据核对:
skt skattemelding --json | jq '.visningsdata.konto[]
| {bank: .bankensNavn, konto: .kontonummer,
innskudd: .innskudd.beloep, renter: .opptjenteRenter.beloep}'
每个 konto 条目是一个银行账户,包含税务局记录的存款和已赚取利息。将这些与 sb1(SpareBank 1 CLI)进行交叉核对:余额和利息是否与银行实际报告的一致?使用 sparebank1-* 技能获取银行方面的数据。
使用规范
未记录的、非官方的端点。每次调用只发起一个请求;切勿添加重试/轮询循环。保持只读,且仅针对用户自己的数据。切勿在输出中暴露会话 cookie(CLI 已自动对其进行脱敏处理)。