ChatGPT Daily Token Tracker

ChatGPT ウェブ利用シーン向けの毎日 Token 統計ツール。含まれるもの：

• MCP Server：ChatGPT 内で直接「今日の Token 使用量」を尋ねられます；

• Edge / Chrome ブラウザ拡張機能：chatgpt.com ページに表示されているユーザーメッセージとアシスタントの返信を自動的にキャプチャし、ローカルで Token を推定します；

• Windows での自動実行：ngrok の固定開発ドメインを使って長期的な MCP アドレスを提供し、タスクスケジューラで起動時に自動開始できます；

• ローカルデータ保存：統計データはローカルに保存され、完全なチャット本文は統計ファイルに書き込まれません；

• 重複排除メカニズム：ページのリフレッシュや重複スキャンによって同じメッセージが重複してカウントされることはありません。

[!IMPORTANT] ここで統計されるのはWeb ページで表示可能なテキストの Token 推定値であり、OpenAI / ChatGPT 公式アカウントレベルの Token 請求ではありません。非表示のシステムプロンプト、内部推論、不可視のコンテキストなどは、通常の Web 拡張機能や MCP からは取得できません。

機能

MCP ツール

ブラウザ自動統計

拡張機能をインストールすると、新しく生成された ChatGPT の表示可能なメッセージが自動的に次の場所に送信されます：

http://127.0.0.1:8787/api/track-message

ローカルサービスは o200k_base tokenizer を使って Token を推定し、Token 数、ロール、時刻、メッセージ重複排除 ID などの統計情報のみを保存します。

拡張機能は 「現在の会話をバックフィル」 機能も提供します。必要に応じて、現在読み込まれている会話を当日分に追加計上できます。同じメッセージは自動的に重複排除されます。

Related MCP server: mcpstat

環境要件

推奨環境：

• Windows 10 / 11

• Node.js 22+

• Microsoft Edge または Google Chrome

• 無料の ngrok アカウント（固定パブリック MCP アドレスの場合のみ必要）

• ChatGPT アカウントがカスタム MCP / App に対応していること

クイックスタート

1. 依存関係のインストール

npm install

2. ローカルサービスの起動

Windows ではダブルクリックできます：

启动Token统计插件.bat

あるいは次のコマンドでも実行できます：

npm start

デフォルトのアドレス：

• MCP：http://127.0.0.1:8787/mcp

• ヘルスチェック：http://127.0.0.1:8787/health

• ローカルダッシュボード：http://127.0.0.1:8787/dashboard

3. Edge / Chrome 自動統計拡張機能のインストール

Windows ではダブルクリックできます：

安装浏览器自动统计扩展.bat

または手動で操作します：

1. Edge では edge://extensions、Chrome では chrome://extensions を開きます；

2. 「開発者モード」をオンにします；

3. 「パッケージ化されていない拡張機能を読み込む」をクリックします；

4. リポジトリ内の browser-extension フォルダーを選択します；

5. chatgpt.com に戻ってページを更新します。

拡張機能のポップアップには、当日の入力、出力、合計 Token、記録数が表示されます。

固定 MCP アドレス + Windows 起動時自動起動

ChatGPT がローカル MCP に長期的に接続できるようにするには、パブリックな HTTPS アドレスが必要です。このプロジェクトは、ngrok の固定開発ドメインに基づく Windows 自動設定スクリプトを提供します。

ダブルクリック：

安装长期固定地址并开机自启.bat

スクリプトの処理内容：

1. Node.js と ngrok を確認します；

2. ブラウザで ngrok authtoken ページを開きます；

3. ローカル PowerShell で authtoken を入力するよう求めます；

4. アカウントに割り当てられた固定 ngrok 開発ドメインを取得します；

5. ローカルの config/ngrok.yml を生成します；

6. 実行可能な ngrok のコピーをローカルの bin/ に配置します；

7. Windows タスクスケジューラのタスク ChatGPT-Token-Tracker-Fixed を作成します；

8. Node MCP + ngrok を自動起動して監視します；

9. 最終的な固定 MCP URL を出力します。

既存の設定を修復する必要がある場合は、次のコマンドを実行します：

修复固定地址自启动.bat

ChatGPT で MCP を追加

ChatGPT のカスタム App / MCP ページで：

• Server URL：スクリプトが最後に出力した https://xxxxx.ngrok-free.dev/mcp を入力します；

• 認証：None / 認証なし を選択します；

• ツールをスキャンして保存します。

その後、チャットで today_usage を呼び出して照会できます。

データとプライバシー

以下は GitHub にはコミットされません：

• data/：ローカル Token 統計、ログ、実行時 URL；

• config/：ngrok authtoken と実行設定；

• bin/：ローカルの ngrok 実行可能ファイル；

• .env；

• node_modules/。

ブラウザ拡張機能は完全なチャット本文をプロジェクトのパブリック ngrok アドレスに送信しません。自動統計の書き込み API はローカルの 127.0.0.1 に限定されます。

[!WARNING] 現在の MCP 接続例は「認証なし」を採用しています。固定パブリック URL を積極的に公開共有すべきではありません。あらゆるパブリックサービスでは、ご自身のリスク要件に応じて認証、アクセス制御、監査を追加してください。

Token 統計の基準

• exact：OpenAI API が返した実際の usage 数値に由来；

• estimated：tokenizer を使って表示可能なテキストを推定；

• ブラウザ自動統計のレコードは chatgpt-browser-auto + estimated としてマークされます。

このプロジェクトは推定値を公式の課金データと偽ることはありません。

テスト

npm test

現在のテストは以下をカバーしています：

• 中国語・英語の Token 推定；

• 正確な値と推定値を分けて集計；

• Asia/Shanghai での日次分割；

• 同じ eventId の重複排除；

• ブラウザ自動記録の HTTP API 書き込みと重複排除。

プロジェクト構成

browser-extension/      Edge / Chrome Manifest V3 扩展
src/server.js           MCP + HTTP 服务
src/store.js            本地统计存储与去重
src/tokenizer.js        Token 估算
setup-fixed-ngrok.ps1   固定 ngrok 地址与开机任务安装
run-fixed-supervisor.ps1 Windows 后台守护
repair-fixed-autostart.ps1 固定地址/自启动修复
test/                   自动测试

開発とアップグレード

アップグレードのたびに以下を実行することをお勧めします：

npm install
npm test

src/server.js を変更した場合、Windows 固定デプロイユーザーは次のコマンドを実行できます：

修复固定地址自启动.bat

バックグラウンドの SYSTEM サービスに新しいコードを再読み込みさせます。

ライセンス

MIT License。詳細は LICENSE を参照してください。