📊 TaxFormatter

Крипто-CSV и банковские PDF-выписки, преобразованные в данные для налоговой отчетности.

REST API · MCP-сервер · Node SDK · Python SDK · Панель управления пользователя

🚀 Что это делает

TaxFormatter превращает разрозненные финансовые отчеты в структурированные данные, готовые для налоговой — как для людей, так и для ИИ-агентов.

Загрузите CSV из Coinbase, ZIP из Kraken, .tar.gz из Binance или PDF-выписку из Chase и получите чистый, нормализованный набор транзакций, который можно передать в Koinly, TurboTax, CoinLedger, ZenLedger — или напрямую в ваше собственное ПО.

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

✨ Функции

🔌 REST API для разработчиков

Внедрите функцию обработки крипто-налогов или банковских выписок в свой продукт за один день.

• POST /v1/parse — загрузите CSV или PDF, получите структурированный JSON

• GET /v1/sources — список всех поддерживаемых бирж, банков и форматов вывода

• GET /v1/usage — месячная квота, лимит RPM, текущее потребление

• GET /v1/health — проверка работоспособности

• Авторизация: заголовок X-API-Key с ключами tf_live_* (хешируются SHA-256 при хранении)

• Хост: https://api.taxformatter.com

🤖 MCP-сервер для ИИ-агентов

Дайте Claude, Cursor, Windsurf или любому MCP-совместимому агенту возможность напрямую анализировать крипто- и банковские данные.

npx @taxformatter/mcp-server

📦 Официальные SDK

• Node.js → @taxformatter/sdk — на основе промисов, с полной типизацией

• Python → taxformatter — идиоматичный, с подсказками типов

🏦 14 бирж · 7+ банков · 4 формата налогового ПО

Биржи: Coinbase · Kraken · Gemini · Binance · Robinhood · Crypto.com · PayPal · Cash App · Venmo · KuCoin · Bybit · FTX · Bitfinex · OKX

Банки: Chase · Mercury · Navy Federal · Bank of America · Wells Fargo · Citi · Capital One

Форматы экспорта: Koinly · TurboTax (форма 8949) · CoinLedger · ZenLedger

🧠 Многоуровневая ИИ-аналитика

Каждый обработанный файл возвращается с практическими выводами — в зависимости от вашего тарифного плана.

🖥️ Панель управления пользователя

Вы не разработчик? Веб-приложение на taxformatter.com предлагает полноценный интерфейс с перетаскиванием файлов (drag-and-drop), статусом задач в реальном времени, автоопределением бирж, предварительным просмотром преобразований и загрузкой в один клик.

🏗️ Технологический стек

📁 Структура репозитория

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

Полная архитектурная справка: ARCHITECTURE.md

⚡ Быстрый старт

Запуск веб-приложения

npm install
npm run dev

Откройте http://localhost:3000.

Попробуйте API

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

Используйте MCP-сервер с Claude Code

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

Установите Node SDK

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") });

🧪 Тестирование

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

💳 Тарифы

Потребительский (панель управления)

Разработчикам (API)

🔒 Основные аспекты безопасности

• Stateless API-обработка — содержимое файла находится только в оперативной памяти Lambda, никогда не записывается на диск

• Отсутствие логирования полезной нагрузки — api_requests хранит только метаданные (хеш, статус, байты, время)

• API-ключи хешируются SHA-256 при хранении, имеют префикс tf_live_ для легкой идентификации

• TLS 1.3 принудительно используется везде

• AES-256 шифрование всех сохраненных загрузок

• AWS WAF — защита от DDoS, SQL-инъекций, XSS

• Контролируемое пользователем хранение — по умолчанию 1 год или удаление после загрузки

Полное раскрытие информации на taxformatter.com/security.

📚 Документация

• ARCHITECTURE.md — Полный дизайн системы

• content/docs/api/index.md — Справочник API

• packages/mcp-server/README.md — Руководство по настройке MCP

• RELIABILITY.md — SLO, планы действий при инцидентах

• docs/ — Руководства по Stripe, Sentry и развертыванию

Лицензия

Частная — Quantum Transfer Group. Все права защищены.