Bulk Receipt Categorizer from Email

WHAT IT DOES

Bulk Receipt Categorizer from Email is a personal finance and expense tracking tool that streamlines the process of extracting and categorizing receipt data from emails and web pages. Instead of manually copying merchant names, amounts, dates, and order numbers from receipt emails into a spreadsheet—a process that can be tedious and error-prone—this script automates the entire workflow. It scans the current page for receipt-like text (merchant names, amounts, dates, order numbers), aggregates them into a structured list, and presents them as a scrollable checklist. You can select individual receipts, use Select All/Deselect All toggles, assign a category to selected receipts with one click, choose an export format (plain text, CSV, or TSV), and export the categorized receipts to your clipboard. This is ideal for personal finance enthusiasts, budgeters, expense trackers, and anyone who needs to categorize receipt data for budgeting, tax preparation, or expense reimbursement.

WHERE IT RUNS

This script is universal—it runs on any website (*://*/*) as a userscript injected through the BotGentz extension. It operates within the context of your current browser tab and cannot access other tabs, bookmarks, history, or downloads. The script reads the page DOM to identify receipt-like text using regex patterns for merchant names, currency amounts, dates, and order numbers, and structures the data for categorization and export. All operations occur locally in your browser; no data is sent to external servers. The script outputs the categorized receipt data to your clipboard.

HOW TO USE

1. Navigate to any page containing receipt data—an email inbox, a receipt confirmation page, a PDF converted to HTML, or any text with merchant names and amounts.

2. Click the BotGentz extension icon and select "Bulk Receipt Categorizer from Email" from the script list.

3. The panel opens on the right side of the page. It automatically scans the current page for receipt-like text.

4. Review the detected receipts, showing merchant, date, amount, order number, and current category.

5. Enter a category name in the "Default category" field (e.g., "Groceries," "Office Supplies," "Travel").

6. Check the boxes next to receipts you wish to categorize. Use "Select All" or "Deselect All" for quick selection.

7. Click "Apply Category" to assign the category to all selected receipts.

8. Select your export format: Plain Text, CSV, or TSV.

9. Click "Export Selected" to copy the categorized receipts to your clipboard.

10. Paste the exported data into a spreadsheet, budgeting app, or expense tracking tool.

WHY IT WORKS WHERE OTHERS FAIL

Many receipt tracking tools require email integrations, OCR, or manual data entry. This script takes a different approach: it works directly on any page containing receipt information, using regex-based pattern recognition to extract merchant names, amounts, dates, and order numbers from visible text. It uses multiple detection strategies—looking for order confirmation language, merchant names, currency symbols, and date patterns—to identify receipts even when they're not in a standard format. The script intelligently extracts order numbers when present, and preserves the original raw text for verification. By supporting bulk categorization with a single click and multiple export formats, it transforms messy receipt data into organized, categorized records ready for budgeting and expense tracking.

THE PANEL

The script uses BotGentz's BGPanel system, which provides a floating, draggable panel on the right side of your screen. Drag the panel by its header to reposition it anywhere on the page—the panel remembers its position per site and snaps to the nearest edge when released. Click the minimize button to collapse the panel to a small floating bubble; click the bubble to expand it back. Resize the panel vertically by dragging its bottom edge. Press the Escape key to close the panel entirely. All panel state (position, collapsed/expanded) is persisted locally using GM_setValue, so your preferences survive page reloads.

PLEASE NOTE

This userscript requires the free BotGentz browser extension—it is not a standalone application. The script extracts receipt data using text pattern recognition, which may not be perfect on all pages—some receipts may be missed or misidentified. Always verify the extracted data before relying on it for financial decisions. This script does not store, transmit, or process any of your data outside your local browser. It does not access your password, hidden inputs, or file inputs. All data extraction and categorization is performed locally in your browser. Use responsibly and verify extracted receipts against your actual emails or statements.