receipt-tracker-setup

Watch a folder for receipt images and PDFs, extract details via Zo API, and store them in SQLite.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ankitjh4/skill-builder --skill receipt-tracker-setup-ankitjh4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: receipt-tracker-setup
Source: https://github.com/ankitjh4/skill-builder/tree/main/receipt-tracker-setup
Command: npx skills add https://github.com/ankitjh4/skill-builder --skill receipt-tracker-setup-ankitjh4

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aiohttp, watchfiles.

What problem does it solve?

This Skill eliminates the manual work of organizing receipts, extracting merchant and line-item details, and keeping an auditable record of purchases.

Core Features & Use Cases

  • Automatic receipt scanning: Watches an input folder for new receipt/invoice files (images or PDFs) and processes them as they arrive.
  • AI-powered extraction to structured data: Uses the Zo API to parse receipts into merchant details and line items, then writes them into a SQLite database.
  • Persistent background service with archiving: Runs as a managed user service with auto-restart and moves successfully processed files to a processed/archive folder.

Example Use Case: Drop restaurant or retail receipts into the input folder, then query the SQLite database to see recent merchants, line-item descriptions, and totals by currency.

Quick Start

Ask Zo to set up the receipt tracker service so it watches /home/workspace/receipt-processor/input/, creates /home/workspace/receipt-processor/invoices.db, and processes new images or PDFs automatically.

Frequently Asked Questions about receipt-tracker-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically extract data from receipt PDFs and images into a database?

You can automatically extract receipt data by setting up a folder watcher that monitors an input directory for new receipt images or PDFs. The system uses AI extraction to parse merchant details and line items, then stores them in a searchable SQLite database for continuous expense tracking.

Can I use SQLite for expense tracking with automated receipt scanning?

SQLite is used for expense tracking by storing extracted receipt details like merchant information, line-item descriptions, and minor-unit amounts. You can query the database directly to see recent merchants and totals by currency after the AI extraction processes new files.

Do I need Python to set up an automated receipt and invoice parser?

Python is required to run the receipt and invoice parser, as it implements folder watching and file archiving using Python-based dependencies. The setup runs as a managed background service with auto-restart capabilities to continuously process new files.

What's the best way to archive processed receipt files automatically?

The best way to archive processed receipt files is using a managed service that moves successfully parsed files from the input folder to a designated archive folder. This ensures original receipt images and PDFs are kept for auditability while the extracted data goes to the database.

Does automated receipt extraction work with both images and PDFs?

Automated receipt extraction works with both image files and PDFs dropped into the watched input folder. The AI extraction API parses both formats to extract merchant and line-item details before moving the originals to the archive folder.

Why does my automated receipt tracker service stop processing new files?

If the receipt tracker service stops processing new files, the managed service execution includes auto-restart and log outputs to help diagnose issues. Check the logs for errors related to AI extraction or file archiving to identify the root cause.