Communitygithub.com

magnusrodseth/skatteetaten-cli

CLI não oficial e somente leitura para seus próprios dados fiscais noruegueses do Min skatt (skattekort, skattemelding, skatteoppgjør). Login com BankID. Projetado para agentes de IA.

O que é skatteetaten-cli?

Esta skill fornece acesso somente leitura a dados fiscais pessoais noruegueses através do portal Min skatt da Skatteetaten, usando o CLI `skt` não oficial. Ela permite que agentes de IA consultem o skattekort (cartão fiscal), skattemelding (declaração de imposto) e skatteoppgjør (acerto fiscal) do usuário, autenticando via BankID como um navegador comum. É particularmente útil para reconciliar dados fiscais com extratos bancários reais, comparando depósitos e juros informados pelo fisco com os obtidos via skills bancárias como as do SpareBank 1. A skill enfatiza segurança e precisão: é estritamente somente leitura, usa a sessão do usuário (curta duração, sem refresh token), e jamais deve inventar valores ou fazer alterações. O formato de saída padrão é tabelas legíveis, mas o modo JSON (`--json`) é recomendado para consumo programático por agentes. O login inicial exige interação manual do usuário com o BankID, e sessões expiradas exigem novo login.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add magnusrodseth/skatteetaten-cli

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

skatteetaten-shared

Skill base para o CLI skt, um cliente não oficial, somente leitura dos próprios dados fiscais noruegueses de uma pessoa física no portal Min skatt da Skatteetaten. Leia isto antes de usar qualquer outra skill skatteetaten.

São dados fiscais reais e sensíveis, e esta ferramenta é não oficial. Seja conservador. skt não possui API oficial por trás: ele faz login com o BankID do usuário como um navegador e lê os endpoints JSON internos não documentados do portal usando o cookie de sessão. É somente leitura (nunca envia ou edita) e deve ser usado exclusivamente sobre os próprios dados do usuário. Nunca invente valores, números de conta ou anos; aja apenas com base no que os comandos retornam ou no que o usuário informa. Se o usuário solicitar um envio/edição/alteração, recuse — está deliberadamente fora do escopo. Consulte TERMS.md.

Instalação e configuração inicial

cargo install --path .        # instala o binário `skt`

Uma vez, o usuário deve fazer isso pessoalmente (precisa do BankID e de um navegador):

  1. Ter o Google Chrome ou Chromium instalado (usado apenas durante o login).
  2. skt login — abre um navegador; o usuário completa o BankID; skt captura o cookie de sessão do Min skatt via CDP e o armazena.

Não execute skt login em nome do usuário sem perguntar — ele abre um navegador e dispara um fluxo interativo de BankID.

Autenticação e modelo de sessão

skt status     # quando foi capturada? qual backend de armazenamento?
skt whoami     # verificação real mais barata — valida a sessão, imprime o nome do usuário
skt logout     # remove a sessão armazenada

Não há token de atualização. Diferente de um CLI OAuth normal, as sessões do Min skatt são curtas e expiram silenciosamente. Consequências para você:

  • Se uma leitura falhar com erro de autenticação (ou skt whoami falhar), a sessão expirou — diga ao usuário para executar skt login novamente. Não tente novamente em loop.
  • skt status mostra o momento da captura, mas não pode provar validade; apenas uma requisição pode. Use skt whoami para verificar antes de um lote de leituras.

Os segredos ficam em um de três backends, escolhido por SKT_STORE:

SKT_STOREOnde
não definido / keychainKeychain do SO (macOS Keychain / Linux keyutils / Windows Credential Manager), padrão
op / 1password1Password via o CLI op (SKT_OP_VAULT, SKT_OP_ACCOUNT)
file~/.config/skatteetaten-cli/*.json (0600), texto puro, opt-in para uso headless

Saída e flags

  • A saída padrão são tabelas legíveis para humanos (valores noruegueses: kr 1 234,56).
  • Adicione --json a qualquer comando para saída legível por máquina — use sempre isso ao processar programaticamente.
  • Adicione --mask para ocultar valores e números de conta nas tabelas (para capturas de tela).
  • Erros são impressos no stderr com código de saída não zero.

Mapa de comandos

ComandoFinalidade
login / logout / status / whoamiautenticação e saúde da sessão
skattekortitens da linha do cartão fiscal para o ano ativo (rótulos vindos do dicionário do portal)
skattemelding [--year N]declaração de imposto para um ano (padrão é o mais recente entregue)
oppgjorskatteoppgjør / página inicial do Min skatt (restskatt, conta, KID) — JSON bruto

Anos: skattekort usa o ano de renda ativo da configuração do portal; skattemelding usa como padrão o ano anterior. Use --year para escolher outro.

Reconciliação com o banco (o caso de uso principal)

O objetivo do skt é verificar os números do fisco contra a realidade:

skt skattemelding --json | jq '.visningsdata.konto[]
  | {bank: .bankensNavn, konto: .kontonummer,
     innskudd: .innskudd.beloep, renter: .opptjenteRenter.beloep}'

Cada entrada konto é uma conta bancária com seu depósito e juros ganhos conforme a Skatteetaten os possui. Cruze esses dados com sb1 (o CLI do SpareBank 1): os saldos e juros correspondem ao que o banco realmente reporta? Use as skills sparebank1-* para o lado bancário.

Etiqueta

Endpoints não documentados e não oficiais. Faça uma requisição por chamada; nunca adicione loops de tentativas/polling. Mantenha tudo somente leitura e sobre os próprios dados do usuário. Nunca exponha o cookie de sessão na saída (o CLI já o redaciona).

Habilidades Relacionadas