israeli-bank-scrapers-to-actual-budget
Automatically import transactions from 19 Israeli banks and credit cards into Actual Budget using Node.js + TypeScript.
Ficha actualizada 23 sept 2026, 17:09 · upstream 23 sept 2026, 17:05 · release v1.42.25
Qué es israeli-bank-scrapers-to-actual-budget
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
This project provides an automated solution for importing financial transactions from major Israeli banking institutions (Hapoalim, Leumi, Discount Bank, Mizrahi Tefahot, Mercantile, Otsar Hahayal, Beinleumi, Massad, Yahav, Beyahad Bishvilha, Behatsdaa, Pagi, One Zero, Visa Cal, Max, Isracard, Amex) and credit cards into the Actual Budget application. The system uses a Node.js/TypeScript backend with Docker containerization for deployment. It supports Telegram bot integration for notifications, OCR-based receipt scanning, webhook delivery to Slack/Discord, auto-categorization of Hebrew transactions, spending watchlists with threshold alerts, encrypted configuration storage (AES-256-GCM + PBKDF2), optional web config portal and mobile app support, scheduled cron jobs, Camoufox stealth browser for Firefox users, and read-only containerized deployment. The project is forked from eshaham/israeli-bank-scrapers with additional fixes for Amex/Isracard WAF protection and Camoufox stealth capabilities.
- Automatically import all transactions from a user's Israeli bank accounts into Actual Budget without manual entry
- Set up recurring payments (e.g., rent, utilities) by configuring bank account numbers and target accounts in advance
- Monitor spending habits with configurable watchlists that alert when thresholds are exceeded
- Receive real-time transaction notifications via Telegram bot for quick review of new activity
- Import credit card transactions from Visa Cal, Max, Isracard, or Amex cards directly into the budget
- Automatically reconcile bank statements by importing all matching transactions at once
- Supports exactly 19 Israeli banks and major credit cards with full configuration per institution
- Uses Camoufox stealth browser for Firefox users, preventing fingerprint detection on public networks
- Provides AES-256-GCM encrypted config storage with PBKDF2 key derivation for secure credential management
- Supports OCR-based receipt scanning via Telegram bot to automatically import scanned bank statements
- Offers a web config portal and mobile app allowing configuration without manual editing of config.json
- Includes scheduled cron jobs, webhook notifications (Slack/Discord), and optional Tailscale/VPN access for remote deployments
- Only supports Israeli banks; foreign bank accounts are not supported
- Credit card refunds may create duplicate rows if the refunded amount matches a prior purchase
- Telegram bot requires an active Telegram account and cannot be used without internet connectivity
- Mobile app OTP delivery is limited to Tailscale/VPN networks only, not public Wi-Fi
- The scraper version 8.7.1 may have compatibility issues with newer bank APIs or updated card formats
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Deploy using Docker Compose: pull the image and run `docker compose up -d`. For production, use a managed registry (GHCR preferred) to avoid pulling images into your local machine. Set environment variables for actual budget credentials, database connection strings, and webhook endpoints. Enable TLS with Let's Encrypt certificates on the web portal. Use Docker secrets or Kubernetes Secrets for sensitive config values. Schedule jobs via cron or Kubernetes CronJobs. For multi-tenant setups, use namespace isolation and role-based access control.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.