📊 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 洞察

每个解析后的文件都会附带可操作的分析——根据您的计划进行扩展。

层级	模型	输出
免费	Gemini 1.5 Flash	快速统计 + 基础标记
专业	Claude Sonnet 4	平衡分析，详细拆解
高级	Claude Opus 4	深度分析 + 税务建议

🖥️ 用户仪表板

不是开发者？taxformatter.com 上的 Web 应用提供完整的拖放体验，具有实时任务状态、交易所自动检测、转换预览和一键下载功能。

🏗️ 技术栈

层级	技术
前端	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

⚡ 快速开始

运行 Web 应用

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

💳 定价

消费者（仪表板）

层级	价格	亮点
免费	$0	每月 3 次下载 · Gemini 洞察
专业	$89/年	无限制 · Claude Sonnet 洞察
高级	$189/年	全部功能 + Claude Opus + 优先支持

开发者（API）

层级	价格	配额	RPM
入门	$29/月	100 个文件	30
成长	$99/月	500 个文件	60
商业	$249/月	2,000 个文件	120

🔒 安全亮点

无状态 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 和部署指南

taxformatter-mcp-server