📊 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 — 라이브니스 프로브(Liveness probe).
인증: 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	빠른 통계 + 기본 플래깅
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 (스캐너, 프로세서, 웹훅, 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

💳 요금제

소비자용 (대시보드)

티어	가격	주요 혜택
무료	$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

🔒 보안 강조 사항

상태 비저장(Stateless) 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 및 배포 가이드

라이선스

비공개 — Quantum Transfer Group. 모든 권리 보유.

taxformatter-mcp-server