Ride Receipts

使用 gog 抓取 Gmail 乘车收据,构建本地 SQLite 乘车历史库,借助 OpenClaw Gateway /v1/responses 提取,适用于…

安装

概览

Ride Receipts 是一个专为处理乘车收据邮件而设计的自动化管道工具,旨在帮助用户从 Gmail 收件箱中抓取各类网约车平台的电子收据,并将其转化为结构化的本地数据资产。该工具通过调用 OpenClaw Gateway 的 `/v1/responses` 接口对原始邮件内容进行智能解析,最终生成可用于查询和分析的 SQLite 数据库。整个流程高度模块化,包含初始化数据库、批量获取邮件、结构化提取行程信息、入库存储以及生成摘要报告等多个阶段,每一步都具备容错机制和进度断点续传能力。由于涉及个人出行与消费数据,系统特别强调隐私保护,默认仅允许向本地或私有网关发送敏感信息,并明确提示用户相关风险。 该工具目前支持包括 Uber、Lyft、Bolt、Yandex、Free Now、Curb 和 Via 在内的主流网约车平台收据识别。用户可通过指定时间范围(如‘全部’、‘某日期之后’或‘两个日期之间’)灵活控制抓取范围,同时可限制每个供应商的最大邮件数量以避免资源过度消耗。所有原始邮件内容将临时保存为 `emails.json` 文件,而经过 LLM 提取后的标准化行程记录则以 `rides.json` 形式输出,并进一步导入到 SQLite 数据库中供后续分析使用。此外,工具还提供匿名化 CSV 导出功能,便于用户在分享或归档时剥离个人身份信息。 整体来看,Ride Receipts 不仅解决了手动整理分散收据的低效问题,还借助大语言模型实现了从非结构化文本中精准抽取关键字段(如出发地、目的地、金额、时间等),极大提升了个人财务追踪与出行行为分析的便利性。其设计兼顾了易用性与安全性,适合希望系统化管理网约车支出的普通用户及开发者使用。

核心功能特点

  1. 自动抓取 Gmail 中的网约车收据邮件并整合为统一 JSON 文件
  2. 利用 OpenClaw Gateway 的 /v1/responses 接口实现高精度结构化信息提取
  3. 支持多平台收据识别:Uber、Lyft、Bolt、Yandex、Free Now、Curb、Via
  4. 将提取结果存入 SQLite 数据库,支持 SQL 查询与统计分析
  5. 提供匿名化 CSV 导出功能,符合数据共享与合规要求
  6. 内置进度检查点机制,支持中断后继续执行

适用场景

Ride Receipts 最适用于需要长期追踪个人或家庭网约车消费情况的场景。例如,经常使用 Uber 或 Lyft 通勤的用户可以通过此工具汇总过去一年内的所有出行记录,快速了解月度支出趋势、高频上下车地点以及高峰时段分布,从而优化出行预算或选择更经济的替代方案。对于自由职业者或远程工作者而言,该工具还能帮助识别工作日的固定路线模式,辅助判断是否接近‘家—办公室’通勤结构,进而评估生活成本合理性。 另一个典型应用场景是财务审计或报销管理。企业员工若需定期提交网约车费用凭证,可利用 Ride Receipts 批量提取并格式化所需字段,减少手工录入错误。结合生成的匿名 CSV 报告,还可用于跨部门费用对比或年度税务申报准备。此外,研究人员或产品经理也可借此工具收集样本数据,用于分析特定城市居民出行习惯或不同平台服务覆盖情况,前提是在确保隐私的前提下进行脱敏处理。 值得一提的是,该工具特别适合那些依赖 Gmail 接收电子收据且不愿手动下载附件的用户。无论是日常打车、商务差旅还是偶尔的跨城出行,只要收据以标准格式发送至邮箱,系统即可自动识别并完成全流程处理。对于希望构建个人出行仪表盘或集成到其他数据分析平台(如 Google Sheets、Tableau)的用户来说,SQLite 输出的结构化数据也提供了极大的灵活性。