add-savings-bank-account-parser

name: add-savings-bank-account-parser description: Guide for adding a new bank parser to extract savings account rates. Use when implementing parsers for Lulo Bank, RappiPay, Pibank, Nu Colombia, or any new Colombian bank.

Add Savings Account Parser

This skill guides you through adding a new bank parser to extract savings account rates from HTML pages or PDF documents.

When to Use

• Implementing a new bank's savings account rate parser
• The bank has publicly disclosed savings rates (HTML page or PDF)
• The bank is listed in BankId enum or needs to be added

Quick Steps

1. Download fixture to fixtures/{bank_id}/savings-page.html (or .pdf)
2. Analyze source structure - HTML: inspect tables/divs; PDF: extract text first
3. Implement parser in packages/updater/src/parsers/savings/{bank_id}.ts
4. Register parser in packages/updater/src/parsers/savings/index.ts
5. Write tests in packages/updater/src/parsers/savings/{bank_id}.test.ts
6. Update PROGRESS-SAVINGS.md

Key Files

• Parser interface: packages/updater/src/parsers/savings/types.ts
• HTML example: packages/updater/src/parsers/savings/ban100.ts
• PDF example: packages/updater/src/parsers/savings/bbva.ts
• Core types: packages/core/src/types.ts (SavingsOffer, SavingsRate)
• Utilities: packages/updater/src/utils/index.ts

Commands

# Run tests for a specific parser
pnpm --filter @compara-tasa/updater test -- --run savings/{bank_id}

# Run all savings tests
pnpm --filter @compara-tasa/updater test -- --run savings

# Type check
pnpm typecheck

# Run the savings updater
pnpm --filter @compara-tasa/updater build && pnpm update-savings

Detailed Instructions

Read content.md in this skill folder for:

• Fixture download commands (HTML and PDF)
• Complete parser templates (HTML with cheerio, PDF with pdfjs-dist)
• PDF text debugging techniques
• Test template
• Account type examples
• Utility function reference
• Common issues and solutions