ローカル家計簿アプリ作りました
銀行、クレジットカード、証券、DC の口座をまとめて管理する、自分用のローカル家計簿アプリを作りました。household-money で公開しています。
各機関のサイトから落とした CSV / PDF / HTML を取り込んで、資産推移、取引明細、ポートフォリオを見られるようにするものです。データは手元の SQLite ファイル 1 個に入ります。
作ったきっかけ
MoneyForward の不正アクセスの件をきっかけに、手元だけで動く家計簿アプリを作ることにしました。
対応している機関
いまのところ、次の機関に対応しています。
- 銀行: SBI 新生銀行、楽天銀行、三井住友信託銀行(PDF)、ゆうちょ銀行、りそな銀行。入出金明細の CSV か PDF を取り込みます。
- カード: 三井住友カード(Vpass)、楽天カード。利用明細の CSV を取り込みます。
- 証券: 楽天証券、楽天証券ジュニアNISA。取引履歴の CSV と、保有商品の CSV(時価評価額のスナップショット)を取り込みます。
- DC: SBI ベネフィットシステムズ。資産状況のページの HTML をスナップショットとして取り込みます。
- 手動入力: 現金の財布、電子マネー、ポイントのように CSV が出ない口座は、画面から日付と残高を直接入れます。
どう動くか
使う流れはこんなかんじです。
/accountsで各機関の口座を登録します。/importに CSV / PDF / HTML をドラッグ&ドロップします。どの機関のファイルかは自動で判定して、口座が 1 つならそれを選びます。- プレビューを見て、よければ「この内容で取り込む」を押します。
- ダッシュボード(
/)で資産推移のグラフ、月ごとの収支、カテゴリごとの集計を見ます。/portfolioでは銘柄を口座をまたいで集計して、構成比を出します。
取り込みは機関ごとにアダプタを書いて登録する作りです。アダプタはファイルの中身を見て「自分のファイルっぽいか」を数値で返すので、それで機関を判定しています。
文字コードは Shift_JIS / UTF-8 / JIS を自動で判定します。BOM があれば UTF-8、JIS の開始シーケンスがあれば JIS、どちらでもなければ Shift_JIS と UTF-8 の両方でデコードしてみて、化けた文字が少ないほうを採ります。
同じデータを 2 回取り込まないように、重複は 2 段階で弾いています。
- ファイルのハッシュ(
fileHash)で、同じファイルの取り込みを弾きます。 - 行のハッシュ(
rowHash)で、期間が重なったファイルの行を弾きます。日付、金額、相手先、残高などからハッシュを作ります。同じ日に同じ店で同じ金額の取引が複数あっても区別できるように、連番も入れています。
カテゴリ分けのルール
明細のカテゴリはルールで自動で振り分けます。ルールは相手先やメモへの部分一致か正規表現で書き、金額の範囲で絞ることもできます。ルールを直したあとは、既存の明細に全件まとめて再適用できます。
明細の画面でカテゴリを選ぶと、そのままルール化のダイアログが開きます。相手先の文字列からパターンの候補を作って並べるので、選ぶだけでルールになり、ほかの未分類の明細にもまとめて適用されます。
候補の作り方は次のとおりです。
- 完全一致
- 末尾の数字(店舗番号など)を取る
- 末尾の日付や「5月分」のような月の表現を取る(家賃やローン返済のように、月ごとに名前の変わる取引を 1 つのルールで拾うため)
- 「振込 」「カード 」のような決まったプレフィックスを取る
- 括弧の前まで
- 空白の前まで(後ろが「店」「決済」のような補足っぽいときだけ)
それぞれにスコアを付けて、上位 5 件を出しています。
技術スタック
- Next.js 16(App Router)+ React 19
- Prisma 7 + better-sqlite3
- Tailwind CSS v4
- recharts / papaparse / iconv-lite
セットアップは .env.example を .env にコピーして npm run setup を実行するだけです。依存のインストール、DB の作成とマイグレーション、機関とカテゴリの初期データの投入までをまとめてやります。何度実行しても大丈夫なので、更新を取り込むときも git pull のあとに同じコマンドを流せば済みます。
注意
このアプリには認証も暗号化も入っていません。DB は平文の SQLite ファイルで、画面を開ければ誰でも全部のデータを見たり書き換えたりできます。自分のマシンの中か、信頼できる自分だけの LAN の中で動かしてください。
あくまで個人用の実験的なもので、無保証です。集計した値が金融機関の記録と合うことは保証しないので、取り込んだあとは明細の画面で検算してください。税金の申告など、正確さが必要な用途には使わないでください。
