📊 TaxFormatter

暗号資産のCSVや銀行取引明細のPDFを、税務申告用データに変換します。

REST API · MCPサーバー · Node SDK · Python SDK · コンシューマー向けダッシュボード

API MCP Node SDK License

🚀 機能概要

TaxFormatterは、煩雑な金融取引データを、人間にとってもAIエージェントにとっても扱いやすい構造化された税務申告用データに変換します。

CoinbaseのCSV、KrakenのZIP、Binanceの.tar.gz、ChaseのPDF明細などをアップロードするだけで、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

🤖 AIエージェント用MCPサーバー

Claude、Cursor、WindsurfなどのMCP対応エージェントに、暗号資産や銀行データを直接解析する能力を与えます。

npx @taxformatter/mcp-server

ツール	機能
`parse_crypto_csv`	取引所を自動検出し、正規化された取引データを返します
`parse_bank_statement`	銀行取引明細PDFから取引を抽出します
`list_supported_sources`	対応しているすべてのソースと出力形式を照会します

📦 公式SDK

Node.js → @taxformatter/sdk — Promiseベース、完全な型定義付き
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 (Form 8949) · CoinLedger · ZenLedger

🧠 階層化されたAIインサイト

解析されたすべてのファイルには、プランに応じた実用的な分析結果が含まれます。

プラン	モデル	出力
Free	Gemini 1.5 Flash	クイック統計 + 基本的なフラグ付け
Pro	Claude Sonnet 4	バランスの取れた分析、内訳
Premium	Claude Opus 4	詳細な分析 + 税務上の提案

🖥️ コンシューマー向けダッシュボード

開発者ではない方でも、taxformatter.com のウェブアプリから、ドラッグ＆ドロップでジョブのリアルタイム状況確認、取引所の自動検出、変換プレビュー、ワンクリックダウンロードが可能です。

🏗️ 技術スタック

レイヤー	技術
フロントエンド	Next.js 16 · React 19 · TypeScript · Tailwind v4
認証	NextAuth (Google OAuth + メール/パスワード + 2FA)
データベース	Neon (サーバーレス PostgreSQL)
ストレージ	AWS S3 (署名付きURL)
キュー	AWS SQS + DLQ
コンピューティング	AWS Lambda × 4 (スキャナー、プロセッサー、Webhook、API)
エッジ	AWS API Gateway + WAF + CloudFront
決済	Stripe (コンシューマーおよび開発者向けプラン)
メール	AWS SES / Nodemailer
監視	Sentry + CloudWatch
IaC	Terraform

📁 リポジトリ構成

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"

Claude CodeでMCPサーバーを使用する

{
  "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

💳 料金

コンシューマー（ダッシュボード）

プラン	価格	特徴
Free	$0	月3回ダウンロード · Geminiによるインサイト
Pro	$89/年	無制限 · Claude Sonnetによるインサイト
Premium	$189/年	すべての機能 + Claude Opus + 優先サポート

開発者（API）

プラン	価格	クォータ	RPM
Starter	$29/月	100ファイル	30
Growth	$99/月	500ファイル	60
Business	$249/月	2,000ファイル	120

🔒 セキュリティのハイライト

ステートレスなAPI処理 — ファイル内容はLambdaのRAM内でのみ処理され、ディスクには書き込まれません
ペイロードのログ記録なし — 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、デプロイメントガイド

taxformatter-mcp-server