← 返回 Skills 市场
Receipt Snap
作者
MarinhoBot
· GitHub ↗
· v1.0.6
· MIT-0
154
总下载
0
收藏
0
当前安装
7
版本数
在 OpenClaw 中安装
/install receipt-snap-spain
功能描述
Process receipt photos and PDFs, extract vendor date amount currency, convert to EUR, upload to Google Drive with proper naming Vendor_Date_EURAmount.pdf, an...
安全使用建议
This skill appears to do what it says: it calls the gog CLI to upload files to Google Drive and append rows to Google Sheets, and it fetches exchange rates from open.er-api.com. Before installing, confirm: 1) you trust the Homebrew formula (faradayhq/gog/gog) and run 'gog auth login' yourself so OAuth tokens stay under your control; 2) set RECEIPT_DRIVE_FOLDER_ID and RECEIPT_GOOGLE_SHEET_ID (and optionally RECEIPT_LOG_FILE) — the top-level registry metadata omitted these even though the skill requires them; 3) review and secure the local log file path (it contains financial data) and add it to .gitignore if storing in a repo; 4) if you want additional assurance, inspect receipt_snap.py locally (it uses subprocess to call gog and urllib to fetch exchange rates) before use. If any of these steps or the brew formula look unfamiliar, investigate the gog package source and verify the Drive/Sheet IDs before using the skill with real receipts.
功能分析
Type: OpenClaw Skill
Name: receipt-snap-spain
Version: 1.0.6
The receipt-snap skill bundle is a legitimate tool for automating expense tracking. It extracts data from receipts, performs currency conversion via a public API (open.er-api.com), and uses the 'gog' CLI to upload files to Google Drive and log entries to Google Sheets. The Python script (receipt_snap.py) and instructions (SKILL.md) are transparent, follow the stated purpose, and do not contain evidence of malicious intent, data exfiltration, or unauthorized execution.
能力评估
Purpose & Capability
The skill's claimed purpose (receipt extraction, currency conversion, Drive upload, Sheets logging) aligns with the required binary (gog), the provided code, and the SKILL.md instructions. Minor inconsistency: the registry summary at the top lists no required environment variables, but SKILL.md and the script clearly require RECEIPT_DRIVE_FOLDER_ID and RECEIPT_GOOGLE_SHEET_ID (and optionally RECEIPT_LOG_FILE). This appears to be a packaging/metadata omission rather than malicious misdirection.
Instruction Scope
SKILL.md instructs only to install gog, authenticate it, set the Drive/Sheet IDs, fetch exchange rates from open.er-api.com, check the sheet for duplicates, upload files via gog, and append rows to Sheets. The runtime instructions and code do not request unrelated system files or external endpoints beyond the exchange-rate API and Google via gog.
Install Mechanism
Installation uses a Homebrew formula (faradayhq/gog/gog) to provide the gog CLI. This is a normal package installation method; no arbitrary URL downloads or extraction steps are present in the spec.
Credentials
Environment variables required by the script (Drive folder ID, Sheet ID, optional local log path) are appropriate and proportional to the functionality. Note the manifest/registry summary omitted these env vars—verify the skill will prompt you to set them (SKILL.md does). The skill relies on gog-managed OAuth tokens rather than asking for raw credentials, which is appropriate.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and does not demand elevated system privileges. It writes a local CSV log (configurable via RECEIPT_LOG_FILE) and uses gog to store items in the user's Google Drive/Sheets as expected.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install receipt-snap-spain - 安装完成后，直接呼叫该 Skill 的名称或使用
/receipt-snap-spain触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.6
Fix CSV quoting to use csv.writer, fix makedirs for flat log paths, remove bogus ext==file condition
v1.0.5
- Added detailed setup and workflow instructions for processing and logging Spanish tax receipts.
- Updated model usage, with escalation to MiniMax for ambiguous receipts.
- Clarified supported inputs: PDF invoices, photo screenshots, and text descriptions.
- Improved duplicate detection workflow before processing a receipt.
- Expanded documentation of Spanish tax expense categories and quarterly reporting.
- Provided explicit commands and security recommendations for usage.
v1.0.4
- Added detailed setup and usage guide in SKILL.md, including environment variables, required tools, and Google Drive/Sheet configuration.
- Described the workflow from receipt capture through extraction, duplicate checking, currency conversion, categorization, Drive upload, and logging.
- Outlined supported receipt input types: PDFs, photo screenshots, and text.
- Provided Spanish expense categories for proper classification.
- Included command-line examples for processing receipts, exporting summaries, and fetching exchange rates.
- Clarified security practices for protecting sensitive data.
v1.0.3
- Improved documentation and usage guide in SKILL.md
- Added step-by-step setup instructions for Google Drive and Google Sheets integration
- Clarified model usage strategy for cost optimization
- Detailed security best practices and .env handling
- Expanded guidance on receipt categories for Spanish tax compliance
- Outlined quarterly reporting workflow and command-line usage
v1.0.2
- Improved documentation: SKILL.md expanded with detailed setup, workflow, and security instructions.
- Clear prerequisites and step-by-step workflow for processing receipts, including duplicate checks and Spanish tax categories.
- Guidance for integrating with Google Drive and Sheets via the `gog` CLI.
- Instructions for handling different receipt formats, currency conversion, and quarterly tax summary workflow.
- Security best practices highlighted for sensitive data management.
v1.0.1
- Improved skill description and documentation for clarity and practical setup.
- Outlined step-by-step workflow for receipt processing, including duplicate checks and quarterly reporting.
- Listed Spanish expense categories with detailed explanations for accurate classification.
- Added explicit instructions for currency conversion, Drive upload, and Google Sheets logging.
- Included sample bash commands and Google Sheet column structure for easy configuration.
- Enhanced security guidance for sensitive data handling and environment setup.
v1.0.0
Initial release of receipt-snap for Spain:
- Processes receipt photos and PDFs, extracting key details (vendor, date, amount, currency).
- Converts non-EUR amounts to EUR using live exchange rates.
- Uploads receipts to Google Drive, naming them in standard format.
- Logs each receipt to Google Sheets with Spanish tax categories.
- Checks for duplicates before processing.
- Supports quarterly summary/report generation for tax purposes.
元数据
常见问题
Receipt Snap 是什么？
Process receipt photos and PDFs, extract vendor date amount currency, convert to EUR, upload to Google Drive with proper naming Vendor_Date_EURAmount.pdf, an... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 154 次。
如何安装 Receipt Snap？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install receipt-snap-spain」即可一键安装，无需额外配置。
Receipt Snap 是免费的吗？
是的，Receipt Snap 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Receipt Snap 支持哪些平台？
Receipt Snap 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（darwin, linux）。
谁开发了 Receipt Snap？
由 MarinhoBot（@marinhobot）开发并维护，当前版本 v1.0.6。
推荐 Skills