getreadystack/dividenden-quellensteuer-lint repository overview

⁠Dividenden CSV Lint: Quellensteuer über DBA-Satz

Ausländische Dividenden versteuern ohne Überhang: Die Beispiel CSV mit 10 Dividenden ergibt 8 Findings und 495,00 € Quellensteuer über dem DBA-Satz, davon 120,00 € verfallen (Roche 2022, Frist 2025-12-31) und 200,00 € noch erstattbar bis 2026-12-31 (Nestlé 2023). Weitere Zeilen: Apple US 30 % = 60,00 € (W-8BEN fehlt), Novo Nordisk DK 27 % = 60,00 €, Enbridge CA 25 % = 30,00 €, Verbund AT 27,5 % = 25,00 €. 7 Regeln.

⁠Run

docker run --rm -v "$PWD":/work getreadystack/dividenden-quellensteuer-lint /work/file

The same 7 rules as the VS Code extension, in a container. Mount a folder on /work.

⁠Free

• Eine Broker-CSV prüfen: jede Dividende mit Quellensteuer über dem DBA-Satz, fehlendem W-8BEN oder Schweizer Frist, mit Euro-Betrag je Zeile.
• --rules lists every rule

⁠With a licence ($29 once)

• Alle Dividenden-CSVs im Workspace über mehrere Steuerjahre in einem Lauf, plus Report-Export für Steuerberater oder Erstattungsantrag.

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/dividenden-quellensteuer-lint --dir /work --ci

Steuerberater: Zeitgebühr 16,50–41,00 € je angefangene Viertelstunde (§ 13 StBVV, seit 1. Juli 2025) — eine Stunde Belegabgleich kostet bis zu 164,00 €.

⁠Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "dividenden-quellensteuer-lint": { "command": "npx", "args": ["-y", "@readystack/dividenden-quellensteuer-lint", "--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence). The agent gets every finding with the line number.

⁠Use in CI

- name: Dividenden CSV Lint: Quellensteuer über DBA-Satz
  run: npx -y @readystack/dividenden-quellensteuer-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/dividenden-quellensteuer-lint --dir /work --ci)

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence⁠