Communitygithub.com

magnusrodseth/skatteetaten-cli

非官方的、只读的CLI工具,用于从挪威税务局(Skatteetaten)的“我的税务”(Min skatt)获取您个人的挪威税务数据(税务卡、税务申报、税务结算)。支持BankID登录。专为AI代理设计。

skatteetaten-cli 是什么?

该技能为“skt”CLI工具提供基础支持,这是一个非官方、只读的客户端,用于访问挪威税务局(Skatteetaten)“我的税务”(Min skatt)门户中个人用户的挪威税务数据。它通过BankID模拟浏览器登录,捕获会话cookie,然后读取门户中未公开的内部JSON端点。由于没有官方API,该工具采用保守设计,仅允许只读操作(如查询税务卡、税务申报和税务结算),严禁任何提交、编辑或修改操作。该技能支持多种会话存储后端(系统钥匙串、1Password、文件),并提供带--json标志的机器可读输出,方便AI代理进行程序化处理。主要用例是将税务数据与银行记录(如通过SpareBank 1 CLI获取的数据)进行核对,确保税务数字与银行实际报告一致。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add magnusrodseth/skatteetaten-cli

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

skatteetaten-shared

skt CLI 的基础技能,这是一个非官方、只读的客户端,用于个人在挪威税务局(Skatteetaten)我的税务(Min skatt)门户上的挪威税务数据。在使用任何其他 skatteetaten 技能之前,请先阅读本文。

这是真实、敏感的税务数据,且该工具非官方。请谨慎使用。 skt 背后没有官方 API:它像浏览器一样通过用户的 BankID 登录,并使用会话 cookie 读取门户的未公开的内部 JSON 端点。它是只读的(从不提交或编辑),且必须仅用于用户自己的数据。切勿虚构金额、账号或年份,只能基于命令返回的内容或用户明确说明的信息进行操作。如果用户要求提交/编辑/修改,请拒绝——这已明确超出范围。参见 TERMS.md。

安装与首次设置

cargo install --path .        # 安装 `skt` 可执行文件

一次性操作,用户必须自行完成(需要其 BankID 和浏览器):

  1. 安装 Google Chrome 或 Chromium(仅在登录期间使用)。
  2. 运行 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 已自动对其进行脱敏处理)。

相关技能