取込¶

関連: Tasker / Cloudflare / アーキテクチャ / 使い方

このセクション:

リアルタイム層（主）¶

1. Android 通知転送（+ 位置） PayPay 利用速報などを Tasker + AutoNotification で検知する。 通知直後に Tasker が端末 GPS を取得して JSON に載せる。 Cloudflare Tunnel 経由で ingest API に HTTP POST する。 （詳細: Tasker / Cloudflare） 位置は近似値である。 失敗時は null で送り、支出記録自体は落とさない。
2. 利用メール取込 楽天カード等の利用通知を IMAP で取得し、Gemini で分類、抽出する。 （詳細: メール取込 / Gemini）

正確性層（週次）¶

• PayPay 公式 CSV（取引履歴ダウンロード）
• 楽天カード e-NAVI CSV
• Discord の #imports 添付、または Proxmox の inbox/csv/ 配置

手動と保険（Discord）¶

詳細は Discord。

• テキスト手打ち（現金、抜け、訂正）
• 画像、スクショ、レシート添付 → Gemini Vision でよしなに抽出
• 週次 CSV も Discord 添付可

レシート撮影は「毎回の本線」にはしない。 Discord に投げられるなら、保険、または手動として採用する。

カテゴリについて¶

PayPay 通知や多くのスクショからは、商品内訳は基本取れない。 取れるのは金額、店名、日時が中心である。 レシートで明細がはっきり読めるときだけ 内訳（line_items）を保存する。 食費 / 消耗品などは Gemini の推定、またはユーザーが Discord で一言指定、訂正する。 時間帯と店種からは「夕食」「遊び」などの場面（occasion）も推定する。 大分類（category）と 小分類（subcategories: コンビニ / コーヒー など）を自動付与する。

やらないこと（MVP）¶

• 銀行、PayPay、楽天の公式個人向け明細 API 直結
• 常時スクレイピング前提の完全自動取得
• LINE 通知（Notify 終了済み。Messaging API 無料枠が月200通で厳しい）

メール取込（概要）¶

詳細は メール取込。

1. IMAP で取得し raw を保存
2. Gemini で速報/明細/無視を分類し金額などを抽出（Gemini）
3. プログラムで金額検証、重複排除してから支出イベント化

週次 CSV¶

PayPay¶

アプリ → 取引履歴 → ダウンロード申請 → CSV 取得

楽天カード¶

e-NAVI → ご利用明細 → CSV ダウンロード

チャージ通知と支払い通知は両方送ってよい。 サーバ側で「支出に含めるのは支払いのみ」と判定する（アーキテクチャ）。