AgentSkillsCN

add-mortgage-rate-parser

新增银行解析器以提取房贷利率的指南。在为BBVA、Caja Social、AV Villas、Itaú或任何新的哥伦比亚银行实现解析器时，请参考本指南。

SKILL.md
--- frontmatter
name: add-mortgage-rate-parser
description: Guide for adding a new bank parser to extract mortgage rates. Use when implementing parsers for BBVA, Caja Social, AV Villas, Itaú, or any new Colombian bank.

Add Mortgage Rate Parser

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

When to Use

  • •Implementing a new bank's rate parser
  • •The bank has a public rate disclosure (HTML or PDF)
  • •The bank is listed in BankId enum or needs to be added

Quick Steps

  1. •Download fixture to fixtures/{bank_id}/
  2. •Analyze structure - extract text from PDF or inspect HTML
  3. •Implement parser in packages/updater/src/parsers/{bank_id}.ts
  4. •Register parser in packages/updater/src/parsers/index.ts
  5. •Write tests in packages/updater/src/parsers/{bank_id}.test.ts
  6. •Update PROGRESS.md

Key Files

  • •Parser interface: packages/updater/src/parsers/types.ts
  • •HTML example: packages/updater/src/parsers/bancolombia.ts
  • •PDF example: packages/updater/src/parsers/scotiabank.ts
  • •CloudFront WAF example: packages/updater/src/parsers/banco-de-occidente.ts
  • •Utilities: packages/updater/src/utils/numbers.ts

Commands

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

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

# Type check
pnpm typecheck

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

Detailed Instructions

Read content.md in this skill folder for:

  • •Fixture download commands
  • •PDF text extraction script
  • •Complete parser template
  • •Test template
  • •Rate type examples
  • •Utility function reference
  • •Common issues and solutions
  • •CloudFront WAF bypass using Playwright + stealth plugin