交通系ICカードの利用履歴をCSVで保存できる「Suica Viewer」

Suica Viewer
Suica など FeliCa の交通系 IC カードを読み、残高や利用履歴を表示・保存するツール
GitHub
公開
正式公開 2025-10-26
作り手
soltia48(個人)
対応
Windows・Mac・Linux
言語
日本語
価格
無料(MIT ライセンス)
評価
GitHub のスター 378(2026-10-14)

どんなアプリか

Suica Viewer is a tool for retrieving, displaying, and saving detailed information from FeliCa-based transit IC cards.

soltia48 さん、GitHub の README

Suica など FeliCa を使う交通系 IC カードから、残高や利用履歴などの詳しい情報を読み出して表示・保存するツールです。暗号化された領域はリモートの認証サーバーを使って読みます。デスクトップアプリとコンソール向けの CLI の2つが用意されています。

デスクトップアプリには概要・カード情報・利用履歴・改札・データのタブがあり、履歴の絞り込みや JSON/CSV への書き出しができます。カードは自動で検出され、画面は再読み込みなしで更新されます。画面は日本語です。

CLI は発行情報、残高、履歴、定期券の内容などを整形したテキストで出力し、–json を付けると表の代わりに JSON を出します。会社名・路線名・駅名は実行ファイルに組み込まれた駅コードの表から引きます。

–demo を付けて起動すると、リーダーが無くても内蔵のサンプルカードで画面を確かめられます。

料金とデータの置き場所

MIT ライセンスで公開されています。各リリースにデスクトップアプリと CLI が含まれ、Releases のページから使う環境に合ったファイルを入手します。

認証サーバーが関わるのは相互認証の部分のみで、その間に IDm・PMm とカードの認証応答はサーバーに届きます。認証後の読み取りはこのツールとカードの間で直接行われ、README によると残高や履歴、氏名などのカードの中身はサーバーに届きません。

デスクトップアプリは HTTP サーバーを立てず、カードのデータをネットワークに公開しません。

入れる前に

対応する FeliCa リーダー/ライターが必要です。README の対応表には Sony の RC-S380、RC-S300、RC-S320、RC-S330/RC-S360/RC-S370 が載っています。認証サーバーとの通信のためにインターネット接続も要ります。

Windows では Zadig でリーダーのドライバーを WinUSB に置き換える必要があり、置き換えた後は元のドライバーに戻すまで Sony の NFC Port Software などからリーダーを使えません。Linux では udev のルールを追加するか root で動かします。macOS は追加の設定は不要ですが、ビルドに署名が無いため初回は「プライバシーとセキュリティ」で許可します。

既定の認証サーバーは https://felica-auth.nyaa.ws で、環境変数 AUTH_SERVER_URL か –server で切り替えられます。カードの識別子は送られるため、README は接続先を信頼できるサーバーにするよう書いています。

読み取りには各サービスの読み出し専用のコードで認証するため、受け取るセッション鍵ではカードを書き換えられません。