レシート保存エージェント
public.icon
プロジェクト概要
レシートを撮影→AIで読み取り→経費データとして自動記録するLINE Bot
確定申告の経費入力を効率化するのが目的
背景
2025年度の確定申告で619件の経費を手動整理した
クレカCSV+銀行明細+PayPay+レシートの突き合わせが大変だった
レシートだけでもリアルタイムで記録できれば年末に楽になる
アーキテクチャ
LINE → GAS(Webhook) → Gemini 2.5 Flash(OCR) → Google Sheets + Drive
clasp でローカル開発、GitHub Actions で自動デプロイ
Container-bound script（スプレッドシート + GAS 一体型）
サーバー不要・完全無料運用
フロー
1. LINEでレシート写真を送る（1枚ずつ）
2. ローディングアニメーション表示
3. Gemini 2.5 Flashが日付・金額・店名・カテゴリを抽出
4. Flex Messageで確認画面（OK / やり直し / インライン修正）
5. OKを押すとGoogle Sheetsに1行追加 + 画像をDriveに保存
6. 重複データがある場合は警告表示
7. 年末にClaude Codeでfreeeインポート用CSVに変換
主な機能
Flex Message確認画面（カード型UI）
インライン修正（「金額 1500」「店名 スタバ」のように送信）
重複検出（同日・同額・同店名で警告、店名に(2)付与）
年ごとシート分割（レシート_2025、レシート_2026）
Drive画像保存（レシート経費記録/画像/YYYY/MM/）
logsシート（イベント・エラーログ）
ローディングアニメーション（処理中表示）
友達登録時ウェルカムメッセージ
クイックリプライ（登録確認 / 友達に共有）
登録確認（直近7週間の履歴をFlex Messageで表示）
CI/CD（GitHub Actions: mainにpushで自動デプロイ）
Google Sheetsフォーマット
| 日付 | 金額 | 店名 | 勘定科目 | 備考 | 登録日時 | 画像 |
Google Driveフォルダ構成
レシート経費記録/
├── レシート経費記録（スプレッドシート）
└── 画像/
└── 2026/
├── 03/
├── 04/
└── ...
勘定科目の自動分類
交際費: 飲食店、食料品
消耗品費: 日用品、電子機器、文房具
会議費: カフェでの打ち合わせ
新聞図書費: 書籍、雑誌
旅費交通費: タクシー、駐車場、ガソリン
雑費: その他
技術スタック
Google Apps Script (TypeScript)
clasp (ローカル開発)
GitHub Actions (CI/CD)
LINE Messaging API (Flex Message / Quick Reply)
Gemini 2.5 Flash API（無料枠）
Google Sheets + Google Drive
セットアップ
code:sh
cd receipt-line-bot
bash setup.sh
setup.shで: プロジェクト作成 → push → APIキー設定待ち → デプロイ → Webhook URL自動設定
必要なAPIキー（Script Properties）
LINE_CHANNEL_ACCESS_TOKEN
LINE_CHANNEL_SECRET
GEMINI_API_KEY
LINE_BOT_ID（例: @927vhqkf）
更新方法
code:sh
bash update.sh # or git push → CI自動デプロイ
開発履歴
関連