📊 TaxFormatter

Krypto-CSVs und Kontoauszugs-PDFs, umgewandelt in steuerfertige Daten.

REST-API · MCP-Server · Node-SDK · Python-SDK · Endbenutzer-Dashboard

🚀 Was es tut

TaxFormatter verwandelt unübersichtliche Finanzexporte in strukturierte, steuerfertige Daten – für Menschen und für KI-Agenten.

Laden Sie eine CSV von Coinbase, eine ZIP von Kraken, eine .tar.gz von Binance oder einen PDF-Kontoauszug von Chase hoch und erhalten Sie einen sauberen, normalisierten Transaktionssatz zurück, den Sie in Koinly, TurboTax, CoinLedger, ZenLedger – oder direkt in Ihre eigene Software – einspeisen können.

   Exchange CSV                        Clean, normalized
   Bank PDF              →             transactions (JSON / CSV)
   XLSX / ZIP / TAR.GZ                 + AI-generated insights

✨ Funktionen

🔌 Entwickler-REST-API

Integrieren Sie eine Funktion für Krypto-Steuern oder Bankdaten-Import an einem Nachmittag in Ihr Produkt.

• POST /v1/parse — CSV oder PDF hochladen, strukturiertes JSON zurückerhalten

• GET /v1/sources — Alle unterstützten Börsen, Banken und Ausgabeformate auflisten

• GET /v1/usage — Monatliches Kontingent, RPM-Limit, aktueller Verbrauch

• GET /v1/health — Liveness-Probe

• Auth: X-API-Key-Header mit tf_live_*-Schlüsseln (im Ruhezustand SHA-256 gehasht)

• Host: https://api.taxformatter.com

🤖 MCP-Server für KI-Agenten

Ermöglichen Sie Claude, Cursor, Windsurf oder jedem MCP-kompatiblen Agenten, Krypto- und Bankdaten direkt zu analysieren.

npx @taxformatter/mcp-server

📦 Offizielle SDKs

• Node.js → @taxformatter/sdk — versprechensbasiert, vollständig typisiert

• Python → taxformatter — idiomatisch, mit Typ-Hinweisen

🏦 14 Börsen · 7+ Banken · 4 Steuer-Software-Formate

Börsen: Coinbase · Kraken · Gemini · Binance · Robinhood · Crypto.com · PayPal · Cash App · Venmo · KuCoin · Bybit · FTX · Bitfinex · OKX

Banken: Chase · Mercury · Navy Federal · Bank of America · Wells Fargo · Citi · Capital One

Exportformate: Koinly · TurboTax (Form 8949) · CoinLedger · ZenLedger

🧠 Gestaffelte KI-Einblicke

Jede analysierte Datei wird mit einer umsetzbaren Analyse zurückgegeben – skaliert auf Ihren Plan.

🖥️ Endbenutzer-Dashboard

Kein Entwickler? Die Web-App unter taxformatter.com bietet eine vollständige Drag-and-Drop-Erfahrung mit Echtzeit-Jobstatus, automatischer Börsenerkennung, Transformationsvorschauen und Downloads mit einem Klick.

🏗️ Tech-Stack

📁 Repo-Struktur

trw/
├── app/                 # Next.js App Router (marketing, dashboard, /v1 admin)
│   ├── api/             # Internal API routes (NextAuth, uploads, jobs, dev keys)
│   ├── dashboard/       # Authenticated user area + /dashboard/developer
│   ├── docs/            # MDX-powered docs site
│   └── upload/          # Anonymous bank statement → CSV landing page
│
├── backend/             # Python processing layer (AWS Lambda)
│   ├── handlers/        # scanner · processor · webhook · api
│   ├── services/
│   │   ├── engine.py            # CSV parsing (14 exchange parsers)
│   │   ├── format_converter.py  # Koinly → TurboTax/CoinLedger/ZenLedger
│   │   ├── fingerprinting.py    # Exchange auto-detection
│   │   ├── ai_insights.py       # Tiered AI analysis
│   │   ├── api_auth.py          # API key validation + rate limiting
│   │   └── bank_statement/      # PDF extraction pipeline
│   ├── configs/banks/*.yaml     # YAML-driven bank configs
│   └── terraform/               # Infra as code
│
├── packages/
│   ├── mcp-server/      # @taxformatter/mcp-server (npm)
│   ├── sdk-node/        # @taxformatter/sdk (npm)
│   └── sdk-python/      # taxformatter (PyPI)
│
├── components/          # React components (marketing, dashboard, ui)
├── lib/                 # Business logic (auth, api-keys, stripe, email)
├── db/                  # PostgreSQL schema + migrations
└── docs/                # Setup guides

Vollständige architektonische Referenz: ARCHITECTURE.md

⚡ Schnellstart

Web-App ausführen

npm install
npm run dev

Öffnen Sie http://localhost:3000.

API ausprobieren

curl -X POST https://api.taxformatter.com/v1/parse \
  -H "X-API-Key: tf_live_..." \
  -F "file=@coinbase.csv"

MCP-Server mit Claude Code verwenden

{
  "mcpServers": {
    "taxformatter": {
      "command": "npx",
      "args": ["@taxformatter/mcp-server"],
      "env": { "TAXFORMATTER_API_KEY": "tf_live_..." }
    }
  }
}

Node-SDK installieren

npm install @taxformatter/sdk

import { TaxFormatter } from "@taxformatter/sdk";

const tf = new TaxFormatter({ apiKey: process.env.TF_API_KEY! });
const result = await tf.parse({ file: fs.createReadStream("./coinbase.csv") });

🧪 Testen

npm test              # Jest unit tests (160+ across API, MCP, keys, UI)
npm run test:e2e      # Playwright end-to-end tests
npm run typecheck     # TypeScript strict mode
npm run lint          # ESLint

💳 Preisgestaltung

Endbenutzer (Dashboard)

Entwickler (API)

🔒 Sicherheits-Highlights

• Zustandslose API-Verarbeitung — Dateiinhalte verbleiben nur im Lambda-RAM, niemals auf die Festplatte geschrieben

• Keine Payload-Protokollierung — api_requests speichert nur Metadaten (Hash, Status, Bytes, Timing)

• API-Schlüssel SHA-256 gehasht im Ruhezustand, mit Präfix tf_live_ zur einfachen Identifizierung

• TLS 1.3 überall erzwungen

• AES-256-Verschlüsselung für alle gespeicherten Uploads

• AWS WAF — DDoS-Schutz, SQL-Injection, XSS-Mitigation

• Benutzergesteuerte Aufbewahrung — Standardmäßig 1 Jahr oder Löschung nach Download

Vollständige Offenlegung unter taxformatter.com/security.

📚 Dokumentation

• ARCHITECTURE.md — Vollständiges Systemdesign

• content/docs/api/index.md — API-Referenz

• packages/mcp-server/README.md — MCP-Einrichtungsanleitung

• RELIABILITY.md — SLOs, Vorfall-Playbooks

• docs/ — Stripe-, Sentry- und Bereitstellungsanleitungen

Lizenz

Privat — Quantum Transfer Group. Alle Rechte vorbehalten.